翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# 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)」を参照してください。
このトピックでは、App Mesh の観測性で発生する可能性のある一般的な問題を詳細に説明します。
## アプリケーションの AWS X-Ray トレースを表示できない
**症状**
App Mesh のアプリケーションが X-Ray コンソールまたは API に X-Ray トレース情報を表示していません。
**解決策**
App Mesh で X-Ray を使用するには、アプリケーション、サイドカーコンテナ、および X-Ray サービス間の通信を有効にするようにコンポーネントを正しく設定する必要があります。次の手順を実行して、X-Ray が正しく設定されていることを確認します。
+ App Mesh 仮想ノードリスナーのプロトコルが `TCP` に設定されていないことを確認します。
+ アプリケーションとともにデプロイされた X-Ray コンテナが UDP ポート `2000` を公開し、ユーザー `1337` として実行されることを確認します。詳細については、GitHub の「[Amazon ECS X-Ray の例](https://github.com/aws/aws-app-mesh-examples/blob/main/walkthroughs/howto-ecs-basics/deploy/2-meshify.yaml#L374-L386)」を参照してください。
+ Envoy コンテナでトレースが有効になっていることを確認します。[App Mesh Envoy イメージ](envoy.md)を使用している場合、`ENABLE_ENVOY_XRAY_TRACING` 環境変数を `1` の値に設定し、`XRAY_DAEMON_PORT` 環境変数を `2000` に設定することで、X-Ray を有効にできます。
+ [言語固有の SDK](https://docs.aws.amazon.com/xray/index.html) の1つを使用してアプリケーションコードに X-Ray を実装した場合は、言語のガイドに従って、正しく設定されていることを確認してください。
+ 前の項目がすべて正しく設定されている場合は、X-Ray コンテナのログでエラーがないか確認し、[AWS X-Rayのトラブルシューティング](https://docs.aws.amazon.com/xray/latest/devguide/xray-troubleshooting.html)のガイダンスに従ってください。App Mesh での X-Ray 統合に関するより詳細な説明は、「[X-Ray と App Mesh 統合](https://aws.amazon.com/blogs/compute/integrating-aws-x-ray-with-aws-app-mesh/)」を参照してください。
それでも問題が解決しない場合は、[GitHub issue](https://github.com/aws/aws-app-mesh-roadmap/issues/new?assignees=&labels=Bug&template=issue--bug-report.md&title=Bug%3A+describe+bug+here) のオープンを検討するか、[AWS Support](https://aws.amazon.com/premiumsupport/) にお問い合わせください。
## Amazon CloudWatch メトリクスでは、自分のアプリケーションの Envoy メトリクスを表示できません
**症状**
App Mesh 内のアプリケーションは、Envoy プロキシによって生成されたメトリクスを CloudWatch メトリクスに送信していません。
**解決策**
App Mesh で CloudWatch メトリクスを使用する場合は、Envoy プロキシ、CloudWatch エージェントのサイドカー、CloudWatch メトリクスサービス間の通信を有効にするために、いくつかのコンポーネントを正しく設定する必要があります。次の手順を実行して、Envoy プロキシの CloudWatch メトリクスが正しく設定されていることを確認してください。
+ App Mesh に CloudWatch エージェントイメージを使用していることを確認てください。詳細については、GitHub の「[App Mesh CloudWatch エージェント](https://github.com/aws-samples/aws-app-mesh-cloudwatch-agent)」を参照してください。
+ プラットフォーム固有の使用手順に従って、CloudWatch エージェントが App Mesh 用に適切に設定されていることを確認してください。詳細については、GitHub の「[App Mesh CloudWatch エージェント](https://github.com/aws-samples/aws-app-mesh-cloudwatch-agent#usage)」を参照してください。
+ 前の項目がすべて正しく設定されている場合は、CloudWatch エージェントのコンテナログでエラーがないか確認し、「[CloudWatch エージェントのトラブルシューティング](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/troubleshooting-CloudWatch-Agent.html)」に記載されているガイダンスに従ってください。。
それでも問題が解決しない場合は、[GitHub issue](https://github.com/aws/aws-app-mesh-roadmap/issues/new?assignees=&labels=Bug&template=issue--bug-report.md&title=Bug%3A+describe+bug+here) のオープンを検討するか、[AWS Support](https://aws.amazon.com/premiumsupport/) にお問い合わせください。
## AWS X-Ray トレースのカスタムサンプリングルールを設定できない
**症状**
アプリケーションで X-Ray トレースを使用していますが、トレースのサンプリングルールを設定できません。
**解決策**
App Mesh Envoy では、現在、**X-Ray の動的サンプリングの設定**がサポートされていないため、次の回避策を利用できます。
Envoy のバージョンが `1.19.1` 以降の場合は、次のオプションがあります。
+ サンプリングレートのみを設定するには、Envoy コンテナで `XRAY_SAMPLING_RATE` 環境変数を使用します。値は、 `0` と `1.00` (100％) の間の10進数で指定する必要があります。詳細については、「[AWS X-Ray 変数](envoy-config.md#envoy-xray-config)」を参照してください。
+ X-Ray トレーサのローカライズされたカスタムサンプリングルールを設定するには、`XRAY_SAMPLING_RULE_MANIFEST` 環境変数を使用して、Envoy コンテナファイルシステムのファイルパスを指定します。詳細については、「*AWS X-Ray デベロッパーガイド*」の「[サンプリングルール](https://docs.aws.amazon.com/xray/latest/devguide/xray-sdk-go-configuration.html#xray-sdk-go-configuration-sampling)」を参照してください。
Envoyのバージョンが `1.19.1` 以前の場合は、次を実行します。
+ `ENVOY_TRACING_CFG_FILE` 環境変数を使用して、サンプリングレートを変更します。詳細については、「[Envoy 設定変数](envoy-config.md)」を参照してください。カスタムトレース設定を指定し、ローカルサンプリングルールを定義します。詳細については、「[Envoy X-Ray Config](https://www.envoyproxy.io/docs/envoy/latest/api-v3/config/trace/v3/xray.proto.html#config-trace-v3-xrayconfig)」を参照してください。
+ `ENVOY_TRACING_CFG_FILE` 環境変数のカスタムトレース設定の例：
```
tracing:
http:
name: envoy.tracers.xray
typedConfig:
"@type": type.googleapis.com/envoy.config.trace.v3.XRayConfig
segmentName: foo/bar
segmentFields:
origin: AWS::AppMesh::Proxy
aws:
app_mesh:
mesh_name: foo
virtual_node_name: bar
daemonEndpoint:
protocol: UDP
address: 127.0.0.1
portValue: 2000
samplingRuleManifest:
filename: /tmp/sampling-rules.json
```
+ `samplingRuleManifest`プロパティのサンプリングルールのマニフェスト設定の詳細については、「[X-Ray SDK for Go の設定](https://docs.aws.amazon.com/xray/latest/devguide/xray-sdk-go-configuration.html#xray-sdk-go-configuration-sampling)」を参照してください。
それでも問題が解決しない場合は、[GitHub issue](https://github.com/aws/aws-app-mesh-roadmap/issues/new?assignees=&labels=Bug&template=issue--bug-report.md&title=Bug%3A+describe+bug+here) のオープンを検討するか、[AWS Support](https://aws.amazon.com/premiumsupport/) にお問い合わせください。