メトリクス

概要

APM > メトリクス セクションには、アプリケーションおよびサービスから収集されたメトリクスのデータポイントが表示されます。

メトリクスとは、測定値（リクエスト時間、処理された注文数、メモリ使用量など）です。 アプリケーションは、特定の時点で測定された値（または集計値）を含む データポイント として値を送信します。 メトリクスはZabbixのアイテムに、データポイントはそのアイテムの値に似ています。

データポイントには、次のいずれかのタイプがあります。

  • Gauge - 特定の時点で測定された値（現在のメモリ使用量など）。
  • Sum - 一定期間にわたる測定値の合計（リクエストの総数など）。
  • Histogram - バケットと呼ばれる複数の固定された値の範囲ごとに、一定期間内にその範囲に該当した測定値の数（0～100ミリ秒、100～250ミリ秒、250～500ミリ秒かかったリクエストの数など）。
  • Exponential histogram - ヒストグラムと同様ですが、各バケットの幅が同じ倍率で前のバケットより広くなります（1～2ミリ秒、2～4ミリ秒、4～8ミリ秒など）。

各データポイントは、サービス（zabbix-frontend など。OpenTelemetryの service.name リソース属性によって名前が付けられます）と、データポイントを作成したコードの一部である インストルメンテーションスコープ（HTTPリクエスト時間を測定するライブラリなど）によって生成されます。

各測定値のコンテキストを提供するため、データポイントにはキーと値の 属性 も含まれます。データポイント属性 は測定対象を示し、同じメトリクスのデータポイントを区別します（http.request.method: POST など）。リソース属性 は、サービスとその実行環境を示します（host.name: eabf8c2a5ddc など）。

メトリクスの詳細については、OpenTelemetryのドキュメントを参照してください。

APM > メトリクス セクションには、次の要素が含まれます。

メトリック一覧

メトリック一覧の各行は、1つのデータポイントを表します。

データポイントは、カスタマイズ可能なテーブルに表示されます。 テーブルヘッダーの テーブルをカスタマイズ ボタンを使用すると、列の表示、非表示、並べ替え、およびレイアウトのデフォルト設定へのリセットを行えます。 各列の右端をドラッグして列の幅を変更することもできます。右端をダブルクリックすると、幅がリセットされます。 すべてのカスタマイズは直ちに適用され、現在のユーザーに対して保存されます。

メトリック一覧には、次の列を表示できます。

タイプ を除く各列は、テレメトリデータソースのメトリックテーブル（otel_metrics_gauge、otel_metrics_sum、otel_metrics_histogram、otel_metrics_exponential_histogram）の列に対応しています。列の一覧については、サポートされているテレメトリデータ列を参照してください。 ほとんどの列は、データソース内と同じ名前です（例: メトリック名 は MetricName 列に対応します）。 名前が異なる場合は、下の表にデータソースの列名を記載しています。

列 説明
メトリック名 データポイントが属するメトリック（例: http.server.duration）。
タイプ データポイントのタイプ: ゲージ、合計、ヒストグラム、または 指数ヒストグラム。
データポイントを保持するメトリックテーブルによって決まります。
単位 メトリック値の単位（存在する場合）（例: s または By。UCUMを参照）。
データソースの列: MetricUnit。
サービス名 データポイントを生成したサービス。
スコープ名 データポイントを生成したインストルメンテーションスコープ。
開始時刻 データポイントの測定期間が開始した日時。
データソースの列: StartTimeUnix。
合計/値 すべての測定値の合計（ヒストグラム、指数ヒストグラム）、またはデータポイントの値（ゲージ、合計）。
カウント ヒストグラム または 指数ヒストグラム データポイントの測定値の数。
時刻 データポイントの日時。合計、ヒストグラム、および 指数ヒストグラム データポイントの場合は、測定期間の終了時刻。
データソースの列: TimeUnix。
フラグ データポイントのフラグ:
0 - フラグは設定されていません。
1 - データポイントの値は記録されていません。
集計の一時性 合計、ヒストグラム、または 指数ヒストグラム データポイントの値を時間の経過に伴って集計する方法:
未指定 - 指定されていません。
デルタ - 前のデータポイント以降の期間で集計されます。
累積 - 開始時刻以降の期間で集計されます。
メトリックの説明 メトリックの説明（存在する場合）。
属性 データポイントの属性。
3点ボタンをクリックすると、すべての属性が表示されます。
リソース属性 データポイントのリソース属性。
3点ボタンをクリックすると、すべての属性が表示されます。
スコープ属性 インストルメンテーションスコープの属性。
3点ボタンをクリックすると、すべての属性が表示されます。

メトリックの詳細

メトリック一覧でデータポイントをクリックすると、データポイントに関するすべての情報を表示するメトリックの詳細パネルが開きます。

メトリックの詳細パネルには、次のセクションが表示されます。

セクション 説明
基本情報 メトリック名、タイプ、単位、サービス名、開始時刻。
ヒストグラム バケット（例: > 5 - 10）と、それぞれに含まれる測定値の数。
ヒストグラムデータポイントの場合のみ表示されます。
指数ヒストグラム バケット（例: >= 249.7885 - 249.7887）と、それぞれに含まれる測定値の数。
指数ヒストグラムデータポイントの場合のみ表示されます。
メトリック情報 データポイントのタイプに応じた値、およびメトリックの説明、時刻、フラグ、リソーススキーマURL。
属性 データポイントの属性。
リソース属性 リソース属性。
スコープ属性 インストルメンテーションスコープの属性（存在する場合）。
スコープ インストルメンテーションスコープの名前、バージョン、スキーマURL。

フィルターの使用

フィルターを使用すると、関心のあるデータポイントのみを表示できます。

属性でフィルタリングするには、属性キーを入力し、演算子を選択して、属性値を入力します。

次の演算子がサポートされています。

  • Contains - (デフォルト) 属性値に入力した文字列が含まれます。
  • Equals - 属性値が入力した文字列と一致します。
  • Does not contain - 属性値に入力した文字列が含まれません。
  • Does not equal - 属性値が入力した文字列と一致しません。
  • Exists - 入力したキーを持つ属性が存在します。
  • Does not exist - 入力したキーを持つ属性が存在しません。

複数の条件を追加する場合は、条件の評価方法を選択します。

  • And/Or - (デフォルト) すべての条件を満たす必要があります。同じ属性キーを持つ条件は Or で結合されます。
  • Or - 少なくとも1つの条件を満たす必要があります。