# 関連するテレメトリの探索
コンピュータシステムは、メトリクスおよびログの両方に加え、それ以上の複雑なシステムを含む大量のテレメトリを生成できます。テレメトリの特定のセットを確認するとき、最初のセットに関連するその他のテレメトリを見つけることは難しい場合があります。問題を見つけてトラブルシューティングするために必要なスキルを習得するには、高度なトレーニングが必要な場合があります。システムは複雑なため、状況を理解するにはさまざまなサービスやリソースのメトリクスやログを確認し、システム間のコンテキストの切り替えおよび移動が必要になる場合があります。
Amazon CloudWatch の **[関連情報の探索]** 機能では、サービスコンソール間で AWS リソース関係、関連メトリクス、ログにアクセスできるため、すべてのスキルレベルのオペレーターがオブザーバビリティおよび効率の向上を実現します。CloudWatch ダッシュボードでアラームや異常、あるいは AWS でメトリクスを確認するとき、ユーザーはシステムの関連リソースのメトリクスおよびログをすばやく検索して表示できます。
CloudWatch は特定のリソースに関連付けられたメトリクスやログを可視化し、**[関連情報の探索]** ペインは、ユーザーが関連するすべてのテレメトリを使用してインフラストラクチャリソースをワークロードに関連付けられるようにすることで、それを拡張します。インフラストラクチャ関連の問題のトラブルシューティングに必要な情報にすばやくアクセスできるようになります。リソースとそれに関連するテレメトリとの関係は、**[関連情報の探索]** ペインで確認できます。**[関連情報の探索]** ペインは、CloudWatch またはリソースやテレメトリを表示するその他の AWS コンソールからアクセスします。
**注記**
CloudWatch クロスアカウントオブザーバビリティでモニターリングアカウントとして設定されたアカウントでは、**[関連情報の探索]** が現在制限されています。リソースが最初に作成および管理されているソースアカウントから **[関連情報の探索]** にアクセスする必要があります。ソースアカウントでは、接続されたリソース間を移動し、関連するログやメトリクスを表示できます。
次のトピックでは、関連するテレメトリの詳細について説明します。
**Topics**
+ [関連するテレメトリとは？](#what-is-related-telemetry)
+ [[関連情報の探索] ペインにアクセスする方法](#access-related-telemetry)
+ [関連するテレメトリの操作](#using-related-telemetry)
+ [トポロジーマップの使用](#using-related-telemetry-map)
+ [特定のリソースの検索](#using-related-telemetry-find)
+ [関連するテレメトリを表示および探索するために必要なアクセス許可と前提条件](#related-telemetry-permissions)
+ [CloudWatch は関連するテレメトリを見つける方法は？](how-does-related-telemetry-work.md)
+ [関連するテレメトリをサポートする AWS サービス](services-with-related-telemetry.md)
+ [CloudWatch に送信されるカスタムテレメトリに関連情報を追加する方法](adding-your-own-related-telemetry.md)
## 関連するテレメトリとは？
関連するテレメトリは、現在のリソースまたはサービスに関連するリソースからのメトリクスおよびログデータです。従来は、単一のロードバランサーに関連するメトリクスやログ、あるいは Amazon EC2 に関連するすべてのテレメトリを確認する場合があります。Amazon CloudWatch の **[関連情報の探索]** 機能は、インタラクティブな*トポロジーマップ*を追加します。マップは特定のリソースのメトリクスやログを見つけることができるリソース中心のビューですが、そのリソースがその他のリソースにどのように接続されているか確認することもできます。
例えば、**[関連情報の探索]** ペインでロードバランサーのテレメトリを確認する場合、そのロードバランサーに関連付けられたメトリクスやログだけではなく、マップにはそのロードバランサーのターゲットグループが表示されます。ターゲットグループを 1 つ選択すると、そのターゲットグループに関連付けられた Amazon EC2 インスタンスが表示されます。このプロセスの各ステップでは、選択したリソースのメトリクスやログを含むテレメトリが表示され、探しているテレメトリをすばやく見つけたり、テレメトリを調べたりして、特定の問題の原因を探すことが容易になります。
## [関連情報の探索] ペインにアクセスする方法
CloudWatch コンソール内では、現在のビューに関連するテレメトリにアクセスする方法が複数あります。例えば、ダッシュボードでグラフを表示して、そのグラフまたはグラフの側面に関連するテレメトリを表示する場合、そのグラフから直接関連データを調べることができます。コンソールのさまざまな場所から、**[関連情報の探索]** メニュー項目を選択するか、コンパスアイコン (![\[Compass icon representing navigation or direction in a user interface.\]](http://docs.aws.amazon.com/ja_jp/AmazonCloudWatch/latest/monitoring/images/compass-icon.png)) を選択して **[関連情報の探索]** ペインを表示できます。
CloudWatch コンソール (およびその他の AWS コンソール) 全体のエントリポイントから探索エクスペリエンスにアクセスできます。
+ **メトリクスナビゲーション** – CloudWatch コンソールの左側のメニューから **[メトリクス]** と **[すべてのメトリクス]** を選択すると、サポートされているサービスまたはメトリクスソースのタイルに、関連するテレメトリを右下隅に表示するコンパスアイコンが表示されます。
+ **メトリクスの凡例** – メトリクスグラフ (CloudWatch またはその他の AWS コンソール) を表示するとき、グラフの凡例にカーソルを合わせると、データに関する情報に加え、関連するテレメトリを表示する **[関連情報の探索]** ボタンも表示されます。
+ **メトリクスデータポイント** – メトリクスグラフを表示するとき、グラフのデータポイントにカーソルを合わせると、メトリクスに関する情報に加え、コンパスアイコンも表示されて関連するテレメトリが表示されます。
+ **メトリクス検索** – CloudWatch でメトリクスを検索するとき、見つかったメトリクス名を選択した場合、ポップアップするメニューから **[関連情報の探索]** を選択でき、関連するテレメトリが表示されます。
+ **コンソールツールバー** – 多くの AWS コンソールページでは、コンソールツールバー (通常はコンソールの右上) に CloudWatch サービスアイコンが表示され、**[関連情報の探索]** ペインを含む CloudWatch ツールが表示されます。
ペインへのアクセス元に応じて、可能であればペインのデフォルトコンテキストに適切なフィルターが表示されます。
## 関連するテレメトリの操作
**[関連情報の探索]** ペインへのエントリポイントのいずれかを選択すると、CloudWatch コンソールの右側に表示されます。このペインでは、システムの*エンティティ*に関連するテレメトリを表示および検索できます。エンティティは Amazon EC2 インスタンスなどのリソース、あるいは構築したアプリケーションなどのサービスです。このペインは最初のページの横に開くため、現在のワークフローを中断せずにペイン内で操作できます。
次の図には、1 つの Amazon EC2 インスタンスおよび関連するエンティティに焦点を当てた **[関連情報の探索]** ペインが示されています。
![\[1 つの Amazon EC2 インスタンスに焦点を当てた [関連情報の探索] ペインおよびその関連エンティティ。\]](http://docs.aws.amazon.com/ja_jp/AmazonCloudWatch/latest/monitoring/images/compass-explore-main.png)
**[関連情報の探索]** ペインの上部には、現在のエンティティおよびその他の関連エンティティのビジュアル*トポロジーマップ* (マップ) があります。現在選択されているエンティティは、ペインの焦点を設定します。エンティティを選択する方法は 2 つあります。
+ [トポロジーマップ](#using-related-telemetry-map) – *マップ*は、現在のエンティティに焦点を当てて視覚的に表示します。関連するエンティティも表示され、相互に関連するリソースおよびサービスのセット内を移動できます。
+ [他のリソースの検索](#using-related-telemetry-find) – **[その他のリソースの検索]** ボタンを使用し、焦点として使用するエンティティをフィルタリングおよび検索できます。
ペインの下部には、現在の焦点エンティティに関するメトリクスやログの自動検索結果が表示されます。
デフォルトでは、焦点は **[関連情報の探索]** ペインにアクセスした場所と一致するエンティティに設定されます。例えば、特定の Amazon EC2 インスタンスのメトリクスに関連付けられたコンパスアイコンをクリックしてアクセスした場合、焦点はその Amazon EC2 インスタンスに設定されます。
Explore **[関連情報の探索]** ペインで焦点の AWS リソースを選択すると、選択したリソースのリソース固有のコンソールに移動できます。例えば、Amazon EC2 インスタンスを選択した場合、**[EC2 コンソールで表示]** リンクを選択し、そのインスタンスを選択した状態で Amazon EC2 コンソールを開くことができます。
焦点を設定すると、メトリクスおよびログが自動的にフィルタリングされ、焦点に関連するテレメトリが表示されます。
+ **メトリクス** – 各メトリクスは、選択した期間のグラフとして表示されます。
CloudWatch のダッシュボードグラフと同様に、グラフにカーソルを合わせるまたは選択し、メトリクスグラフの詳細情報を取得して、CloudWatch メトリクスでの表示を含むオプションを確認できます。CloudWatch での表示を選択すると、リソースや時間範囲を含め、**[関連情報の探索]** ペインと同じ表示コンテキストでメトリクスビューが開きます。
+ **ログパターン** – CloudWatch は焦点リソースに関連付けられたロググループを分析し、それらのログに共通のパターンを表示します。ログパターンの詳細については、「*Amazon CloudWatch Logs ユーザーガイド*」の「[パターン分析](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/CWL_AnalyzeLogData_Patterns.html)」を参照してください。
**[時間範囲の比較]** を選択し、別の時間範囲を選択して 2 つの時間範囲のログを比較できます。
**[Logs Insights で表示]** を選択し、リソース、ロググループ、時間範囲を含め、現在のビューと同じオプションを使用して CloudWatch Logs Insights のログを分析できます。詳細については、*Amazon CloudWatch Logs ユーザーガイド*の「[CloudWatch Logs Insights を使用したログデータの分析](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AnalyzingLogData.html)」を参照してください。
+ **ロググループ** – ログを含む[ロググループ](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/Working-with-log-groups-and-streams.html)が表示されます。
ロググループを選択したら、次のいずれかのアクションを実行できます。
+ **[Live Tail でテーリングを開始]** を選択し、選択したロググループにインジェストされる新しいログイベントのストリーミングリストを表示します。Live Tail セッションは CloudWatch コンソールで開始されます。Live Tail の詳細については、「*Amazon CloudWatch Logs ユーザーガイド*」の「[CloudWatch Logs LiveTail を使用したトラブルシューティング](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/CloudWatchLogs_LiveTail.html)」を参照してください。
+ **[Logs Insights でクエリ]** を選択し、これらのロググループのみを対象とするクエリで Logs Insights を開き、リソースおよび時間範囲を含む現在のコンテキストを適用します。
## トポロジーマップの使用
*トポロジーマップ* (マップ) は、現在の焦点エンティティおよび関連リソースまたはサービスを視覚的に表示するものです。このインタラクティブな視覚化を使用し、さまざまなリソースとサービス間の関連性を確認して、システムのコンポーネント間の関係を調べることができます。例えば、*ロードバランサー*リソースを確認している場合、マップには関連する*ターゲットグループ*リソースが表示されます。ターゲットグループを選択すると、関連するインスタンスが表示されます。接続を視覚化することにより、オペレーターはシステムのさまざまなリソースとサービス間の関係を理解して調べることができます。
マップをドラッグ、ズームイン、ズームアウトすることにより、関連付けられたエンティティを詳しく表示したり、より少ないエンティティに焦点を当てたりすることができます。
ターゲットグループなどの関連付けられたエンティティを選択すると、ペインの焦点が切り替わり、そのエンティティのテレメトリが表示されます。マップは更新されて選択したターゲットグループに焦点を当てて、ロードバランサーやそのターゲットグループで指定された Amazon EC2 インスタンスなど、その他のエンティティへの接続が表示されます。マップのさまざまなエンティティ間を移動すると、ペインの下部にあるメトリクスやログが動的に更新され、新たに選択されたリソースに関連するテレメトリが提供されます。
## 特定のリソースの検索
リソースがトポロジーマップに表示されない場合、**[その他のリソースの検索]** 機能を使用して見つけることができます。タグまたはタイプでリソースをフィルタリングしたら、探しているリソースを選択できます。焦点を当てるリソースを見つけたら、それらのリソースが選択された状態でトポロジーマップに戻され、関連するエンティティおよびテレメトリを参照します。
**注記**
トポロジーマップにリソースが表示されない理由は多数あります。次に例を示します。
現在の焦点エンティティとの関連性がありません。
関連付けられたエンティティまたはテレメトリにアクセスする[アクセス許可](#related-telemetry-permissions)がありません。
[リソースまたはサービス](services-with-related-telemetry.md)が、テレメトリまたは関連するエンティティをサポートしていない可能性があります。
**[その他のリソースを検索]** を使用することにより、現在のマップに直接関連または表示されない可能性のあるリソースを検出して視覚化できます。これにより、インフラストラクチャのすべての関連コンポーネントにアクセスして分析できます。
**「リソースの検索」でリソースを選択します。**
1. CloudWatch コンソールのいずれかの[エントリポイント](#access-related-telemetry)から、**[関連情報の探索]** ペインを開きます。
1. **[リソースの検索]** を選択します。
1. ログまたはメトリクスを表示する時間枠を選択します。
1. **[リソースタイプ]** を選択し、ドロップダウンリストから焦点を当てるリソースのタイプを選択します (例えば、**[EC2 インスタンス]** など)。
1. 必要に応じて、フィルタリングするタグを指定してリソースのセットをフィルタリングします。これを行うには、**[タグでリソースのフィルタリング]** フィルターを選択するか、**[5 タグが見つかりました]** を表記されたラベルを選択します (数字はシステムのタグによって異なります)。これにより、選択するタグのリストが表示されます。
タグを選択したら、リソースのリストは、それらのタグに関連付けられているリソースのみに自動的にフィルタリングされます。
1. 必要に応じて、フィルターに一致するリソースから特定のリソースを 1 つ以上の選択します。
1. **[マップに表示]** を選択し、選択したリソースで **[トポロジーマップ]** に戻ります。
**[メトリクス]** および **[ログ]** のリストは、そのリソースタイプに関連付けられているログおよびメトリクスのみに現在フィルタリングされています。**[メトリクス]** または **[ログ]** タブを選択し、表示したいテレメトリの種類を表示できます。
## 関連するテレメトリを表示および探索するために必要なアクセス許可と前提条件
関連するテレメトリを探索するには、ワークロードからテレメトリを使用してエンティティ情報を取得し、そのデータを表示するために適切なアクセス許可を持っている必要があります。
多くのサービスはエンティティ情報を自動的に送信します。CloudWatch エージェントを使用するワークロードの場合、エージェントの `1.300049.1` バージョン以降であり、正しく設定する必要があります。エージェントの設定の詳細については、「[CloudWatch に送信されるカスタムテレメトリに関連情報を追加する方法](adding-your-own-related-telemetry.md)」を参照してください。Amazon EKS で実行されているワークロードの場合、Amazon CloudWatch Observability EKS アドオンのバージョン `v2.3.1-eksbuild.1` 以降が必要です。このアドオンの詳細については、「[Amazon CloudWatch Observability EKS アドオンのクイックスタート](Container-Insights-setup-EKS-addon.md)」を参照してください。
関連するテレメトリを探索には、特定のアクセス許可でサインインする必要があります。関連するテレメトリを探索することは読み取り専用アクティビティであり、少なくとも CloudWatch への読み取り専用アクセス権が必要です。
テレメトリとエンティティ間の関連付けを表示するために必要なアクセス許可は `logs:ListLogGroupsForEntity`、`logs:ListEntitiesForLogGroup`、`cloudwatch:ListEntitiesForMetric`、`application-signals:ListObservedEntities` です。
次の各 AWS マネージドポリシーでは、CloudWatch コンソールで関連するテレメトリにアクセスするために必要な CloudWatch アクセス許可が提供されます。
+ [CloudWatchFullAccessV2](https://docs.aws.amazon.com/aws-managed-policy/latest/reference/CloudWatchFullAccessV2.html) - CloudWatch へのフルアクセス権を提供します。
+ [CloudWatchReadOnlyAccess](https://docs.aws.amazon.com/aws-managed-policy/latest/reference/CloudWatchReadOnlyAccess.html) - CloudWatch への読み取り専用アクセス権を提供します。
+ [ReadOnlyAccess](https://docs.aws.amazon.com/aws-managed-policy/latest/reference/ReadOnlyAccess.html) - AWS サービスおよびリソースへの読み取り専用アクセス権を提供します。
さらに、CloudWatch が関係を検出して表示するには、少なくともトポロジーマップのリソースへの読み取り専用アクセス権 (`Describe*` および `Get*`) が必要です。
ポリシーを使用してアクセス権を制御する方法の詳細については、「[ポリシーを使用したアクセス権の管理](auth-and-access-control-cw.md#security_iam_access-manage)」を参照してください。
# CloudWatch は関連するテレメトリを見つける方法は？
CloudWatch の **[関連情報の探索]** ペインには、相互に関連するメトリクスやログが表示されますが、その仕組みは？
CloudWatch に送信されるメトリクスおよびログには、関連するオプションの*エンティティ*を含めることができます。通常、エンティティはテレメトリの内容を表します。例えば、CPU 使用率に関するメトリクスは Amazon EC2 インスタンスに関するものであり、そのインスタンスを独自のエンティティとして使用します。**[関連情報の探索]** ペインでそのメトリクスを表示すると、同じインスタンスのその他のテレメトリが表示されます。
**[関連情報の探索]** ペインの*トポロジーマップ* (マップ) には、現在選択されているリソースおよび*関連するリソース*が表示されます。AWS リソースの場合、CloudWatch は関連があると検知しているその他のリソースを自動的に表示します。例えば、Amazon EC2 インスタンスを表示している場合、マップにはインスタンスにアタッチされている Amazon EBS ボリュームも表示されます。ボリュームを選択するとボリュームのテレメトリが表示され、マップが更新されてボリュームに関連するリソースが表示されます。同じ*サービス*の一部であるリソースも表示されます。
テレメトリに関連付けられたエンティティ情報は、Amazon EC2 インスタンスなど、テレメトリが関連付けられているリソースを定義します。ただし、リソースに関するコンテキストデータが含まれることもあります。例えば、Amazon EC2 インスタンスやデータベースなどのリソースを含むウェブサイトアプリケーションがある場合、エンティティ情報にウェブサイトアプリケーションをサービスとして含めることができます。この場合、トポロジーマップにはサービスが関連エンティティとして表示され、選択するとインスタンスおよびデータベースが表示されます。これにより、サービスのすべてのテレメトリを簡単に検索できます。
**注記**
関連するリソースおよびテレメトリを見つけるには、CloudWatch は過去 3 時間以内にエンティティ情報を含むテレメトリを受信している必要があります。
## エンティティデータの提供元はどこですか？
CloudWatch がテレメトリ用のエンティティを取得するため、さまざまな方法があります。
+ AWS サービスから CloudWatch に送信されるほとんどのテレメトリは、リソースに自動的に関連付けられます。サポートされているリソースの完全なリストについては、「[関連するテレメトリをサポートする AWS サービス](services-with-related-telemetry.md)」を参照してください。
+ CloudWatch エージェントは、テレメトリが CloudWatch に送信するエンティティ情報を自動的にテレメトリに追加します。
**注記**
エンティティデータを含めるには、CloudWatch エージェントを最新バージョンに更新する必要がある場合があります。詳細については「[CloudWatch エージェントを使用してメトリクス、ログ、トレースを収集する](Install-CloudWatch-Agent.md)」および「[関連エンティティの CloudWatch エージェントサービスと環境名の設定](CloudWatch-Agent-configure-related-telemetry.md)」を参照してください。
+ 独自のテレメトリを送信するとき、データにエンティティ情報を追加できます。詳細については、「[CloudWatch に送信されるカスタムテレメトリに関連情報を追加する方法](adding-your-own-related-telemetry.md)」を参照してください。
+ CloudWatch は、その他のテレメトリに関連付けられたエンティティ情報 (例えば、エンティティ情報なしで CloudWatch に送信するカスタムテレメトリなど) を認識するために最善を尽くします。
## サービスデータの提供元はどこですか？
インスタンスリソースやアタッチされたボリュームリソースなど、リソース間の自然な接続を認識するだけではなく、CloudWatch は*サービス*ごとにリソースをグループ化することもできます。例えば、サービスはウェブサイトアプリケーションである場合があります。ウェブサーバーを持つ Amazon EC2 インスタンス、ならびにデータベースを持つ別の Amazon EC2 インスタンスは、両方とも同じサービスの一部であり、そのサービスに基づいてトポロジーマップに接続されている可能性があります。
CloudWatch がテレメトリのサービス名を取得する方法はさまざまであり、次のものが含まれます。
+ アプリケーションシグナルまたはオテル計測テレメトリは、サポートされている OpenTelemetry 計測ライブラリで使用される `OTEL_SERVICE_NAME` 環境変数を使用し、サービス名を設定します。
+ CloudWatch エージェント設定では、サービス名を設定できます。詳細については、「[関連エンティティの CloudWatch エージェントサービスと環境名の設定](CloudWatch-Agent-configure-related-telemetry.md)」を参照してください。
+ Kubernetes ワークロードでは、Deployment、ReplicaSet、Pod、Container など、サービス名としてクラスターに対応する名前を使用します。
+ Amazon EC2 ワークロードの場合、サービスはタグ (`service`、`application`、`app` タグ) から取得できます。
**注記**
タグを使用してサービス名を生成するには、まず Amazon EC2 インスタンスの[インスタンスメタデータを設定](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/work-with-tags-in-IMDS.html#allow-access-to-tags-in-IMDS)する必要があります。
+ 独自のテレメトリを送信するとき、データにサービス情報を追加できます。詳細については、「[CloudWatch に送信されるカスタムテレメトリに関連情報を追加する方法](adding-your-own-related-telemetry.md)」を参照してください。
+ 上記のものを使用できないとき、CloudWatch はメトリクスをサービス名として送信する IAM ロールの名前を使用します。例えば、Amazon ECS テレメトリのサービス名を指定できます。
# 関連するテレメトリをサポートする AWS サービス
次の表には、CloudWatch テレメトリで関連するエンティティ情報をサポートする AWS サービスが示されます。表に一覧表示されていないサービスまたはリソースには、CloudWatch で公開されている関連エンティティ情報はありません。
**注記**
[CloudWatch エージェント](Install-CloudWatch-Agent.md)を使用するサービスでは、関連するテレメトリを取得するため、エージェントを最新バージョンに更新する必要がある場合があります。独自のカスタムメトリクスを使用して関連エンティティ情報の送信に関する情報については、「[CloudWatch に送信されるカスタムテレメトリに関連情報を追加する方法](adding-your-own-related-telemetry.md)」を参照してください。
| AWS のサービス | リソース | メトリクス | ログ |
| --- | --- | --- | --- |
| Amazon API Gateway | `AWS::ApiGateway::Method` | あり | なし |
| Amazon API Gateway | `AWS::ApiGateway::Resource` | あり | なし |
| Amazon API Gateway | `AWS::ApiGateway::RestApi` | あり | なし |
| Amazon API Gateway | `AWS::ApiGateway::Stage` | あり | あり |
| Amazon API Gateway | `AWS::ApiGateway::VpcLink` | あり | なし |
| Amazon API Gateway V2 | `AWS::ApiGatewayV2::Integration` | あり | なし |
| Amazon API Gateway V2 | `AWS::ApiGatewayV2::Route` | あり | なし |
| Amazon API Gateway V2 | `AWS::ApiGatewayV2::Stage` | なし | あり |
| Amazon API Gateway V2 | `AWS::ApiGatewayV2::Api` | あり | なし |
| AWS App Runner | `AWS::AppRunner::Service` | なし | あり |
| AWS Application Migration Service | `AWS::MGN::SourceServer` | あり | なし |
| Amazon WorkSpaces Applications | `AWS::AppStream::Fleet` | あり | はい |
| AWS AppSync | `AWS::AppSync::GraphQLApi` | はい | はい |
| AWS B2B Data Interchange | `AWS::B2BI::Transformer` | なし | あり |
| AWS Backup gateway | `AWS::BackupGateway::Hypervisor` | なし | あり |
| Amazon Bedrock | `AWS::Bedrock::KnowledgeBase` | なし | あり |
| Amazon Bedrock | `AWS::Bedrock::ModelId` | あり | なし |
| Amazon Chime | `AWS::Chime::SipMediaApplication` | なし | あり |
| Amazon Chime | `AWS::Chime::VoiceConnector` | なし | あり |
| AWS Clean Rooms | `AWS::CleanRooms::Membership` | なし | あり |
| AWS CloudFormation | | なし | あり |
| AWS CloudFormation フック | | なし | あり |
| Amazon CloudFront | `AWS::CloudFront::Distribution` | あり | あり |
| AWS CloudTrail | `AWS::CloudTrail::EventDataStore` | なし | あり |
| AWS CloudTrail | `AWS::CloudTrail::Trail` | なし | あり |
| Amazon CloudWatch | `AWS::CloudWatch::MetricStream` | あり | なし |
| Amazon CloudWatch Logs | `AWS::Logs::LogGroup` | あり | なし |
| Amazon CloudWatch RUM | `AWS::RUM::AppMonitor` | なし | あり |
| Amazon CloudWatch Synthetics | `AWS::Synthetics::Canary` | あり | なし |
| AWS CodeBuild | `AWS::CodeBuild::Project` | あり | なし |
| Amazon CodeWhisperer | `AWS::CodeWhisperer::Customization` | なし | あり |
| Amazon Cognito ユーザープール | `AWS::Cognito::UserPool` | あり | あり |
| AWS Config | `AWS::Config::ConfigRule` | なし | あり |
| Amazon Connect | `AWS::Connect::Instance` | なし | あり |
| AWS Database Migration Service | `AWS::DMS::ReplicationInstance` | あり | なし |
| AWS Database Migration Service | `AWS::DMS::ReplicationTask` | あり | なし |
| AWS DataSync | `AWS::Datasync::Agent` | あり | なし |
| AWS DataSync | `AWS::DataSync::Task` | あり | あり |
| AWS Directory Service | `AWS::DirectoryService::MicrosoftAD` | なし | あり |
| Amazon DynamoDB | `AWS::DynamoDB::Table` | あり | なし |
| DynamoDB Accelerator | `AWS::DAX::Cluster` | あり | なし |
| Amazon EC2 | `AWS::EC2::CapacityReservation` | あり | なし |
| Amazon EC2 | `AWS::EC2::Instance` | あり | なし |
| Amazon EC2 | `AWS::EC2::FlowLog` | あり | なし |
| Amazon EC2 | `AWS::EC2::NATGateway` | あり | なし |
| Amazon EC2 | `AWS::EC2::NetworkInterface` | あり | あり |
| Amazon EC2 | `AWS::EC2::Subnet` | あり | あり |
| Amazon EC2 | `AWS::EC2::TransitGateway` | あり | なし |
| Amazon EC2 | `AWS::EC2::TransitGatewayAttachment` | あり | あり |
| Amazon EC2 | `AWS::EC2::VerifiedAccessInstance` | なし | あり |
| Amazon EC2 | `AWS::EC2::Volume` | あり | なし |
| Amazon EC2 | `AWS::EC2::VPC` | なし | あり |
| Amazon EC2 | `AWS::EC2::VPNConnection` | あり | あり |
| Amazon EC2 Auto Scaling (日本語) | `AWS::AutoScaling::AutoScalingGroup` | あり | なし |
| AWS Elastic Beanstalk | `AWS::ElasticBeanstalk::Environment` | あり | なし |
| Amazon Elastic Container Service | `AWS::ECS::Cluster` | あり | あり |
| Amazon Elastic Container Service | `AWS::ECS::Service` | あり | はい |
| Amazon Elastic File System | `AWS::EFS::AccessPoint` | はい | なし |
| Amazon Elastic File System | `AWS::EFS::FileSystem` | はい | なし |
| Amazon Elastic File System | `AWS::EFS::MountTarget` | はい | なし |
| Amazon Elastic Kubernetes Service | `AWS::EKS::Cluster` | はい | はい |
| AWS Fargate の Amazon Elastic Kubernetes Service | | なし | はい |
| Elastic Load Balancing | `AWS::ElasticLoadBalancing::LoadBalancer` | はい | なし |
| Elastic Load Balancing V2 | `AWS::ElasticLoadBalancingV2::LoadBalancer` | はい | なし |
| Elastic Load Balancing V2 | `AWS::ElasticLoadBalancingV2::TargetGroup` | はい | なし |
| Amazon ElastiCache | `AWS::ElastiCache::CacheCluster` | はい | はい |
| AWS Elemental MediaConvert | `AWS::MediaConvert::Queue` | あり | なし |
| AWS Elemental MediaLive | | なし | あり |
| AWS Elemental MediaLive | `AWS::MediaLive::Channel` | あり | なし |
| AWS Elemental MediaPackage | `AWS::MediaPackage::Channel` | あり | なし |
| AWS Elemental MediaStore | `AWS::MediaStore::Container` | あり | あり |
| AWS Elemental MediaTailor | | なし | あり |
| Amazon EMR | `AWS::EMR::Cluster` | あり | あり |
| Amazon EventBridge | `AWS::Events::Rule` | はい | はい |
| Amazon EventBridge Pipes | `AWS::Pipes::Pipe` | はい | あり |
| AWS Fault Injection Service | `AWS::FIS::ExperimentTemplate` | なし | あり |
| Amazon FinSpace | `AWS::FinSpace::Environment` | なし | あり |
| Amazon FSx | `AWS::FSx::FileSystem` | あり | なし |
| Amazon GameLift サーバー | `AWS::GameLift::Fleet` | あり | なし |
| AWS Glue | `AWS::Glue::Job` | なし | あり |
| AWS Identity Sync | `AWS::IdentitySync::Profile` | なし | あり |
| Amazon Interactive Video Service | `AWS::IVSChat::LoggingConfiguration` | あり | はい |
| AWS IoT | `AWS::IoT::TopicRule` | はい | はい |
| AWS IoT 1-Click | `AWS::IoT1Click::Device` | あり | なし |
| AWS IoT Events | | なし | あり |
| AWS IoT FleetWise | `AWS::IoTFleetWise::Vehicle` | なし | あり |
| AWS IoT SiteWise | | なし | あり |
| AWS Key Management Service | `AWS::KMS::Key` | あり | なし |
| Amazon Managed Service for Apache Flink | `AWS::KinesisAnalytics::Application` | あり | あり |
| Amazon Data Firehose | `AWS::KinesisFirehose::DeliveryStream` | あり | あり |
| Amazon Kinesis Data Streams | `AWS::Kinesis::Stream` | あり | なし |
| Amazon Kinesis Video Streams | `AWS::KinesisVideo::Stream` | あり | なし |
| AWS Lambda | `AWS::Lambda::Function` | あり | なし |
| Amazon Lex | | なし | あり |
| AWS Mainframe Modernization | `AWS::M2::Application` | なし | あり |
| Amazon Managed Streaming for Apache Kafka | `AWS::Kafka::Cluster` | あり | なし |
| Amazon Managed Streaming for Apache Kafka | `AWS::KafkaConnect::Connector` | なし | あり |
| Amazon Managed Streaming for Apache Kafka | `AWS::MSK::Cluster` | あり | あり |
| Amazon MemoryDB | `AWS::Mmemorydb::Cluster` | あり | なし |
| Amazon MQ | `AWS::AmazonMQ::Broker` | あり | はい |
| AWS Network Firewall | `AWS::NetworkFirewall::Firewall` | はい | あり |
| Amazon OpenSearch Service | `AWS::OpenSearchService::Domain` | あり | なし |
| Amazon OpenSearch Service | | なし | あり |
| Amazon OpenSearch Service インジェスト | `AWS::OSIS::Pipeline` | なし | あり |
| AWS Organizations | `AWS::Organizations::Organization` | なし | あり |
| AWS Outposts | `AWS::Outposts::Outpost` | あり | なし |
| Amazon Managed Service for Prometheus | `AWS::Prometheus::Resource` | あり | なし |
| Amazon Q Business | | なし | はい |
| Amazon QLDB | `AWS::QLDB::Ledger` | はい | なし |
| Amazon Quick | `AWS::Quicksight::Dashboard` | はい | なし |
| Amazon Quick | `AWS::Quicksight::DataSet` | はい | なし |
| Amazon Redshift | `AWS::Redshift::Cluster` | はい | はい |
| Amazon Redshift Serverless | `AWS::RedshiftServerless::Workgroup` | はい | なし |
| Amazon Relational Database Service | `AWS::RDS::DBCluster` | はい | はい |
| Amazon Relational Database Service | `AWS::RDS::DBInstance` | はい | あり |
| Amazon Route 53 | `AWS::Route53::HealthCheck` | あり | あり |
| Amazon Route 53 | `AWS::Route53::HostedZone` | あり | なし |
| Amazon Route 53 Resolver | `AWS::Route53Resolver::ResolverEndpoint` | あり | なし |
| Amazon S3 | `AWS::S3::Bucket` | あり | なし |
| Amazon SageMaker AI | `AWS::SageMaker::Endpoint` | あり | なし |
| Amazon SageMaker AI | `AWS::SageMaker::Workteam` | なし | あり |
| AWS Service Catalog | `AWS::ServiceCatalog::CloudFormationProduct` | あり | なし |
| Amazon Simple Email Service | `AWS::SES::ConfigurationSet` | あり | なし |
| Amazon Simple Notification Service | `AWS::SNS::Topic` | あり | あり |
| Amazon Simple Notification Service | | なし | あり |
| Amazon Simple Queue Service | `AWS::SQS::Queue` | あり | なし |
| AWS Step Functions | `AWS::StepFunctions::Activity` | あり | なし |
| AWS Step Functions | `AWS::StepFunctions::StateMachine` | あり | はい |
| AWS Storage Gateway | `AWS::StorageGateway::Gateway` | あり | なし |
| AWS Storage Gateway | `AWS::StorageGateway::Share` | なし | あり |
| AWS Transfer Family | `AWS::Transfer::Server` | はい | はい |
| Amazon VPC Lattice | `AWS::VpcLattice::Service` | なし | あり |
| AWS WAFV2 | `AWS::WAFv2::WebAcl` | なし | あり |
| Amazon WorkMail | `AWS::WorkMail::Organization` | あり | いいえ |
| Amazon WorkSpaces | `AWS::WorkSpaces::Workspace` | あり | あり |
# CloudWatch に送信されるカスタムテレメトリに関連情報を追加する方法
独自のメトリクスおよびログを CloudWatch に公開するとき、関連するテレメトリに必要なエンティティ情報はデフォルトで存在しません。CloudWatch または ログを CloudWatch Logs に送信するとき ([PutMetricData](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_PutMetricData.html) または [PutLogEvents](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutLogEvents.html) 操作で)、それらのログまたはメトリクスにエンティティ情報を追加できます。エンティティ情報はテレメトリに関連付けられて **[関連情報の探索]** 機能で使用され、同じエンティティに関連付けられている関連するテレメトリを検索します。
テレメトリで送信されるエンティティは、テレメトリが関連付けられているリソースまたはサービスを表します。例えば、サービスに関するメトリクス、あるいは AWS リソースから取得されるメトリクスなど。コードに関連付けられたエンティティを識別するには、エンティティの `KeyAttributes` とオプションの `Attributes` のセットを作成します。
**注記**
CloudWatch は、過去 3 時間以内にテレメトリが送信されたエンティティの関連リソースのみを検索できます。リソースのテレメトリ発信頻度が低い (3 時間に 1 回未満) 場合、追加の*ハートビート*テレメトリを送信し、CloudWatch 内でエンティティをアクティブにしておくことができます。
エンティティ情報を追加する方法については、「[EMF 形式のエンティティ情報](CloudWatch_Embedded_Metric_Format_Specification.md#entity-information-emf-format)」を参照してください。
CloudWatch がテレメトリに関連付けられたリソースおよびサービスを識別できるように、次のセクションでは `KeyAttributes` および `Attributes` を作成する方法について説明します。
## KeyAttributes オブジェクトを使用したエンティティの識別
エンティティオブジェクトの ([CloudWatch 内](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_Entity.html) または [CloudWatch ログ内](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_Entity.html)) `KeyAttributes` プロパティは、CloudWatch のエンティティを一意に識別します。これはキーと値のペアのリストです。同じ `KeyAttributes` を持つエンティティは、同じエンティティとして見なされます。同じエンティティに関連付けられたテレメトリは関連性があると見なされ、**[関連情報の探索]** ペインで簡単に見つけることができます。
**注記**
CloudWatch API では、プロパティは `KeyAttributes` と呼ばれます。CloudWatch Logs API では、プロパティは `keyAttributes` と呼ばれます。ここでは、同じプロパティとして扱われます。
`Entity` が表すことができるオブジェクトには、5 つのタイプがあります。
+ **AWS::Resource** – エンティティは、DynamoDB テーブルや Amazon EC2 インスタンスなどの AWS リソースを表します。
+ **AWS::Service** – エンティティは Amazon S3 などの AWS サービスを表します。例えば、特定の Amazon S3 リソースに関連付けられていない `ListBuckets` オペレーションを呼び出すときに使用される場合があります。
+ **サービス** – エンティティは、アカウントで実行されているワークロードを表します。例えば、管理するアプリケーションまたはサービスなどです。
+ **リソース** – エンティティは、AWS によって管理されていないリソースを表します (例えば、プロセスやファイルボリュームなどのオペレーティングシステムリソースなど)。
+ **RemoteService** – エンティティは、リモート呼び出しの外部サービスを表します。例えば、データベース、外部キャッシュ、外部エンドポイントへのリモート呼び出しなど。
上記のタイプのうち、表しているタイプによっては、`KeyAttributes` に正しいキーと値のペアを指定する必要があります。次の内容は、各タイプについて説明します。
------
#### [ AWS::Resource ]
AWS リソースを指定するには、次の 3 つのキーと値のペアを含める必要があります。
+ `"Type": "AWS::Resource"` – このキーと値のペアは、エンティティを AWS リソースとして識別します。
+ `"ResourceType": ""` – `ResourceType` の文字列値は CloudFormation [リソースタイプ](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-template-resource-type-ref.html)の文字列です。例えば、`AWS::DynamoDB::Table`。
+ `"Identifier": ""` – リソースのプライマリ識別子。詳細については、「*CloudFormation ユーザーガイドの拡張機能開発*」の「[primaryIdentifier](https://docs.aws.amazon.com/cloudformation-cli/latest/userguide/resource-type-schema.html#schema-properties-primaryidentifier)」を参照してください。
------
#### [ AWS::Service ]
AWS サービスを指定するには、次の 2 つのキーと値のペアを含める必要があります。
+ `"Type": "AWS::Service"` – このキーと値のペアは、エンティティを AWS サービスとして識別します。
+ `"Name": ""` – `Name` の値は CloudFormation [サービス名](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-template-resource-type-ref.html)の文字列です。例えば、`AWS::DynamoDB`。
------
#### [ Service ]
AWS によって運用されていないサービスを指定するには、次の 3 つのキーと値のペアを含める必要があります。
+ `"Type": "Service"` – このキーと値のペアは、エンティティをサービスとして識別します。
+ `"Name": ""` – メトリクスを送信しているサービスの名前を表します。例えば、`my-service-frontend`、`api.myservice.com` です。
+ `"Environment": ""` – この属性はサービスがホストされている場所、あるいはサービスが属する環境を指定します。例えば、`us-west-2` または `myservice.production` など。
------
#### [ Resource ]
AWS によって提供されていないリソースを指定するには、次の 3 つのキーと値のペアを含める必要があります。
+ `"Type": "Resource"` – このキーと値のペアは、エンティティをリソースとして識別します。
+ `"ResourceType": ""` – リソースのタイプを指定する文字列。例えば、Kubernetes ポッドの `K8s::Pod`。
+ `"Identifier": ""` - リソースの文字列識別子。複数の名前を含めて、パイプ文字で区切ることができます。例えば、Kubernetes ポッドは、クラスター名、名前空間、ポッド名 (`MyCluster|MyNamespace|MyPod` など) で表される場合があります。
------
#### [ RemoteService ]
リモートサービスを指定するには、次の 2 つのキーと値のペアを含める必要があります。
+ `"Type": "RemoteService"` – このキーと値のペアは、エンティティをリモートサービスとして識別します。
+ `"Name": ""` – リモート呼び出しでアプリケーションが外部サービスを参照する方法を指定します。例えば、`api.test.myservice.com`。
------
## 属性オブジェクトの使用によるエンティティに関する追加の詳細の提供
テレメトリで提供する `Entity` に関する追加の詳細を指定できます。プラットフォーム、リソース、アプリケーション、テレメトリプロバイダの詳細を含めることができます。次の表には、これらの各タイプのデータに使用できるキーワードが示されています。
**注記**
CloudWatch API では、プロパティは `Attributes` と呼ばれます。CloudWatch Logs API では、プロパティは `attributes` と呼ばれます。ここでは、同じプロパティとして扱われます。
**プラットフォームの詳細**
| キーワード | 使用方法 | 値のドメイン | 例 |
| --- | --- | --- | --- |
| `PlatformType` | ホストされたプラットフォームを定義します。 | AWS::EKS、AWS::ECS、AWS::EC2、AWS::Lambda、K8s、Generic | `AWS::EC2` |
| `EKS.Cluster` | Amazon EKS クラスターの名前。 | 基本的な区切り文字を含む英数字の文字列。 | `FlyingSquad` |
| `K8s.Cluster` | セルフホスト型 Kubernetes クラスターの名前。 | 基本的な区切り文字を含む英数字の文字列。 | `minicube` |
| `K8s.Namespace` | Amazon EKS または K8s クラスターの Kubernetes 名前空間の名前。 | 基本的な区切り文字を含む英数字の文字列。 | `default`, `pet-clinic` |
| `K8s.Workload` | Amazon EKS および K8s クラスターの Kubernetes ワークロードの名前。 | 基本的な区切り文字を含む英数字の文字列。 | `frontend` |
| `K8s.Node` | Amazon EKS および K8s クラスターの Kubernetes ノードの ID。 | K8s ノード名 (例えば、Amazon EC2 インスタンスの DNS 名など)。 | `ip-11-22-33-44.ec2.internal` |
| `K8s.Pod` | Amazon EKS および K8s クラスターの Kubernetes ポッドの ID。 | K8s ポッド識別子。 | `frontend-1234abcd56-ef7890` |
| `EC2.AutoScalingGroup` | Amazon EC2 AutoScaling グループの名前。 | 基本的な区切り文字を含む英数字の文字列。 | `my-asg-name-1` |
| `EC2.InstanceId` | Amazon EC2 インスタンスの ID。 | Amazon EC2 インスタンス識別子。 | `i-1234abcd5678ef90` |
| `ECS.Cluster` | Amazon ECS クラスターの ID。 | Amazon ECS クラスター名。 | `MyCluster` |
| `ECS.Service` | Amazon ECS サービスの ID。 | Amazon ECS サービス名。 | `MyService` |
| `ECS.Task` | Amazon ECS タスクの ID。 | Amazon ECS タスク ID。 | `task-123abc` |
| `Lambda.Function` | Lambda 関数の ID。 | Lambda 関数の名前。 | `MyFunction` |
| `Host` | すべてのプラットフォームタイプにおけるホストの名前。 | サブドメイン形式。 | `ip-111-22-33-44.example.com` |
**リソースの詳細**
| キーワード | 使用方法 | 値のドメイン | 例 |
| --- | --- | --- | --- |
| `AWS.Resource.ARN` | AWS リソースの ARN。 | 基本的な区切り文字を含む英数字の文字列。 | `arn:aws:dynamodb:us-east-1:123456789012:table/myDynamoDBTable` |
**アプリケーションの詳細**
| キーワード | 使用方法 | 値のドメイン | 例 |
| --- | --- | --- | --- |
| `AWS.Application` | AppRegistry のアプリケーションの名前。 | 基本的な区切り文字を含む英数字の文字列。 | `PetClinicApp` |
| `AWS.Application.ARN` | AppRegistry のアプリケーションの ARN。 | 基本的な区切り文字を含む英数字の文字列。 | `arn:aws:servicecatalog:us-east-1:1234567890:/applications/...` |
**テレメトリプロバイダーの詳細**
| キーワード | 使用方法 | 値のドメイン | 例 |
| --- | --- | --- | --- |
| `Telemetry.SDK` | 計測されたサービスの OTEL SDK バージョンのフィンガープリント。 | 基本的な区切り文字を含む英数字の文字列。 | `opentelemetry,1.32.0-aws-SNAPSHOT,java,Auto` |
| `Telemetry.Agent` | テレメトリデータの収集および送信に使用されるエージェントのフィンガープリント。 | 基本的な区切り文字を含む英数字の文字列。 | `CWAgent/1.300026.3, ADOTCollector/1.x` |
| `Telemetry.Source` | テレメトリが収集されたアプリケーションポイント、あるいはテレメトリデータのソースに使用されたものを指定します。 | ServerSpan、ClientSpan、ProducerSpan、ConsumerSpan、LocalRoot Span、JMX、OS。 | `ClientSpan, JMX` |