ビジュアライゼーションの注釈付け

注釈は、グラフ上のポイントをリッチイベントでマークする方法を提供します。注釈にカーソルを合わせると、イベントの説明とイベントタグを取得できます。テキストフィールドには、より詳細な他のシステムへのリンクを含めることができます。

ネイティブ注釈

Grafana には、ネイティブの注釈ストアと、グラフパネルから直接、または HTTP API を介して注釈イベントを追加する機能があります。

注釈の追加

または、注釈を追加するには、Ctrl+Clickまたは時系列パネルCmd+Clickに注釈の追加ポップアップが表示されます。

リージョンアノテーションの追加

注釈の編集

注釈の削除

組み込みクエリ

注釈を追加すると、それらは引き続き表示されます。これは、すべてのダッシュボードに存在する組み込みのアノテーションクエリが原因です。この注釈クエリは、現在のダッシュボードから発生したすべての注釈イベントを取得し、作成されたパネルに表示します。これには、アラート状態履歴の注釈が含まれます。注釈設定 (Dashboard cogs メニューを使用) を開き、 という名前のクエリを変更することで、注釈の取得と描画を停止できますAnnotations & Alerts (Built-in)。

名前を付けて保存機能を使用してダッシュボードをコピーすると、新しいダッシュボード ID が表示されるため、ソースダッシュボードで作成された注釈はコピーに表示されなくなります。新しい注釈クエリを追加してタグでフィルタリングすると、それらを表示することができます。これは、ソースダッシュボードの注釈にフィルタリングするタグがある場合にのみ機能します。

タグによるクエリ

でフィルタリングを に設定することで、-- Grafana --データソースを介してネイティブアノテーションストアからアノテーションを取得する新しいクエリを作成できますTags。

Grafana v8.1 以降のバージョンでは、既存のタグの先行タイプもサポートされており、少なくとも 1 つのタグを提供します。

例えば、注釈クエリ名outagesを作成し、タグ を指定しますoutage。このクエリは、停止タグを持つすべての注釈 (ダッシュボードから、または API を介して) を表示します。注釈クエリで複数のタグが定義されている場合、Grafana はすべてのタグに一致する注釈のみを表示します。動作を変更するには、 を有効にするとMatch any、Grafana は指定したタグのいずれかを含む注釈を表示します。

Grafana v5.3 以降では、タグクエリでテンプレート変数を使用できます。したがって、さまざまなサービスの統計を表示するダッシュボードと、表示するサービスを指定するテンプレート変数がある場合、注釈クエリで同じテンプレート変数を使用して、それらのサービスの注釈のみを表示できるようになりました。

他のデータソースのクエリ

注釈イベントは、注釈クエリを通じて取得されます。ダッシュボードに新しい注釈クエリを追加するには、ダッシュボード設定メニューを開き、注釈 を選択します。これにより、ダッシュボードの注釈設定ビューが開きます。新しい注釈クエリを作成するには、「新規」ボタンを押します。

注釈クエリの名前を指定します。この名前はトグル (チェックボックス) に付けられ、このクエリの注釈イベントの表示を有効または無効にできます。例えば、 Deploysと という名前の 2 つの注釈クエリがあるとしますOutages。トグルを使用すると、表示する注釈を決定できます。

注釈クエリの詳細

注釈クエリのオプションは、データソースごとに異なります。特定のデータソースの注釈については、特定のデータソーストピックを参照してください。