エクスポートされるメトリクス - AWS App Mesh
PrometheusCloudWatchメトリクス拡張機能Datadog

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

エクスポートされるメトリクス

重要

サポート終了通知: 2026 年 9 月 30 日、 は のサポートを中止 AWS します AWS App Mesh。2026 年 9 月 30 日以降、 AWS App Mesh コンソールまたは AWS App Mesh リソースにアクセスできなくなります。詳細については、このブログ記事の「 から Amazon ECS Service Connect AWS App Mesh への移行」を参照してください。

Envoyは、独自の操作と、インバウンドおよびアウトバウンドトラフィックに関するさまざまなディメンションの両方に関する多くの統計を発行します。Envoy の統計の詳細については、Envoy のドキュメントの「統計」を参照してください。これらのメトリクスは、プロキシの管理ポート 上の /stats エンドポイントを介して利用可能になります (通常は 9901)。

stat プレフィックスは、単一リスナーを使用しているのか、複数のリスナーを使用しているのかによって異なります。その違いを示す例を以下に示します。

警告

単一リスナーを複数のリスナー機能に更新すると、以下の表に示す stat プレフィックスが更新され、重大な変更が発生する可能性があります。

Envoy イメージ 1.22.2.1-prod 以降を使用することをお勧めします。これにより、Prometheus エンドポイントで類似のメトリクス名を確認できます。

単一リスナー (SL)/「ingress」リスナープレフィックスが付いた既存の統計情報 複数のリスナー (ML)/「ingress.<protocol>.<port>」リスナープレフィックスが付いた新しい統計情報

http.*ingress*.rds.rds_ingress_http_5555.version_text

http.*ingress.http.5555*.rds.rds_ingress_http_5555.version_text

http.*ingress.http.6666*.rds.rds_ingress_http_6666.version_text

listener.0.0.0.0_15000.http.*ingress*.downstream_rq_2xx

listener.0.0.0.0_15000.http.*ingress.http.5555*.downstream_rq_2xx

listener.0.0.0.0_15000.http.*ingress.http.6666*.downstream_rq_2xx

http.*ingress*.downstream_cx_length_ms

http.*ingress.http.5555*.downstream_cx_length_ms

http.*ingress.http.6666*.downstream_cx_length_ms

統計エンドポイントの詳細については、Envoy のドキュメントの「統計エンドポイント」を参照してください。管理者インターフェイスの詳細については、「Envoy プロキシ管理インターフェイスを有効にする」を参照してください。

Amazon での App Mesh 用 Prometheus EKS

重要

サポート終了通知: 2026 年 9 月 30 日、 は のサポートを中止 AWS します AWS App Mesh。2026 年 9 月 30 日以降、 AWS App Mesh コンソールまたは AWS App Mesh リソースにアクセスできなくなります。詳細については、このブログ記事の「 から Amazon ECS Service Connect AWS App Mesh への移行」を参照してください。

Prometheus はオープンソースのシステムモニタリングおよびアラートツールキットです。その機能の 1 つは、他のシステムが使用できるメトリクスを出力するための形式を指定することです。Prometheus の詳細については、Prometheus のドキュメントの「概要」を参照してください。Envoy は、パラメーター /stats?format=prometheus を渡すことで、統計エンドポイントを介してメトリクスを発行できます。

Envoy イメージビルド v1.22.2.1-prod を使用している場合、入力リスナー固有の統計情報を示すために 2 つのディメンションが追加されています。

  • appmesh.listener_protocol

  • appmesh.listener_port

