注釈
このドキュメントのトピックは、Grafana バージョン 8.x をサポートする Grafana ワークスペース向けです。
Grafana バージョン 10.x をサポートする Grafana ワークスペースについては、「Grafana バージョン 10 での作業」を参照してください。
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「Grafana バージョン 9 での作業」を参照してください。
注釈は、リッチイベントでグラフ上のポイントをマークする方法を提供します。注釈にカーソルを合わせると、イベントの説明とイベントタグを見ることができます。テキストフィールドには、より詳細な他のシステムへのリンクを含めることができます。
ネイティブ注釈
Amazon Managed Grafana には、ネイティブ注釈ストアと、グラフパネルから直接注釈イベントを追加する機能が付属しています。
注釈の追加
注釈を追加するには、[Ctrl] または [Cmd] を押して、注釈を追加する場所を選択します。注釈にタグを追加することで、他のダッシュボードから注釈を検索できるようになります。
リージョン注釈の追加
リージョンの注釈を作成するには、リージョンを選択しながら [Ctrl] または [Cmd] を押します。
ビルトインクエリクエリ
追加した注釈は表示されたままになります。これは、ビルトインの注釈クエリがすべてのダッシュボードに存在するためです。この注釈クエリは、現在のダッシュボードから発生するすべての注釈イベントを取得し、それらが作成されたパネルに表示されます。これには、アラート状態履歴の注釈が含まれます。注釈の取得と表示を停止するには、[ダッシュボード設定] (歯車) アイコン、[注釈] の順に選択し、Annotations & Alerts (Built-in)
という名前のクエリを変更します。
[名前を付けて保存] 機能を使用してダッシュボードをコピーすると、新しいダッシュボードに新しいダッシュボード ID が割り当てられるため、コピー元のダッシュボードで作成された注釈はコピーに表示されません。コピー元のダッシュボードの注釈にフィルタリングするタグがある場合は、新しい[注釈クエリ]を追加し、タグでフィルタリングすることで、コピーに注釈を表示できます。
タグによるクエリ
-- Grafana --
データソースを使用して [~でフィルタリング] を タグ に設定することで、ネイティブ注釈ストアから注釈を取得する新しい注釈クエリを作成できます。少なくとも 1 つのタグを指定します。例えば、outages
という名前の注釈クエリ名を作成し、outage
という名前のタグを指定します。このクエリは、(ダッシュボードまたは API 経由) で作成した outage
タグを含むすべての注釈を表示します。
デフォルトでは、注釈クエリに複数のタグを追加すると、Amazon Managed Grafana は指定したすべてのタグを持つ注釈のみを表示します。指定したタグのうち、いずれか1つを含む注釈を表示するには、[任意の一致] をオンにします。
Amazon Managed Grafana では、タグクエリでテンプレート変数を使用できます。例えば、さまざまなサービスの統計を表示するダッシュボードと、表示するサービスを制御するテンプレート変数がある場合は、注釈クエリで同じテンプレート変数を使用して、それらのサービスの注釈のみを表示できます。
その他のデータソースのクエリ
注釈イベントは、注釈クエリを使用して取得されます。ダッシュボードに新しい注釈クエリを追加するには、[ダッシュボード設定] (歯車) アイコン、[Annotations
]、[新規] の順に選択します。
注釈クエリの名前を指定します。この名前は、このクエリの注釈イベントの表示または非表示を切り替えるチェックボックスに表示されます。例えば、2 つの注釈クエリ(Deploys
と Outages
) があるとします。チェックボックスのオンとオフを切り替えることで、表示する注釈を指定できます。
注釈クエリの詳細
注釈クエリオプションは、データソースごとに異なります。