Amazon ECS タグ抽出

概要

Datadog Agent は、タグを作成し、ラベルまたは環境変数に基づいてコンテナが発行するすべてのメトリクス、トレース、ログに割り当てることができます。

すぐに使えるタグ

Agent は、タスク全体またはタスク内の個々のコンテナから送信されるすべてのデータを自動的に検出してタグを付与できます。自動的に付与されるタグの一覧は、Agent の カーディナリティ構成 に依存します。

タグカーディナリティソース
container_name高Docker
container_id高Docker
docker_image低Docker
image_name低Docker
short_image低Docker
image_tag低Docker
ecs_cluster_name低ECS API
ecs_container_name低ECS API
task_arnOrchestratorECS API
task_family低ECS API
task_name低ECS API
task_version低ECS API

統合サービスタグ付け

コンテナ化された環境のベストプラクティスとして、Datadog はタグを付与する際に統合サービスタグ付けを使用することを推奨しています。統合サービスタグ付けでは、env、service、version の 3 つの標準タグを用いて Datadog のテレメトリを連携させます。統合サービスタグ付けの設定方法は、Amazon ECS における統合サービスタグ付けのドキュメントを参照してください。

リソースタグ収集

統合サービスタグ付けを有効にしていない場合は、次の手順を実行して ECS リソースタグを収集します。

  1. Amazon ECS コンテナインスタンスが IAM ロールに関連付けられていることを確認してください。これは、ECS クラスター作成ウィザードで新しいクラスターを作成するときや、オートスケーリンググループで使用するランチコンフィギュレーションで設定できます。

  2. Amazon ECS コンテナインスタンスで使用される IAM ロールを更新し、ecs:ListTagsForResource の権限を付与してください。

  3. datadog-agent-ecs.json ファイル (オリジナルの Amazon Linux AMI を使用している場合は datadog-agent-ecs1.json) を更新し、以下の環境変数を追加することでリソースタグの収集を有効化してください。

        {
      "name": "DD_ECS_COLLECT_RESOURCE_TAGS_EC2",
      "value": "true"
    }

注

  • 必ず IAM ロールが Datadog Agent コンテナのタスクロールではなく、Amazon ECS コンテナインスタンスに関連付けられていることを確認してください。
  • ECS リソースタグは EC2 インスタンスからは収集できますが、AWS Fargate からは収集できません。
  • この機能には、Datadog Agent v6.17+ または v7.17+ が必要です。
  • Agent は、tasks、services、container instances ECS リソースからの ECS タグ収集をサポートします。
  • If AWS tags are not appearing in Datadog, ensure that the tags are applied both to the instance and the corresponding AWS cloud resource.

参考資料

お役に立つドキュメント、リンクや記事:

タグの概要ドキュメント more more Datadog でタグを使用するドキュメント more more データ収集をコンテナのサブセットのみに制限ドキュメント more more