Prometheus の既存の統計情報と新しい統計情報の比較です。

  • 「ingress」リスナープレフィックスが付いた既存の統計情報

    envoy_http_downstream_rq_xx{appmesh_mesh="multiple-listeners-mesh",appmesh_virtual_node="foodteller-vn",envoy_response_code_class="2",envoy_http_conn_manager_prefix="ingress"} 931433

  • 「ingress.<protocol>.<port>」が付いた新しい統計情報、Appmesh Envoy イメージ v1.22.2.1-prod 以降

    envoy_http_downstream_rq_xx{appmesh_mesh="multiple-listeners-mesh",appmesh_virtual_node="foodteller-vn",envoy_response_code_class="2",appmesh_listener_protocol="http",appmesh_listener_port="5555",envoy_http_conn_manager_prefix="ingress"} 20

  • 「ingress.<protocol>.<port>」が付いた新しい統計情報、カスタム Envoy イメージビルド

    envoy_http_http_5555_downstream_rq_xx{appmesh_mesh="multiple-listeners-mesh",appmesh_virtual_node="foodteller-vn",envoy_response_code_class="2",envoy_http_conn_manager_prefix="ingress"} 15983

複数のリスナーの場合、特別なクラスター cds_ingress_<mesh name>_<virtual gateway name>_self_redirect_<ingress_listener_port>_<protocol>_<port> はリスナー固有になります。

  • 「ingress」リスナープレフィックスが付いた既存の統計情報

    envoy_cluster_assignment_stale{appmesh_mesh="multiple-listeners-mesh",appmesh_virtual_gateway="tellergateway-vg",Mesh="multiple-listeners-mesh",VirtualGateway="tellergateway-vg",envoy_cluster_name="cds_ingress_multiple-listeners-mesh_tellergateway-vg_self_redirect_http_15001"} 0

  • 「ingress.<protocol>.<port>」が付いた新しい統計情報

    envoy_cluster_assignment_stale{appmesh_mesh="multiple-listeners-mesh",appmesh_virtual_gateway="tellergateway-vg",envoy_cluster_name="cds_ingress_multiple-listeners-mesh_tellergateway-vg_self_redirect_1111_http_15001"} 0
envoy_cluster_assignment_stale{appmesh_mesh="multiple-listeners-mesh",appmesh_virtual_gateway="tellergateway-vg",envoy_cluster_name="cds_ingress_multiple-listeners-mesh_tellergateway-vg_self_redirect_2222_http_15001"} 0

Prometheus のインストール

  1. EKS リポジトリを Helm に追加します。

    helm repo add eks https://aws.github.io/eks-charts

  2. App Mesh Prometheus のインストール

    
helm upgrade -i appmesh-prometheus eks/appmesh-prometheus \
--namespace appmesh-system

Prometheus の例

次は、Prometheus 永続的ストレージ用に PersistentVolumeClaim を作成する例です。


helm upgrade -i appmesh-prometheus eks/appmesh-prometheus \
--namespace appmesh-system \
--set retention=12h \
--set persistentVolumeClaim.claimName=prometheus

Prometheus の使用方法のチュートリアル

Amazon での Prometheus と Prometheus の詳細については、「」を参照してください。 EKS

CloudWatch App Mesh 用

重要

サポート終了通知: 2026 年 9 月 30 日、 は のサポートを中止 AWS します AWS App Mesh。2026 年 9 月 30 日以降、 AWS App Mesh コンソールまたは AWS App Mesh リソースにアクセスできなくなります。詳細については、このブログ記事の「 から Amazon ECS Service Connect AWS App Mesh への移行」を参照してください。

Amazon CloudWatch から Envoy 統計を に出力する EKS

CloudWatch エージェントをクラスターにインストールし、プロキシからメトリクスのサブセットを収集するように設定できます。Amazon EKSクラスターをまだお持ちでない場合は、「チュートリアル: Amazon on での App MeshEKS」の手順で作成できます GitHub。同じチュートリアルに従って、サンプルアプリケーションをクラスターにインストールできます。

クラスターに適切なIAMアクセス許可を設定し、エージェントをインストールするには、「Prometheus Metrics Collection で CloudWatch エージェントをインストールする」のステップに従います。デフォルトのインストールには、Envoy 統計の有用なサブセットを取得する Prometheus スクレイプ設定が含まれています。詳細については、「App Mesh の Prometheus メトリクス」を参照してください。。

