

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

# トレース
<a name="tracing"></a>

**重要**  
サポート終了通知: 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)」を参照してください。

**重要**  
トレースを完全に実装するには、アプリケーションを更新する必要があります。  
選択したサービスから利用可能なデータをすべて表示させるには、該当するライブラリを使用してアプリケーションを計測する必要があります。

## AWS X-Ray で App Mesh をモニタリングする
<a name="x-ray"></a>

**重要**  
サポート終了通知: 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)」を参照してください。

AWS X-Ray は、アプリケーションが処理するリクエストから収集されたデータを表示、フィルタリング、インサイトを得るためのツールを提供するサービスです。これらのインサイトは、問題と機会を特定して、アプリを最適化するのに役立ちます。リクエストとレスポンス、およびアプリケーションが他の AWS サービスに対して行うダウンストリームコールに関する詳細情報を表示できます。

X-Ray は App Mesh と統合して、Envoy マイクロサービスを管理します。Envoy からのトレースデータは、コンテナで実行されている X-Ray デーモンに送信されます。

言語に固有の[SDK](https://docs.aws.amazon.com/xray/index.html)ガイドを使用して、アプリケーションコードにX-Ray を実装します。

### App Mesh 使用して X-Ray トレースを有効にする
<a name="enable-x-ray"></a>
+ 

**サービスのタイプに応じて、次のようになります。**
  + **ECS -** Envoy プロキシコンテナ定義で、`ENABLE_ENVOY_XRAY_TRACING`　環境変数に `1` と`XRAY_DAEMON_PORT`環境変数に `2000` を設定します。
  + **EKS -** App Mesh コントローラーの設定で、`--set tracing.enabled=true` と `--set tracing.provider=x-ray` を含めます。
+ X-Ray コンテナで、ポート `2000` を公開し、ユーザー `1337` として実行します。

### X-Ray 例
<a name="x-ray-examples"></a>

Amazon ECS の Envoy コンテナの定義

```
      {
        "name": "envoy",
        "image": "840364872350.dkr.ecr.us-west-2.amazonaws.com/aws-appmesh-envoy:v1.15.1.0-prod",
        "essential": true,
        "environment": [
          {
            "name": "APPMESH_VIRTUAL_NODE_NAME",
            "value": "mesh/myMesh/virtualNode/myNode"
          },
          {
            "name": "ENABLE_ENVOY_XRAY_TRACING",
            "value": "1"
           }
        ],
        "healthCheck": {
          "command": [
            "CMD-SHELL",
            "curl -s http://localhost:9901/server_info | cut -d' ' -f3 | grep -q live"
            ],
           "startPeriod": 10,
           "interval": 5,
           "timeout": 2,
           "retries": 3
      }
```

Amazon EKS 用の App Mesh コントローラーの更新

```
helm upgrade -i appmesh-controller eks/appmesh-controller \
--namespace appmesh-system \
--set region=${AWS_REGION} \
--set serviceAccount.create=false \
--set serviceAccount.name=appmesh-controller \
--set tracing.enabled=true \
--set tracing.provider=x-ray
```

### X-Ray を使用するチュートリアル
<a name="x-ray-walkthrough"></a>
+ [AWS X-Ray によるモニタリング](https://github.com/aws/aws-app-mesh-examples/tree/main/examples/apps/colorapp#monitor-with-aws-x-ray)
+ [Amazon EKS を使用した App Mesh — 可観測性：X-Ray](https://github.com/aws/aws-app-mesh-examples/blob/main/walkthroughs/eks/o11y-xray.md)
+  AWS App Mesh [ワークショップ](https://www.appmeshworkshop.com/introduction/)での [X-Ray による分散トレース](https://www.appmeshworkshop.com/x-ray/) 

### AWS X-Ray の詳細については、「」を参照してください。
<a name="x-ray-learn-more"></a>
+ [AWS X-Ray ドキュメント](https://docs.aws.amazon.com/xray/index.html)

### App Mesh を使用した AWS X-Ray のトラブルシューティング
<a name="x-ray-troubleshooting"></a>
+ [アプリケーションの AWS X-Ray トレースを表示できません。](https://docs.aws.amazon.com/app-mesh/latest/userguide/troubleshoot-observability.html)

## Amazon EKS を使用した AppMesh の Jaeger
<a name="jaeger"></a>

Jaeger はオープンソースで、エンドツーエンドの分散トレースシステムです。ネットワークのプロファイリングやモニタリングに使用できます。Jaeger は、複雑なクラウドネイティブアプリケーションのトラブルシューティングにも役立ちます。

Jaeger をアプリケーションコードに実装するには、Jaeger のドキュメントで言語固有のガイド「[トレースライブラリ](https://www.jaegertracing.io/docs/1.21/client-libraries/)」を参照してください。

### Helm を使用した Jaeger のインストール
<a name="installing-jaeger"></a>

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

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

1. App Mesh Jaeger のインストール

   ```
   helm upgrade -i appmesh-jaeger eks/appmesh-jaeger \
   --namespace appmesh-system
   ```

### Jaeger の例
<a name="jaeger-sample"></a>

次は、`PersistentVolumeClaim` Jaeger 永続的ストレージ作成の例です。

```
helm upgrade -i appmesh-controller eks/appmesh-controller \
--namespace appmesh-system \
--set tracing.enabled=true \
--set tracing.provider=jaeger \
--set tracing.address=appmesh-jaeger.appmesh-system \
--set tracing.port=9411
```

### Jaeger を使用するためのチュートリアル
<a name="jaeger-walkthrough"></a>
+ [EKS を使用したApp Mesh — 可観測性：Jaeger](https://github.com/aws/aws-app-mesh-examples/blob/main/walkthroughs/eks/o11y-jaeger.md)

### Jaeger の詳細を確認する
<a name="jaeger-eks"></a>
+ [Jaeger のドキュメント](https://www.jaegertracing.io/)

## トレースの Datadog
<a name="datadog-tracing"></a>

Datadog は、メトリクスだけでなくトレースにも使用できます。詳細とインストール手順については、[Datadog のドキュメント](https://docs.datadoghq.com/tracing/setup_overview/)のアプリケーション言語に固有のガイドを参照してください。