翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

可変タイプ

Grafana はいくつかのタイプの変数を使用します。

クエリ変数の追加

クエリ変数を使用すると、メトリクス名、タグ値、またはキーのリストを返すデータソースクエリを作成できます。例えば、クエリ変数は、サーバー名、センサー IDs、またはデータセンターのリストを返す場合があります。変数値は、データソースクエリでオプションを動的にフェッチすると変化します。

クエリ式には、他の変数への参照を含めることができ、実際にはリンクされた変数を作成できます。Grafana はこれを検出し、リンクされた変数のいずれかが変更されると変数を自動的に更新します。

クエリ式

クエリ式はデータソースごとに異なります。詳細については、「」のデータソースのドキュメントを参照してくださいデータソースに接続する。

一般的なオプションの入力

クエリオプションの入力

カスタム変数の追加

変更されない値にはカスタム変数を使用します。これは、数値、文字列、またはその他の変数である場合があります。

例えば、変更されないサーバー名やリージョン名がある場合は、クエリ変数ではなくカスタム変数として作成できます。これらは変更されないため、他のクエリ変数ではなく連鎖変数で使用できます。これにより、連鎖変数が更新されたときに Grafana が送信する必要があるクエリの数が減少します。連鎖変数の詳細については、「」を参照してください連鎖変数。

一般的なオプションの入力

カスタムオプションの入力

テキストボックス変数の追加

テキストボックス変数には、オプションのデフォルト値を含むテキスト入力フィールドが表示されます。任意の値を入力できるため、これは最も柔軟な変数です。カーディナリティの高いメトリクスがある場合、またはダッシュボード内の複数のパネルを同時に更新する場合は、このタイプの変数を使用します。

一般的なオプションの入力

テキストオプションの入力

定数変数の追加

非表示の定数を定義するには、定数変数を使用します。定数変数は、共有するダッシュボードのメトリクスパスプレフィックスに役立ちます。ダッシュボードをエクスポートすると、定数変数がインポートオプションに変換されます。

定数変数には柔軟性がありません。各定数変数は 1 つの値のみを保持します。更新するには、変数設定を更新する必要があります。

定数変数は、クエリに含める必要があるが、すべてのクエリで再入力したくない複雑な値がある場合に便利です。例えば、 というサーバーパスがある場合i-0b6a61efe2ab843gg、それを という変数に置き換えることができます$path_gg。

一般的なオプションの入力

定数オプションの入力

データソース変数の追加

ダッシュボード全体のデータソースをすばやく変更するには、データソース変数を使用できます。これらは、データソースのインスタンスが複数ある場合に便利です。場合によっては、異なる環境にもあります。

一般的なオプションの入力

データソースオプションの入力

間隔変数の追加

間隔変数を使用して、1m、1h、 などの時間範囲を表します1d。これらはダッシュボード全体の group-by-time コマンドと考えることができます。間隔変数は、視覚化でのデータのグループ化方法を変更します。Auto オプションを使用して、時間範囲ごとに設定された数のデータポイントを返すこともできます。