エージェントが収集しているメトリクスを表示するように設定された App Mesh カスタム CloudWatch ダッシュボードを作成するには、「Prometheus メトリクスの表示」チュートリアルのステップに従います。トラフィックが App Mesh アプリケーションに入ると、グラフに対応するメトリクスが入力され始めます。

のメトリクスのフィルタリング CloudWatch

App Mesh メトリクス拡張機能には、メッシュで定義したリソースの動作に関するインサイトを提供する便利なメトリクスのサブセットが用意されています。エージェントは CloudWatch Prometheus メトリクスのスクレイピングをサポートしているため、Envoy からプルして に送信するメトリクスを選択するスクレイプ設定を指定できます CloudWatch。

Prometheus を使用してメトリクスをスクレイピングする例については、「メトリクス拡張機能」チュートリアルを参照してください。

CloudWatch 例

のサンプル設定は、 AWS サンプルリポジトリ CloudWatch にあります。

を使用するためのチュートリアル CloudWatch

App Mesh のメトリクス拡張機能

重要

サポート終了通知: 2026 年 9 月 30 日、 は のサポートを中止 AWS します AWS App Mesh。2026 年 9 月 30 日以降、 AWS App Mesh コンソールまたは AWS App Mesh リソースにアクセスできなくなります。詳細については、このブログ記事の「 から Amazon ECS Service Connect AWS App Mesh への移行」を参照してください。

Envoy は、数百のメトリクスをいくつかの異なる次元に分けて生成します。メトリクスは、App Mesh との関連付け方法においては簡単ではありません。仮想サービスの場合、特定の仮想ノードまたは仮想ゲートウェイと通信している仮想サービスを確実に知るメカニズムはありません。

App Mesh メトリクス拡張により、メッシュで実行される Envoy プロキシが強化されます。この機能拡張により、プロキシは、定義したリソースを認識した追加のメトリクスを出力できます。追加のメトリクスのこの小さなサブセットは、App Mesh で定義したリソースの動作をより詳細に把握するのに役立ちます。

App Mesh メトリクス拡張機能を有効にするには、環境変数 APPMESH_METRIC_EXTENSION_VERSION を 1 に設定します。

APPMESH_METRIC_EXTENSION_VERSION=1

Envoy 設定変数の詳細については、Envoy 設定変数 を参照してください。

インバウンドトラフィックに関連するメトリクス

  • ActiveConnectionCount

    • envoy.appmesh.ActiveConnectionCount — アクティブなTCP接続の数。

    • ディメンション — メッシュ、 VirtualNode、 VirtualGateway

  • NewConnectionCount

    • envoy.appmesh.NewConnectionCount — TCP接続の合計数。

    • ディメンション — メッシュ、 VirtualNode、 VirtualGateway

  • ProcessedBytes

    • envoy.appmesh.ProcessedBytes — TCP ダウンストリームクライアントとの間で送受信される合計バイト数。

    • ディメンション — メッシュ、 VirtualNode、 VirtualGateway

  • RequestCount

    • envoy.appmesh.RequestCount — 処理されたHTTPリクエストの数。

    • ディメンション — メッシュ、 VirtualNode、 VirtualGateway

  • GrpcRequestCount

    • envoy.appmesh.GrpcRequestCount — 処理された gPRC リクエストの数。

    • ディメンション — メッシュ、 VirtualNode、 VirtualGateway

アウトバウンドトラフィックに関連するメトリクス

