[改善提案] Annotation機能についてのハンズオン追加

[HamadaKoji]

提案の概要

ハンズオン内容にAnnotationについての内容を追加する。

Annotate visualizations | Grafana documentation

対象セクション

Annotationに関わるセクション自体を新規で追加

提案の詳細

GrafanaにおいてAnnotation機能は、うまく使うとVisualizationの表現力を一気に拡張できる可能性がある機能です。普通にダッシュボードを構築しているだけでは、Annotationの機能自体に気づくのが難しいと思うので、ハンズオンで簡単に紹介することで、そのとっかかりとなるようにしたい。

この提案によるメリット

利用ユーザーが少ない？と思われるAnnotation機能へのとっかかりとなる。

その他のコメント

[HamadaKoji]

Annotation、ハンズオン内容のサンプル

8. アノテーションの追加

8.1 アノテーションの基本設定

1. ダッシュボードの設定（歯車アイコン）をクリック。
2. [Annotations]タブを選択。
3. [New Annotation]ボタンをクリック。

8.2 新しいアノテーションの作成

1. [Name]フィールドに「テストアノテーション」と入力。
2. [Data source]で[TestData DB]を選択。
3. [Enable]トグルがオンになっていることを確認。
4. [Save]をクリックして設定を保存。

8.3 アノテーションクエリの設定

1. 作成したアノテーションの編集アイコンをクリック。
2. [Query]セクションで、Scenarioを[Annotations]に設定。
3. [Save]をクリックして変更を適用。

8.4 手動でのアノテーション追加

1. グラフパネルに戻る。
2. グラフ上の任意の点を右クリック。
3. [Add annotation]を選択。
4. [Description]フィールドに「手動アノテーション」と入力。
5. [Tags]フィールドに「manual」と入力。
6. [Save]をクリックしてアノテーションを追加。

8.5 アノテーションの表示確認

1. グラフ上にアノテーションマーカーが表示されていることを確認。
2. アノテーションマーカーにマウスを重ね、詳細情報を確認。

8.6 アノテーションのフィルタリング

1. ダッシュボード上部の時間範囲セレクターの近くにある[Annotations]ドロップダウンをクリック。
2. 特定のアノテーションの表示/非表示を切り替え。

8.7 アノテーションの編集と削除

1. 既存のアノテーションマーカーを右クリック。
2. [Edit]または[Delete]オプションを選択。
3. 編集の場合、内容を変更して[Save]をクリック。

8.8 グラフ特異のアノテーション設定

1. グラフパネルの編集モードに入る。
2. [Panel] タブの [Annotations] セクションを展開。
3. 特定のアノテーションの表示/非表示を設定。

8.9 時間範囲に基づくアノテーションの追加

1. グラフ上でドラッグして時間範囲を選択。
2. 表示されるポップアップから[Add annotation]を選択。
3. アノテーションの詳細を入力し、[Save]をクリック。

8.10 アノテーションの活用

1. 異なる時間範囲でダッシュボードを表示し、アノテーションの有用性を確認。
2. アノテーションを使用してイベントや変更点を記録する方法を検討。