ノート¶

ノートは Guance に組み込まれた構造化された知識の保存媒体であり、オブザーバビリティのシナリオ向けに設計されています。障害分析やパフォーマンス調査などのプロセスで生成される重要な情報を蓄積するために使用されます。ノートは本文にリアルタイムのデータチャートを直接埋め込むことをサポートしており、記録された内容をシステムの実際の状態と常に関連付けることができます。ワークスペースのメンバーと共有でき、問題の追跡、特定、および共同作業に役立ちます。

ノートを作成¶

ノートに移動し、ノートを作成をクリックして、ノートのタイトルを定義すると編集を開始できます。ノートの本文は Markdown 形式をサポートしており、必要に応じてテキストまたは Chart Block チャートを挿入できます。編集が完了したら、右上隅のプレビューをクリックしてプレビューモードに切り替えると、Chart Block がインタラクティブなチャートとしてリアルタイムにレンダリングされます。

詳細はノートの作成/編集を参照してください。

コア機能¶

構造化記録¶

各ノートは、タイトル、可視性、タグ、ビジネスタグ（KV 形式）などの属性の設定をサポートしています。ビジネスタグは、特定のビジネスオブジェクトを関連付けるために使用され、AI 検索のコアパスです。例えば、service:checkout、host:prod-node-01 などです。

Chart Block¶

ノートの本文は Chart Block 構文の拡張をサポートしており、プレビューモードではインタラクティブなチャートとしてリアルタイムにレンダリングされます。時系列折れ線グラフ、数値概要、テーブル、棒グラフ、アラートイベントタイムライン、円グラフ、ヒートマップの 7 種類のチャートタイプをサポートし、データはワークスペースのリアルタイムクエリから取得されます。

編集モードでは、Chart Block 設定説明の構文に従って、チャートタイプ、クエリ文、表示パラメータを直接記述できます。また、プレビュー時にプラットフォームのチャートコンポーネントによってクエリが実行されレンダリングされたチャートを確認することもできます。

複数タブ¶

ノート編集エリアは、複数のノートを同時に開くことをサポートしており、タブ形式で並べて表示できます。障害対応時に複数の履歴記録を同時に参照する場合に便利です。ノートモジュールに再度アクセスすると、前回開いていたタブの状態が自動的に保持されます。

マルチモジュール連携¶

ノートにビジネスタグ（KV 形式）を設定することで、ノートは Guance の他のモジュールのオブジェクトと自動的に関連付けられます。ホスト、サービス、ダッシュボード、トレースなどのオブジェクトの詳細ページでは、ノートモジュールに移動することなく、そのオブジェクトに関連付けられたノートのリストに直接アクセスでき、コンテキスト内での知識の蓄積と参照が可能になります。

例えば、ノートに host:prod-node-01 タグを追加すると、そのノートは対応するホストの詳細ページの「ノート」タブに自動的に表示されます。

ノートの管理¶

ノートリスト操作¶

• 検索：キーワードでノートを検索します。
• お気に入り：ノートの右側にあるお気に入りアイコンをクリックすると、お気に入りに追加され、「マイお気に入り」のショートカットから確認できます。
• 削除：ノートの右上隅にある操作メニューをクリックして削除を選択し、確認後に現在のノートを削除します。

フィルタリングと検索¶

左側のディレクトリバーでは、タグやビジネスタグによるノートのフィルタリングが可能で、以下のショートカットを提供します。

• すべてのノート：ワークスペース内のすべてのノート。
• マイお気に入り：現在のユーザーがお気に入りに追加したノート。
• 自分が作成したノート：現在のユーザーが作成したすべてのノート。
• プライベートノート：作成者のみが表示できるノート。

可視性¶

ノートは以下の 2 種類の可視性を設定できます。

• 公開：ワークスペースのすべてのメンバーが表示できます。
• プライベート：作成者のみが表示および編集できます。

はじめに¶