

# 関連するテレメトリで CloudWatch エージェントの使用
<a name="CloudWatch-Agent-RelatedEntities"></a>

CloudWatch に送信されるメトリクスおよびログには、テレメトリを関連付けるオプションのエンティティを含めることができます。エンティティは、[関連情報の探索](ExploreRelated.md)ペインで使用されます。CloudWatch エージェントは、サービス名および環境名を含むエンティティを送信します。

エージェントは、次のデータからサービス名および環境名を選択します。

[**サービス名**]

エージェントは、優先順位で次のオプションからサービス名を選択します。
+ **Application Signals の計測** – エージェントは Application Signals で使用されるサービス名を送信します。サポートされている OpenTelemetry 計測ライブラリで使用される `OTEL_SERVICE_NAME` 環境変数を変更することによって上書きできます。
+ **CloudWatch エージェント設定** – 特定のサービス名を使用するように[エージェントを設定できます](CloudWatch-Agent-configure-related-telemetry.md)。エージェント、プラグイン、メトリクス、ログ、ログファイルのレベルで設定できます。
+ **Kubernetes ワークロード名** – Kubernetes ワークロードの場合、エージェントは次の優先順位で対応するポッドのワークロードの名前を送信します。
  + デプロイ名
  + ReplicaSet 名
  + StatefulSet 名
  + DaemonSet 名
  + CronJob 名
  + ジョブ名
  + ポッド名
  + コンテナ名
+ **インスタンスメタデータからのリソースタグ** – Amazon EC2 ワークロードの場合、エージェントはタグから名前を次の順序で送信します。
  + サービス
  + アプリケーション
  + できます

  エージェントがタグにアクセスするには、[インスタンスメタデータを設定する](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/work-with-tags-in-IMDS.html#allow-access-to-tags-in-IMDS)必要があります。
+ **デフォルト** – その他のサービス名が見つからなかった場合、エージェントは `Unknown` の名前を送信します。

**環境名**

エージェントは、優先順位で次のオプションから環境名を選択します。
+ **Application Signals の計測** — エージェントは Application Signals で使用される環境名を送信します。サポートされている OpenTelemetry 計測ライブラリで使用される `deployment.environment` 環境変数を設定することによって上書きできます。例えば、アプリケーションは環境変数 `OTEL_RESOURCE_ATTRIBUTES=deployment.environment=MyEnvironment` を設定できます。
+ **CloudWatch エージェント設定** – 特定の環境名を使用するように[エージェントを設定](CloudWatch-Agent-configure-related-telemetry.md)できます。エージェント、プラグイン、メトリクス、ログ、ログファイルのレベルで設定できます。
+ **クラスター名とワークスペース** – Amazon EKS の場合は `eks:{{cluster-name}}/{{Namespace}}`。Amazon EC2 で実行されているネイティブ Kubernetes の場合は `k8s:{{cluster-name}}/{{Namespace}}`。
+ **インスタンスメタデータからのリソースタグ** – Amazon EC2 ワークロードの場合、エージェントは `AutoScalingGroup` タグを使用できます。

  エージェントがタグにアクセスするには、[インスタンスメタデータを設定する](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/work-with-tags-in-IMDS.html#allow-access-to-tags-in-IMDS)必要があります。
+ デフォルトでは、Kubernetes を実行していない Amazon EC2 インスタンスは環境名 `ec2:default` を取得します。