Simple Log Service の Metricstore でメトリックデータをクエリおよび分析し、時系列グラフの凡例フォーマットをカスタマイズします。
前提条件
メトリックデータが収集済みであること。
手順
Metricstore のクエリページは PromQL 構文のみをサポートしています。 SQL または SQL+PromQL を使用するには、 を選択して、対応する Logstore のクエリページに切り替えてください。
Log Serviceコンソールにログインします。
[プロジェクト] セクションで、管理するプロジェクトをクリックします。
タブで、管理するメトリクストアをクリックします。
-
ページの右上隅にある [15分 (相対)] をクリックして、クエリの時間範囲を設定します。
説明クエリと分析の結果は、指定した時間範囲と最大 1 分異なる場合があります。
-
クエリを実行します。
次のいずれかの方法でクエリ文を入力します:
-
PromQL 文を入力し、今すぐ実行 をクリックします。
複数のクエリを追加できます。 結果は同じ時系列グラフに重ねて表示されます。
-
[メトリクス探索] ペインで、メトリックの横にある
アイコンをクリックすると、クエリ文が自動的に生成されます。また、[メトリクス探索] ペインでメトリックの 検索を続ける をクリックしてラベル値を設定し、クエリを自動生成することもできます。 詳細については、「メトリック探索」をご参照ください。
エディターでは、入力中に PromQL 関数 (
abs、avg、avg_over_timeなど) とメトリック名が自動補完されます。 -
PromQL 構文の検証
自動ツリー解析を有効にすると、エディターは、公式の Prometheus ドキュメントに記載されているように、PromQL 関数、集計関数、メトリック名、ラベルキー、ラベル値、および時間範囲を提案します。
Simple Log Service は、入力中にリアルタイムで PromQL 構文を検証します。
-
有効な構文
[「The syntax is valid.」] と表示された場合、検証に成功し、構文解析ツリーが生成されます。
-
無効な構文
エラーメッセージが表示された場合、検証は失敗です。 部分的な構文ツリーにエラーの場所と原因が表示されます。
この例では、
[5]に時間単位 (m、s、またはh) が欠落しているため、エラー4:1 parse error: unexpected <aggr:sum>が発生します:label_replace( sum by(pod_name)( rate(container_cpu_usage_seconds_total{namespace= "redash"}[5]) ), "pod", "$1", "pod_name", "(.+)" )
検証中に、次の操作も実行できます:
-
アイコンをクリックして、構文解析ツリーを更新します。 -
アイコンをクリックして、構文解析ツリーのノード情報を簡略化します。 -
または
アイコンをクリックして、ノードを展開または折りたたみます。 -
または
アイコンをクリックして、自動ツリー解析機能を有効または無効にします。
メトリック探索
[メトリクス探索] をクリックすると、メトリックとそのラベルデータを参照できます。 検索バーを使用して、名前でメトリックをフィルターできます。 結果のテーブルには、cpu_count、cpu_guest_util、cpu_sys_util などのメトリックが、合計数と時間範囲とともに一覧表示されます。 各メトリックには、[探索を続行]、コピー、および追加のアクションが用意されています。
[メトリクス探索] パネルでは、次の操作が可能です:
-
時間範囲の設定:デフォルトの時間範囲は 5 分です。 変更するには、変更 をクリックして時間範囲を修正します。
アイコンをクリックして、時間範囲をリセットします。 -
メトリックのフィルター:検索ボックスにメトリック名を入力してメトリックをフィルターします。
-
メトリック名のコピー:
アイコンをクリックしてメトリック名をコピーします。 -
クエリボックスへの追加:
アイコンをクリックしてメトリック名をクエリボックスに追加します。 -
探索の続行:検索を続ける をクリックして、メトリックのラベルキー、一意の値の数、およびサンプル値を表示します。
フィルター をクリックして、4 つの PromQL 演算子、選択可能または手動の条件、および正規表現を使用して、ラベル値でフィルタリングします。
システムはフィルターに基づいてクエリを生成します。 集約クリエ文のコピー または クエリボックスに追加 をクリックしてクエリを実行します。
凡例フォーマット
クエリを実行した後、時系列グラフに表示される凡例名をカスタマイズできます。
ステップは時間範囲に基づいて自動調整されますが、カスタマイズすることも可能です。
デフォルトでは、凡例名はメトリック名とラベルを組み合わせたものです。 {{value_name}} 変数を使用して、特定のラベル値を参照します。 たとえば、ラベルが {IP="192.0.2.1"} の場合、Legend Format を {{IP}} に設定すると、凡例名として 192.0.2.1 が表示されます。 クエリ入力ボックスの下にある [凡例フォーマット] 入力ボックスにカスタムフォーマットを入力します。
関連操作
|
操作 |
説明 |
|
メトリック統計 |
指標の統計 をクリックして 指標の統計 ダッシュボードを開きます。このダッシュボードには、データ量、メトリック数、タイムライン、データエントリ、トップメトリック、および前期比/前年同期比の変更が表示されます。 |
|
メトリックガバナンス |
指標ガバナンス をクリックして 指標ガバナンス ダッシュボードを開きます。このダッシュボードは、時系列シナリオ分析、メトリックトレンドグラフ、概要統計、およびネイティブ統計、データ分析、最適化、異常診断のためのエンドツーエンドのワークフローを提供します。 |
|
テーブルデータの表示 |
表データ を切り替えて、クエリ結果をテーブルに表示します。 |
|
生データのプレビュー |
Preview Raw Data をクリックして、生のメトリックデータを表示します。 |
|
データ変換 |
を選択して、データ変換を実行します。 詳細については、「データ変換の概要」をご参照ください。 |
|
カスタム分析 |
を選択します。 これにより、対応する Logstore のクエリページが開きます。このページは、SQL および SQL+PromQL クエリをサポートしています。 |
|
分析結果をスケジュールされた SQL ジョブとして保存 |
を選択して、スケジュールされた SQL ジョブでメトリックデータを処理し、結果を宛先の Metricstore に保存します。 詳細については、「Metricstore から別の Metricstore にデータをインポートするためのスケジュールされた SQL ジョブの作成」をご参照ください。 |
|
ダッシュボードに追加 |
ダッシュボードに追加 をクリックして、現在のグラフをダッシュボードに追加します。 詳細については、「グラフをダッシュボードに追加する」をご参照ください。 グラフをダッシュボードに追加した後、グラフのプロパティをカスタマイズします。 詳細については、「時系列グラフ」をご参照ください。 |
|
アラートとして保存 |
新規アラームに保存 をクリックして、クエリ結果のアラートを設定します。 詳細については、「アラートの作成」をご参照ください。 |
|
クエリと分析ウィンドウのコピー |
|
|
クエリと分析ウィンドウの削除 |
|
|
データの更新 |
今すぐ実行 の右側にある |
|
共有 |
|
アイコンをクリックして、現在のクエリと分析ウィンドウを削除します。
アイコンをクリックして、現在の Metricstore クエリページの URL をコピーします。 このリンクを、Metricstore へのアクセス権を持つユーザーと共有してください。 リンクにはすべての設定が含まれます。