|
この文書は自動機械翻訳技術を使用して翻訳されています。 正確な翻訳を提供するように努めておりますが、翻訳された内容の完全性、正確性、信頼性については一切保証いたしません。 相違がある場合は、元の英語版 英語 が優先され、正式なテキストとなります。 |
ダッシュボード変数
ダッシュボードの変数を設定することで、動的なウィジェットを持つダッシュボードを作成できます。変数を使用することで、異なるユースケースに対して単一のダッシュボード定義を再利用できます。
変数タイプ
リスト変数
リスト変数には「ソース」フィールドで定義された可能な値があります。各ソースタイプは、変数の可能な値を絞り込むための追加フィールドを提供します。
| ソースタイプ | ソースフィールド |
|---|---|
メトリックラベル名 |
メトリックラベル名が存在するかを絞り込むために、ゼロ以上のシリーズセレクターを入力してください。 |
メトリックラベル値 |
メトリックラベル名を入力し、ゼロ以上のシリーズセレクターを入力して、どのメトリックラベル値が存在するかを絞り込んでください。 |
メトリック PromQL |
カスタムPromQLクエリとラベル名を入力してください。結果として得られる可能な値は、指定されたラベル名の値です。 |
スタティックリスト |
静的な可能な値のリストを構築するために、1つ以上のラベルと値のペアを入力してください。 |
ソースタイプと関連するフィールドを変更すると、引き出しの右側にあるプレビューが新しい可能な値で更新されます。
変数を使用する
変数が定義されると、ダッシュボードのさまざまなフィールドに値を入力するために使用できます：
-
その他の変数
-
ウィジェットの名前と説明
-
ウィジェットリンクフィールド:URL、名前、およびツールチップ
-
ウィジェットクエリフィールド:PromQL式、エイリアス、および最小ステップ
-
Markdownウィジェットのエディタ
互換性のあるフィールドで変数を使用するには、変数名を`${}`で囲んで使用します（例：${my_variable}）。変数の値は補間されます。
変数がどのように補間されるか
テキスト変数は、変数のテキストボックスに書かれた文字列として補間されます。
同様に、複数の値や「すべてを含める」を許可しないリスト変数は、リストから選択された項目の値として補間されます。
複数の値を許可するリスト変数は、選択された値の正規表現キャプチャグループとして補間されます（例：(value_1|value_2)）、選択されたオプションが1つであっても複数であっても関係ありません。
「すべてを含める」オプションが有効で、その変数に選択されているリスト変数は、次のように補間されます：
* 定義されている場合はカスタム値、または
* すべての可能な値の正規表現キャプチャグループ（例：(value_1|value_2|value_3)）
正規表現キャプチャグループとして補間される変数を使用する際に、PromQL正規表現マッチャー`=~`を使用できます。