アウトバウンドメトリクスは、仮想ノードからのものか仮想ゲートウェイからのものかに基づいて、さまざまなディメンションが表示されます。

  • TargetProcessedBytes

    • envoy.appmesh.TargetProcessedBytes — Envoy TCP の上流のターゲットとの間で送受信される合計バイト数。

    • ディメンション:

      • 仮想ノードディメンション — メッシュ、 VirtualNode、 TargetVirtualService、 TargetVirtualNode

      • 仮想ゲートウェイのディメンション — メッシュ、 VirtualGateway、 TargetVirtualService、 TargetVirtualNode

  • HTTPCode_Target_2XX_Count

    • envoy.appmesh.HTTPCode_Target_2XX_Count — Envoy のターゲットアップストリームへのHTTPリクエストのうち、2xx HTTPレスポンスをもたらしたリクエストの数。

    • ディメンション:

      • 仮想ノードディメンション — メッシュ、 VirtualNode、 TargetVirtualService、 TargetVirtualNode

      • 仮想ゲートウェイのディメンション — メッシュ、 VirtualGateway、 TargetVirtualService、 TargetVirtualNode

  • HTTPCode_Target_3XX_Count

    • envoy.appmesh.HTTPCode_Target_3XX_Count — Envoy のターゲットアップストリームへのHTTPリクエストのうち、3xx HTTPレスポンスが発生したリクエストの数。

    • ディメンション:

      • 仮想ノードディメンション — メッシュ、 VirtualNode、 TargetVirtualService、 TargetVirtualNode

      • 仮想ゲートウェイのディメンション — メッシュ、 VirtualGateway、 TargetVirtualService、 TargetVirtualNode

  • HTTPCode_Target_4XX_Count

    • envoy.appmesh.HTTPCode_Target_4XX_Count — Envoy のターゲットアップストリームへのHTTPリクエストのうち、4xx HTTPレスポンスが発生したリクエストの数。

    • ディメンション:

      • 仮想ノードディメンション — メッシュ、 VirtualNode、 TargetVirtualService、 TargetVirtualNode

      • 仮想ゲートウェイのディメンション — メッシュ、 VirtualGateway、 TargetVirtualService、 TargetVirtualNode

  • HTTPCode_Target_5XX_Count

    • envoy.appmesh.HTTPCode_Target_5XX_Count — Envoy のターゲットアップストリームへのHTTPリクエストのうち、5xx HTTPレスポンスをもたらしたリクエストの数。

    • ディメンション:

      • 仮想ノードディメンション — メッシュ、 VirtualNode、 TargetVirtualService、 TargetVirtualNode

      • 仮想ゲートウェイのディメンション — メッシュ、 VirtualGateway、 TargetVirtualService、 TargetVirtualNode

  • RequestCountPerTarget

    • envoy.appmesh.RequestCountPerTarget — Envoy のアップストリームターゲットに送信されたリクエストの数。

    • ディメンション:

      • 仮想ノードディメンション — メッシュ、 VirtualNode、 TargetVirtualService、 TargetVirtualNode

      • 仮想ゲートウェイのディメンション — メッシュ、 VirtualGateway、 TargetVirtualService、 TargetVirtualNode

  • TargetResponseTime

    • envoy.appmesh.TargetResponseTime — Envoy のアップストリームターゲットに対してリクエストが行われた時点から完全なレスポンスが受信されるまでの経過時間。

    • ディメンション:

      • 仮想ノードディメンション — メッシュ、 VirtualNode、 TargetVirtualService、 TargetVirtualNode

      • 仮想ゲートウェイのディメンション — メッシュ、 VirtualGateway、 TargetVirtualService、 TargetVirtualNode

App Mesh の Datadog

重要

サポート終了通知: 2026 年 9 月 30 日、 は のサポートを中止 AWS します AWS App Mesh。2026 年 9 月 30 日以降、 AWS App Mesh コンソールまたは AWS App Mesh リソースにアクセスできなくなります。詳細については、このブログ記事の「 から Amazon ECS Service Connect AWS App Mesh への移行」を参照してください。

Datadog は、クラウドアプリケーションのエンドツーエンドの監視、メトリクス、およびログ記録のための監視およびセキュリティアプリケーションです。Datadog は、インフラストラクチャ、アプリケーション、およびサードパーティアプリケーションを完全に監視できるようにします。

Datadog のインストール

  • EKS - Datadog を でセットアップするにはEKS、Datadog ドキュメント の以下のステップに従います。

  • ECS EC2 - Datadog を ECS でセットアップするにはEC2、Datadog ドキュメント の以下のステップに従います。

Datadog の詳細について