メトリクス管理¶
メトリクスデータの収集が完了すると、メトリクス管理で、報告されたすべてのメジャーメントと、それに関連するメトリクス、タグ、時系列数の統計および前日比、データポイント数、データ保存ポリシーを確認できます。
メジャーメント¶
メジャーメントは同種のメトリクスの集合で、複数のメトリクスとタグを含みます。システムに表示される各メジャーメントには、以下の情報が含まれます:
メトリクス¶
メトリクスはシステムの稼働状態(CPU 使用率、ページ読み込み時間など)を表し、メトリクス名(識別子)とメトリクス値(具体的な数値)で構成されます。
メジャーメント名をクリックすると、完全なメトリクス詳細(メトリクス名、元のメトリクス、フィールドタイプ、単位、説明)を確認でき、以下の操作をサポートします:
- 検索バーでキーワードに基づいてメトリクスを絞り込む;
- メトリクスリストを CSV ファイルとしてエクスポートする;
- 操作列では、ワンクリックでメトリクス分析を実行できる;
- メトリクスデータをクリックして展開すると、メトリクス設定を編集できる。
権限と優先度
- 編集権限:標準メンバー以上のロールのみ操作できます;
- 設定の優先度:メトリクス管理でカスタマイズした単位と説明は、デフォルトの収集データより優先されます。たとえば、単位を
BからGBに変更すると、シナリオ内のグラフクエリではデータが自動的にGBで表示されます。
タグ¶
データポイント収集対象の属性はタグによって識別されます。タグはキーと値のペアで表現され、タグ名とタグ値で構成され、1 つのデータポイントに複数のタグを付与できます。
メジャーメント名をクリックすると、対応するタグリストを確認できます。タグ名、タグ値の統計数、説明などの情報が含まれ、以下の操作をサポートします:
- 検索バーでキーワードに基づいてタグを絞り込む;
- タグリストを CSV ファイルとしてエクスポートする。
時系列¶
時系列はタグの組み合わせによって動的に生成され、メトリクス、タグ(フィールド)、データ保存期間を含みます。このうち、「メトリクス + タグ(フィールドの組み合わせ)」がデータ保存の主キーを構成します。
Guanceでは、ここに現在のメジャーメントの時系列総数が表示され、メトリクス統計グラフとタグ統計グラフによって、単一のメトリクス/タグにおける一意値数、時系列数、および前日比の変化が表示されます。
計算ロジック¶
メトリクス/タグ統計グラフは、全体メトリクス → 個別メトリクス → そのメトリクスをタグでグループ化 → 特定タグの具体的な値 → すべてのタグのグローバルビュー + タグ自体の統計という階層に基づいて統計計算を行います。
統計グラフでは、各フィールドの計算ロジックは以下のとおりです:
| フィールド | 説明 |
|---|---|
| 一意値数 | グローバルまたは単一メトリクスのディメンションにおけるタグの重複排除カウント(すなわち、そのタグに含まれる重複しない独立値の数) |
| 時系列数 | 単一のメトリクス/単一のタグ値が関与する時系列数 |
| 1d | 前日と比較した時系列数の変化 |
| 1d% | 1d / 昨日の時系列数 |
| 全体比率 |
| 用語 | 説明 |
|---|---|
| Database | データを保存するデータベースコンテナ |
| Measurement | メジャーメント(MySQL のテーブルに類似) |
| Field | メトリクスのキーと値のペア(実際の数値を保存し、インデックス化されない) |
| Field Set | 複数の Field の集合 |
| Field Key | Field のキー名(例:cpu_usage) |
| Field Value | Field の数値(例:85.3) |
| Tag | タグのキーと値のペア(説明的メタデータ、インデックス化される) |
| Tag Set | 複数の Tag の集合 |
| Tag Key | Tag のキー名(例:host) |
| Tag Value | Tag の値(例:server-01) |
| TimeStamp | データポイントのタイムスタンプ(ナノ秒精度) |
| Retention Policy | データ保持期間(例:30 日) |
| Series | 一意の時系列(Measurement + Tag Set の組み合わせ) |
データポイント数¶
メジャーメント一覧のデータポイント数列では、各メジャーメントのデータ保存期間内のデータポイント総数を確認できます。単位は点です。列見出しの横にあるヒントアイコンにカーソルを合わせると、集計基準の説明を確認できます。
集計範囲
データポイント数は、ページ右上の時間フィルターの影響を受けません。日付を切り替えても、この列にはメジャーメントの保存期間内のデータポイント総数が表示されます。
データ保存ポリシー¶
データ保存ポリシーは 2 つのレベルに分かれます:
ポリシーの変更¶
メジャーメントのカスタム設定は、ワークスペースのグローバル設定より優先されます。つまり、特定のメジャーメントにカスタム保存ポリシーを設定した後でグローバル設定を変更しても、そのメジャーメントには影響しません。
注意
ポリシーを変更するたびにデータが即時削除されるため、重要なデータは事前にバックアップしてください。
注意事項¶
メジャーメントの保存ポリシーを変更する際は、以下の重要なルールに注意してください:
- データの即時削除:ポリシー変更後、元のポリシーに従って保存されていたそのメジャーメントのデータは完全に削除され、復元できません。その後再度ポリシーを変更すると、現在のポリシーのデータも同様に削除されます;
- 独立保存の仕組み:カスタムポリシーを設定すると、メジャーメントのデータは独立して保存されます。この状態でグローバルポリシーの保存期間を変更しても、カスタム設定済みのメジャーメントには影響しません;
- グローバルポリシーへの復帰:「グローバルデフォルト」に戻すと、データは再びグローバルストレージに保存されます。その後グローバルポリシーを変更すると、そのメジャーメントにも同期して影響します;
- 保存期間が同じでもポリシーが同じとは限らない:カスタム期間がグローバルと一致していても、データは引き続き独立して保存されます。例:グローバルが 7 日の場合に、あるメジャーメントを 7 日に設定しても、独立保存に該当します。
変更手順¶
グローバル設定¶
管理 > ワークスペース設定 > 危険な操作 > データ保存ポリシーの変更 > メトリクスに進み、保存期間を選択します。
メジャーメントのカスタム設定¶
メトリクス > メトリクス管理に進み、各メジャーメントの右側にある操作列で アイコンをクリックすると、期間を選択できます。未設定の場合はグローバルポリシーを自動的に継承します。
重要な制限事項
- 権限管理:ワークスペースの所有者のみ設定できます;
- データリスク:ポリシーを変更すると、元のポリシーのデータが直ちに完全削除されます。


