メトリクスを生成¶
- バージョン：1.0.7-7-g251eead
- リリース日：2023-04-06 11:17:57
- 対応OS：windows/amd64, windows/386, linux/arm, linux/arm64, linux/386, linux/amd64
Guanceは、現在のワークスペース内の既存データに基づいて新しいメトリクスデータを生成する機能をサポートしています。これにより、お客様のニーズに応じて新しい技術指標を設計・実装できます。
Warning
ルールの作成/クローン¶
セキュリティチェック > メトリクスを生成ページに移動します。
- ルールを作成をクリックすると、新しいメトリクス生成ルールの作成を開始できます。
- アイコンをクリックすると、既存のルールをクローンして新しいルールを作成できます。
Step 1: データソース。現在のワークスペース内の全データソース、または単一カテゴリのデータソースを選択します。
- カテゴリ：セキュリティチェックコレクタを有効にすると、カテゴリには
network、storage、database、system、webserver、Kubernetesが含まれます。注意：「*」は「すべて」を意味します。
Step 2: データクエリ。選択したカテゴリに基づいて集計方法を選択し、異なるディメンションのデータを集計・クエリします。
- 集計方法：下表を参照
| 集計方法 | 説明 |
|---|---|
| count | 件数をカウント |
| avg | 平均値を算出。集計するフィールドを選択する必要があります |
| max | 最大値を算出。集計するフィールドを選択する必要があります |
| min | 最小値を算出。集計するフィールドを選択する必要があります |
| P75 | 指定フィールドの75パーセンタイル値を算出。集計するフィールドを選択する必要があります |
| P95 | 指定フィールドの95パーセンタイル値を算出。集計するフィールドを選択する必要があります |
| P99 | 指定フィールドの99パーセンタイル値を算出。集計するフィールドを選択する必要があります |
- ディメンション：選択したオブジェクトごとにデータを集約します。つまり、データリクエスト内の選択された各オブジェクトに対して統計値が生成されます。
- フィルター：既存のタグデータに1つ以上のフィルタリング条件を追加し、同じ行のフィルタ条件に「かつ」(and) または「または」(or) の関係を設定できます。
Step 3: メトリクスを生成。メトリクスの生成方法と結果を設定します。生成周期、新規メトリクス名、メトリクスセット名を含みます。
- 頻度：メトリクス生成の実行周期。デフォルトは1分で、1分ごとに新しいメトリクスデータが生成されます。選択した頻度の時間は集計時間としても機能します。頻度を1分に選択した場合、1分ごとに集計が実行され、各集計の時間範囲も1分です。
- 時間範囲：選択した頻度を時間間隔とします。グラフのデフォルトクエリは6時間です。つまり、6時間以内の特定のデータの統計表示効果を示します。【頻度】を1時間以上に変更すると、クエリ時間範囲は7日間に固定されます。
- メトリクスセット：メトリクスの保存先となるメトリクスセットの名前を設定します。
- メトリクス：メトリクスの名前を設定します。メトリクス名は重複できません。複数のメトリクスを追加できます。
- タグ：クエリで選択したディメンションに基づいて自動生成されます。
- 単位：任意入力。メトリクスの単位を設定します。生成されたメトリクスに単位を設定すると、グラフクエリで適用できます。
- 説明：任意入力。メトリクスの説明を設定します。生成されたメトリクスに説明を設定すると、グラフクエリで適用できます。
Step 4: 生成ルールの入力を完了したら、「確定」をクリックしてメトリクス生成ルールを完了し、データ収集を開始します。
操作説明¶
追加されたすべてのルールは「メトリクスを生成」のインターフェースに表示されます。ユーザーは「有効化/無効化」、「メトリクス分析で開く」、「メトリクス管理で開く」、「編集」、「削除」などの操作を実行できます。
ルールの編集¶
「メトリクスを生成」ページでは、作成されたすべてのメトリクス生成ルールを表示し、編集できます。
注意：メトリクス生成ルールのデータソースや集計式などはデータ型を決定するため、一部のルールは編集・変更をサポートしていません。
ルールの有効化/無効化¶
「メトリクスを生成」ページでは、ルールの状態を変更できます。メトリクス生成ルールが無効化されると、対応するデータはメトリクスセットに書き込まれなくなります。有効化後に書き込みが再開されます。
ルールの削除¶
「メトリクスを生成」ページでは、不要なルールを削除できます。ルールが「削除」されても、メトリクスセットは削除されませんが、データの書き込みは停止します。
一括操作¶
特定のルールに対して一括操作（有効化、無効化、削除）を実行できます。
メトリクスの表示¶
メトリクス分析での表示¶
「メトリクスを生成」ページで、ルール右側の「メトリクス分析で開く」ボタンをクリックすると、「メトリクス分析」ページに移動してクエリと分析を行えます。
メトリクス管理での表示¶
「メトリクスを生成」ページで、ルール右側の「メトリクス管理で開く」ボタンをクリックすると、「メトリクス管理」ページに移動してメトリクスとタグを表示できます。メトリクスの単位と説明の編集をサポートします。
その他のユースケース¶
グラフクエリでの適用¶
メトリクス生成後、「シナリオ」>「ダッシュボード」>「ダッシュボードを作成」で、可視化グラフでメトリクスデータのクエリと分析を行えます。
DQL クエリツールでの適用¶
メトリクス生成後、「ショートカット」>「DQL クエリ」でメトリクスデータのクエリと分析を行えます。