間隔変数は、時間 (InfluxDB の場合）、日付ヒストグラム間隔 ( の場合）、または要約関数パラメータ (Graphite の場合 OpenSearch) でグループ化するパラメータとして使用できます。

一般的なオプションの入力

間隔オプションの入力

間隔変数の例

Graphite 関数myintervalで テンプレート変数を使用する例：

summarize($myinterval, sum, false)

より複雑な Graphite の例：

groupByNode(summarize(movingAverage(apps.$app.$server.counters.requests.count, 5), '$interval', 'sum', false), 2, 'sum')

アドホックフィルターの追加

1 回限りのフィルターまたはアドホックフィルターを使用して、指定したデータソースを使用するすべてのメトリクスクエリに自動的に追加されるキー/値フィルターを追加できます。他の変数とは異なり、クエリでは 1 回限りのフィルターを使用しません。代わりに、それらを使用して既存のクエリのフィルターを記述します。

一般的なオプションの入力

オプションの入力

アドホックフィルターの作成

アドホックフィルターは、利用可能な最も複雑で柔軟な変数オプションの 1 つです。この変数は、変数オプションの通常のリストの代わりに、ダッシュボード全体のアドホッククエリの構築を可能にします。この方法で適用したフィルターは、ダッシュボード上のすべてのパネルに適用されます。

連鎖変数

連鎖変数 は、リンクされた変数 またはネストされた変数 とも呼ばれ、変数クエリに 1 つ以上の他の変数を含むクエリ変数です。このセクションでは、連鎖変数の仕組みについて説明し、連鎖変数を使用するダッシュボードの例へのリンクを提供します。

連鎖変数クエリはデータソースごとに異なりますが、前提はすべての で同じです。連鎖変数クエリは、それらをサポートする任意のデータソースで使用できます。

5 レベルまたは 10 レベルの複雑なリンクされたテンプレート化されたダッシュボードを構築できます。技術的には、どれだけ深く、複雑に行けるかに制限はありませんが、リンクが多いほど、クエリの負荷が大きくなります。

ベストプラクティスとヒント

以下のプラクティスにより、ダッシュボードと変数の使用が容易になります。

新しい連鎖変数の作成

可変順序

ダッシュボード可変リストの可変の順序を変更するには、各エントリの右側にある上矢印と下矢印を選択します。Grafana ワークスペースには、このリストに従って左から右に変数ドロップダウンリストが一覧表示され、左端のリストの上部に変数が表示されます。

複雑さに関する考慮事項

変数の依存関係のレイヤーが多いほど、変数を変更した後にダッシュボードを更新するのに時間がかかります。

例えば、リンクされた一連の 4 つの変数 (国、地域、サーバー、メトリクス) があり、ルート変数の値 (国) を変更する場合、Grafana ワークスペースはダッシュボードの視覚化を更新する前に、すべての依存変数に対してクエリを実行する必要があります。

グローバル変数

Grafana には、クエリエディタの式で使用できるグローバル組み込み変数があります。このトピックでは、それらをアルファベット順にリストし、定義します。これらの変数は、クエリ、ダッシュボードリンク、パネルリンク、およびデータリンクに役立ちます。

$__ダッシュボード

この変数は、現在のダッシュボードの名前です。

$__from および $__to

Grafana には、 $__fromと の 2 つの時間範囲変数が組み込まれています$__to。現在、デフォルトでは常にエポックミリ秒として補間されますが、日付の書式を制御できます。

上記の構文は ${__to}でも機能します。

この変数は URLsでも使用できます。例えば、6 時間前から現在までの時間範囲を表示するダッシュボードにエンドユーザーを送信するには、https://play.grafana.org/d/000000012/grafana-play-home?viewPanel =2&orgId =1?from=now-6h&to=now という URL を使用します。

$__ 間隔

$__interval 変数は、時間別にグループ化するパラメータ (InfluxDB 、Myself、Postgres、MSSQL の場合）、日付ヒストグラム間隔 ( の場合）、または要約関数パラメータ (Graphite の場合 OpenSearch) として使用できます。

Grafana ワークスペースは、クエリで時間別にグループ化するために使用できる間隔を自動的に計算します。グラフに表示されるデータポイントよりも多くのデータポイントがある場合、間隔を長くしてグループ化することで、クエリをより効率的に行うことができます。例えば、3 か月のデータを見ると、1 日でグループ化するのが 10 秒でグループ化するよりも効率的です。グラフは同じように見え、クエリは速くなります。$__interval は、時間範囲とグラフの幅 (ピクセル数) を使用して計算されます。

概算計算: (from - to) / resolution

例えば、時間範囲が 1 時間でグラフが全画面表示の場合、間隔は に計算され、2mポイントは 2 分間隔でグループ化されます。時間範囲が 6 か月で、グラフが全画面表示の場合、間隔は 1d (1 日) になることがあります。ポイントは日別にグループ化されます。

InfluxDB データソースでは、レガシー変数 は同じ変数$intervalです。代わりに $__interval を使用します。

InfluxDB と OpenSearch データソースには、間隔をハードコードしたり、>構文 -> を使用して$__interval変数の最小制限を設定したりするために使用されるGroup by time intervalフィールドがあります>10m。

$__interval_ms

この変数はミリ秒単位の$__interval変数であり、時間間隔形式の文字列ではありません。例えば、 $__intervalが の場合20m、 $__interval_msは です1200000。

$__name

この変数は Singlestat パネルでのみ使用でき、オプションタブのプレフィックスまたはサフィックスフィールドで使用できます。変数はシリーズ名またはエイリアスに置き換えられます。

$__org

この変数は、現在の組織の ID です。変数は現在の組織の名前${__org.name}です。

$__user

変数は現在のユーザーの ID ${__user.id}です。変数は、現在のユーザーのログインハンドル${__user.login}です。変数は、現在のユーザーの E メール${__user.email}です。

$__range

この変数は現在、Prometheus データソースでのみサポートされています。この変数は、現在のダッシュボードの範囲を表します。これは によって計算されますto - from。ミリ秒と秒の表現は $__range_msおよび と呼ばれています$__range_s。

$timeFilter または $__timeFilter

$timeFilter 変数は、現在選択されている時間範囲を式として返します。例えば、時間範囲間隔Last 7 days式は ですtime > now() - 7d。

この変数は、次のようないくつかの場所で使用されます。