翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。 # エクスポートされるメトリクス **重要** サポート終了通知: 2026 年 9 月 30 日、 AWS はサポートを終了します AWS App Mesh。2026 年 9 月 30 日以降、 AWS App Mesh コンソールまたは AWS App Mesh リソースにアクセスできなくなります。詳細については、このブログ記事[「 から Amazon ECS Service Connect AWS App Mesh への移行](https://aws.amazon.com/blogs/containers/migrating-from-aws-app-mesh-to-amazon-ecs-service-connect)」を参照してください。 Envoyは、独自の操作と、インバウンドおよびアウトバウンドトラフィックに関するさまざまなディメンションの両方に関する多くの統計を発行します。Envoy の統計の詳細については、Envoy のドキュメントの「[統計](https://www.envoyproxy.io/docs/envoy/latest/intro/arch_overview/observability/statistics)」を参照してください。これらのメトリクスは、プロキシの管理ポート 上の `/stats` エンドポイントを介して利用可能になります (通常は `9901`)。 `stat` プレフィックスは、単一リスナーを使用しているのか、複数のリスナーを使用しているのかによって異なります。その違いを示す例を以下に示します。 **警告** 単一リスナーを複数のリスナー機能に更新すると、以下の表に示す stat プレフィックスが更新され、重大な変更が発生する可能性があります。 Envoy イメージ `1.22.2.1-prod` 以降を使用することをお勧めします。これにより、Prometheus エンドポイントで類似のメトリクス名を確認できます。 | 単一リスナー (SL)/「ingress」リスナープレフィックスが付いた既存の統計情報 | 複数のリスナー (ML)/「ingress..」リスナープレフィックスが付いた新しい統計情報 | | --- | --- | | `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 のドキュメントの「[統計エンドポイント](https://www.envoyproxy.io/docs/envoy/latest/operations/admin#get--stats)」を参照してください。管理者インターフェイスの詳細については、「[Envoy プロキシ管理インターフェイスを有効にする](troubleshooting-best-practices.md#ts-bp-enable-proxy-admin-interface)」を参照してください。 ## Amazon EKS での App Mesh の Prometheus **重要** サポート終了通知: 2026 年 9 月 30 日、 AWS はサポートを終了します AWS App Mesh。2026 年 9 月 30 日以降、 AWS App Mesh コンソールまたは AWS App Mesh リソースにアクセスできなくなります。詳細については、このブログ記事[「 から Amazon ECS Service Connect AWS App Mesh への移行](https://aws.amazon.com/blogs/containers/migrating-from-aws-app-mesh-to-amazon-ecs-service-connect)」を参照してください。 Prometheus はオープンソースのシステムモニタリングおよびアラートツールキットです。その機能の 1 つは、他のシステムが使用できるメトリクスを出力するための形式を指定することです。Prometheus の詳細については、Prometheus のドキュメントの「[概要](https://prometheus.io/docs/introduction/overview/)」を参照してください。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..」が付いた新しい統計情報、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..」が付いた新しい統計情報、カスタム 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___self_redirect___` はリスナー固有になります。 + 「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..」が付いた新しい統計情報 ``` 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 ``` 1. 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 の使用方法のチュートリアル + [EKS を使用した App Mesh — 可観測性：Prometheus](https://github.com/aws/aws-app-mesh-examples/blob/main/walkthroughs/eks/o11y-prometheus.md) ### Amazon EKS を使用した Prometheus と Prometheus について詳しく知るには + [Prometheus のドキュメント](https://prometheus.io/docs/introduction/overview/) + **EKS -** [Prometheus を使用したプレーンメトリクスのコントロール](https://docs.aws.amazon.com/eks/latest/userguide/prometheus.html) ## App Mesh の CloudWatch **重要** サポート終了通知: 2026 年 9 月 30 日、 AWS はサポートを終了します AWS App Mesh。2026 年 9 月 30 日以降、 AWS App Mesh コンソールまたは AWS App Mesh リソースにアクセスできなくなります。詳細については、このブログ記事[「 から Amazon ECS Service Connect AWS App Mesh への移行](https://aws.amazon.com/blogs/containers/migrating-from-aws-app-mesh-to-amazon-ecs-service-connect)」を参照してください。 **Amazon EKS から CloudWatch に Envoy 統計を出力します。** CloudWatch エージェントをクラスターにインストールし、プロキシからメトリクスのサブセットを収集するように設定できます。Amazon EKS クラスターをまだ作成していない場合は、GitHub の「[チュートリアル：Amazon EKS を使用した App Mesh](https://github.com/aws/aws-app-mesh-examples/tree/main/walkthroughs/eks)」の手順を使用して作成できます。同じチュートリアルに従って、サンプルアプリケーションをクラスターにインストールできます。 クラスターに適切な IAM アクセス許可を設定し、エージェントをインストールするには、「[Prometheus メトリクスコレクションを持つ CloudWatch エージェントをインストールする](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/ContainerInsights-Prometheus-Setup.html)」の手順に従います。デフォルトのインストールには、Envoy 統計の有用なサブセットを取得する Prometheus スクレイプ設定が含まれています。詳細については、「[App Mesh の Prometheus メトリクス](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/ContainerInsights-Prometheus-metrics.html#ContainerInsights-Prometheus-metrics-appmesh)」を参照してください。。 エージェントが収集するメトリクスを表示するように設定された App Mesh カスタム CloudWatch ダッシュボードを作成するには、「[Prometheus メトリクスの表示](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/ContainerInsights-Prometheus-viewmetrics.html)」チュートリアルの手順に従います。トラフィックが App Mesh アプリケーションに入ると、グラフに対応するメトリクスが入力され始めます。 ### CloudWatch のメトリクスのフィルタ処理 App Mesh [メトリクス拡張機能](https://docs.aws.amazon.com/app-mesh/latest/userguide/metrics.html#metrics-extension)には、メッシュで定義したリソースの動作に関するインサイトを提供する便利なメトリクスのサブセットが用意されています。CloudWatch エージェントでは Prometheus メトリクスのスクレイピングがサポートされているため、Envoy からプルして CloudWatch に送信するメトリクスを選択するためのスクレープ設定を提供できます。 Prometheus を使用してメトリクスをスクレイピングする例については、「[メトリクス拡張機能](https://github.com/aws/aws-app-mesh-examples/tree/main/walkthroughs/howto-metrics-extension-ecs)」チュートリアルを参照してください。 ### CloudWatch の例 CloudWatch の設定例は、[AWS サンプルリポジトリ](https://github.com/aws-samples/aws-app-mesh-cloudwatch-agent)にあります。 ### CloudWatch を使用するためのチュートリアル + [App Mesh チュートリアル](https://www.appmeshworkshop.com/introduction/)の[モニタリングおよびログ記録機能の追加](https://www.appmeshworkshop.com/monitoring/)。 + [EKS を使用した App Mesh — 可観測性：CloudWatch](https://github.com/aws/aws-app-mesh-examples/blob/main/walkthroughs/eks/o11y-cloudwatch.md) + [ECS での App Mesh のメトリクス拡張の使用](https://github.com/aws/aws-app-mesh-examples/tree/main/walkthroughs/howto-metrics-extension-ecs) ## 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 への移行](https://aws.amazon.com/blogs/containers/migrating-from-aws-app-mesh-to-amazon-ecs-service-connect)」を参照してください。 Envoy は、数百のメトリクスをいくつかの異なる次元に分けて生成します。メトリクスは、App Mesh との関連付け方法においては簡単ではありません。仮想サービスの場合、特定の仮想ノードまたは仮想ゲートウェイと通信している仮想サービスを確実に知るメカニズムはありません。 App Mesh メトリクス拡張により、メッシュで実行される Envoy プロキシが強化されます。この機能拡張により、プロキシは、定義したリソースを認識した追加のメトリクスを出力できます。追加のメトリクスのこの小さなサブセットは、App Mesh で定義したリソースの動作をより詳細に把握するのに役立ちます。 App Mesh メトリクス拡張機能を有効にするには、環境変数 `APPMESH_METRIC_EXTENSION_VERSION` を `1` に設定します。 ``` APPMESH_METRIC_EXTENSION_VERSION=1 ``` Envoy 設定変数の詳細については、[Envoy 設定変数](envoy-config.md) を参照してください。 ### インバウンドトラフィックに関連するメトリクス + `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、ターゲット仮想サービス、ターゲット仮想ノード + 仮想ゲートウェイのディメンション — メッシュ、VirtualGateWay、TargetVirtualService、TargetVirtualNode + **`HTTPCode_Target_2XX_Count`** + `envoy.appmesh.HTTPCode_Target_2XX_Count` — 2xx HTTP レスポンスを発生させた、Envoy のアップストリームターゲットへの HTTP リクエストの数。 + *ディメンション*: + 仮想ノードのディメンション — メッシュ、VirtualNode、ターゲット仮想サービス、ターゲット仮想ノード + 仮想ゲートウェイのディメンション — メッシュ、VirtualGateWay、TargetVirtualService、TargetVirtualNode + **`HTTPCode_Target_3XX_Count`** + `envoy.appmesh.HTTPCode_Target_3XX_Count` — 3xx HTTP レスポンスを発生させた、Envoy のアップストリームターゲットへの HTTP リクエストの数。 + *ディメンション*: + 仮想ノードのディメンション — メッシュ、VirtualNode、ターゲット仮想サービス、ターゲット仮想ノード + 仮想ゲートウェイのディメンション — メッシュ、VirtualGateWay、TargetVirtualService、TargetVirtualNode + **`HTTPCode_Target_4XX_Count`** + `envoy.appmesh.HTTPCode_Target_4XX_Count` — 4xx HTTP レスポンスを発生させた、Envoy のアップストリームターゲットへの HTTP リクエストの数。 + *ディメンション*: + 仮想ノードのディメンション — メッシュ、VirtualNode、ターゲット仮想サービス、ターゲット仮想ノード + 仮想ゲートウェイのディメンション — メッシュ、VirtualGateWay、TargetVirtualService、TargetVirtualNode + **`HTTPCode_Target_5XX_Count`** + `envoy.appmesh.HTTPCode_Target_5XX_Count` — 5xx HTTP レスポンスを発生させた、Envoy のアップストリームターゲットへの HTTP リクエストの数。 + *ディメンション*: + 仮想ノードのディメンション — メッシュ、VirtualNode、ターゲット仮想サービス、ターゲット仮想ノード + 仮想ゲートウェイのディメンション — メッシュ、VirtualGateWay、TargetVirtualService、TargetVirtualNode + **`RequestCountPerTarget`** + `envoy.appmesh.RequestCountPerTarget` — Envoy のアップストリームターゲットに送信されたリクエストの数。 + *ディメンション*: + 仮想ノードのディメンション — メッシュ、VirtualNode、ターゲット仮想サービス、ターゲット仮想ノード + 仮想ゲートウェイのディメンション — メッシュ、VirtualGateWay、TargetVirtualService、TargetVirtualNode + **`TargetResponseTime`** + `envoy.appmesh.TargetResponseTime` — Envoy のアップストリームターゲットに対してリクエストが行われた時点から完全なレスポンスが受信されるまでの経過時間。 + *ディメンション*: + 仮想ノードのディメンション — メッシュ、VirtualNode、ターゲット仮想サービス、ターゲット仮想ノード + 仮想ゲートウェイのディメンション — メッシュ、VirtualGateWay、argetVirtualService、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 への移行](https://aws.amazon.com/blogs/containers/migrating-from-aws-app-mesh-to-amazon-ecs-service-connect)」を参照してください。 Datadog は、クラウドアプリケーションのエンドツーエンドの監視、メトリクス、およびログ記録のための監視およびセキュリティアプリケーションです。Datadog は、インフラストラクチャ、アプリケーション、およびサードパーティアプリケーションを完全に監視できるようにします。 ### Datadog のインストール + EKS - EKS で Datadog をセットアップするには、[Datadog のドキュメント](https://docs.datadoghq.com/integrations/amazon_app_mesh/?tab=eks)の手順に従ってください。 + ECS EC2 - ECS EC2 で Datadog をセットアップするには、[Datadog のドキュメント](https://docs.datadoghq.com/integrations/amazon_app_mesh/?tab=ecsec2)の手順に従ってください。 ### Datadog の詳細について + [Datadog のドキュメント](https://docs.datadoghq.com/)