AWS Elastic Beanstalk

コンテナなしのセットアップの場合、コンフィギュレーションファイル (.ebextensions) による高度な環境のカスタマイズ を使用して、Datadog Agent を Elastic Beanstalk にインストールします。

1. アプリケーションソースバンドル のルートに .ebextensions という名前のフォルダーを作成します。
2. 99datadog.config をダウンロードし、.ebextensions フォルダに入れます。
3. /etc/datadog-agent/datadog.yaml のファイルテンプレート内の api_key の値を、お使いの Datadog API キー で変更します。
4. Agent が正しい Datadog ロケーションにデータを送信するために、/etc/datadog-agent/datadog.yaml の site の値を Datadog リージョンに変更します (例: {{< region-param key=“dd_site” code=“true” >}})。
5. すべてのホストが同じバージョンの Agent を実行するように、option_settings の下に DD_AGENT_VERSION を設定して特定の Agent バージョンを固定します。
6. Elastic Beanstalk コンソール 、EB CLI 、または AWS CLI でアプリケーションをデプロイします。

Agent の設定は /etc/datadog-agent/datadog.yaml に追加することができます。

例えば、ライブプロセスモニタリングを有効にするには

process_config:
  enabled: "true"

トレースの収集

アプリケーションがコンテナ化されておらず、Datadog Agent が 99datadog.config で構成されているとき、アプリケーションがトレーシングライブラリセットアップ でインスツルメントされている場合は、追加のコンフィギュレーションなしでトレーシングが有効になります。

コンテナなしのセットアップの場合、コンフィギュレーションファイル (.ebextensions) による高度な環境のカスタマイズ を使用して、Datadog Agent を Elastic Beanstalk にインストールします。

1. アプリケーションソースバンドル のルートに .ebextensions という名前のフォルダーを作成します。
2. 99datadog-windows.config をダウンロードし、.ebextensions フォルダに移動します。
3. 99datadog-windows.config で、APIKEY の値を Datadog API キー に置き換えます。
4. (オプション) 99datadog-windows.config ファイルは、トレースを生成するために .NET APM トレースライブラリを追加します。APM を有効にしない場合は、packagesセクション、02_setup-APM1セクション、03_setup-APM2 セクションを削除します。
5. (オプション) 環境変数を追加する必要がある場合は、99datadog-windows.config の 00_setup-env1 セクションで環境変数を設定します。環境変数を設定する必要がない場合は、このセクションを削除してもかまいません。
6. Elastic Beanstalk コンソール 、EB CLI 、または AWS CLI でアプリケーションをデプロイします。

トレースの収集

アプリケーションがコンテナ化されておらず、Datadog Agent が 99datadog-windows.config で構成されているとき、追加のコンフィギュレーションなしでトレーシングが有効になります。トレーシングのインスツルメンテーションについては、Datadog APM のセットアップ を参照してください。

単一の Docker コンテナのセットアップの場合、コンフィギュレーションファイル (.ebextensions) による高度な環境のカスタマイズ を使用して、Datadog Agent を Elastic Beanstalk にインストールします。

注: このセットアップでは、API キーをソースコードの一部である .ebextensions ディレクトリに配置する必要があります。AWS Secret Manager などのシークレット管理ツールを用いて、API キーを保護してください。

1. アプリケーションソースバンドル のルートに .ebextensions という名前のフォルダーを作成します。
2. 99datadog.config をダウンロードし、.ebextensions フォルダに入れます。
3. /etc/datadog-agent/datadog.yaml のファイルテンプレート内の api_key の値を、お使いの Datadog API キー で変更します。
4. Agent が正しい Datadog ロケーションにデータを送信するために、/etc/datadog-agent/datadog.yaml の site の値を Datadog リージョンに変更します (例: {{< region-param key=“dd_site” code=“true” >}})。
5. すべてのホストが同じバージョンの Agent を実行するように、option_settings の下に DD_AGENT_VERSION を設定して特定の Agent バージョンを固定します。
6. Elastic Beanstalk コンソール 、EB CLI 、または AWS CLI でアプリケーションをデプロイします。

Agent の設定は /etc/datadog-agent/datadog.yaml に追加することができます。

例えば、ライブプロセスモニタリングを有効にするには

process_config:
  enabled: "true"

トレースの収集

単一の Docker コンテナのトレースを有効にするには

1. 99datadog.config ファイルの /etc/datadog-agent/datadog.yaml セクションを apm_non_local_traffic で更新し、次のようなフォーマットにします。

   apm_config:
     enabled: "true"
     apm_non_local_traffic: "true"
   

2. トレーシングライブラリをセットアップして、トレースが ブリッジネットワークの Gateway IP に送られるようにします。アプリケーションコンテナ内からのデフォルトが 172.17.0.1 になります (これが Gateway IP かどうかわからない場合は、docker inspect <container id> を実行して確認します)。

すべての言語で、環境変数 DD_AGENT_HOST をゲートウェイ IP に設定します。または、以下の言語の場合、次を使用してプログラムでホスト名を設定します。

Python

from ddtrace import tracer

tracer.configure(hostname="172.17.0.1")

Node.js

const tracer = require('dd-trace');

tracer.init({ hostname: "172.17.0.1" });

Ruby

require 'ddtrace'

Datadog.configure do |c|
  c.tracer hostname: "172.17.0.1")
end

Go

package main

import (
    "gopkg.in/DataDog/dd-trace-go.v1/ddtrace/tracer"
)

func main() {
  tracer.Start(tracer.WithAgentAddr("172.17.0.1"))
  defer tracer.Stop()

  // ...
}

複数の Docker コンテナの場合、コンテナ化された Datadog Agent を使用して、Dockerrun.aws.json という名前のファイルで Docker の使用状況を監視します。

Dockerrun.aws.json ファイルは Elastic Beanstalk 固有の JSON ファイルで、Docker コンテナセットを Elastic Beanstalk アプリケーションとしてデプロイする方法を記述します。このファイルをマルチコンテナ Docker 環境に使用できます。Dockerrun.aws.json は、環境内の各コンテナインスタンスにデプロイされるコンテナと、マウントするコンテナのホストインスタンス上に作成されるデータボリュームを記述します。

Dockerrun.aws.json ファイルは、単独で使用することも、他のソースコードと共にアーカイブに圧縮して使用することもできます。Dockerrun.aws.json と共にアーカイブされるソースコードは、コンテナインスタンスにデプロイされ、/var/app/current/ ディレクトリでアクセスできます。構成の volumes セクションを使用して、インスタンスで実行されるコンテナのマウントポイントを提供します。また、埋め込みコンテナ定義の mountPoints セクションを使用して、コンテナからマウントポイントをマウントします。

以下のコードサンプルは、Datadog Agent を宣言する Dockerrun.aws.json を示しています。containerDefinitions セクションを、ご使用の Datadog API キー 、タグ (オプション)、および追加のコンテナ定義で更新してください。必要に応じて、このファイルを上述の追加コンテンツと共に圧縮できます。このファイルの構文の詳細については、マルチコンテナ Docker コンフィギュレーション を参照してください。

注:

• 多くのリソースを使用する場合は、メモリの上限を上げる必要があります。
• すべてのホストが同じ Agent バージョンを実行するようにするには、agent:7 を Docker イメージ の特定のマイナーバージョンに変更することをお勧めします。

{
    "AWSEBDockerrunVersion": 2,
    "volumes": [
        {
            "name": "docker_sock",
            "host": {
                "sourcePath": "/var/run/docker.sock"
            }
        },
        {
            "name": "proc",
            "host": {
                "sourcePath": "/proc/"
            }
        },
        {
            "name": "cgroup",
            "host": {
                "sourcePath": "/cgroup/"
            }
        }
    ],
    "containerDefinitions": [
        {
            "name": "dd-agent",
            "image": "gcr.io/datadoghq/agent:7",
            "environment": [
                {
                    "name": "DD_API_KEY",
                    "value": "<YOUR_DD_API_KEY>"
                },
                {
                    "name": "DD_SITE",
                    "value": "<YOUR_DD_SITE>"
                },
                {
                    "name": "DD_TAGS",
                    "value": "<SIMPLE_TAG>, <KEY:VALUE_TAG>"
                }
            ],
            "memory": 256,
            "mountPoints": [
                {
                    "sourceVolume": "docker_sock",
                    "containerPath": "/var/run/docker.sock",
                    "readOnly": false
                },
                {
                    "sourceVolume": "proc",
                    "containerPath": "/host/proc",
                    "readOnly": true
                },
                {
                    "sourceVolume": "cgroup",
                    "containerPath": "/host/sys/fs/cgroup",
                    "readOnly": true
                }
            ]
        }
    ]
}

環境の作成

コンテナ定義が完了したら、それを Elastic Beanstalk に送信します。具体的な手順については、AWS Elastic Beanstalk ドキュメント内の マルチコンテナ Docker 環境 を参照してください。

DogStatsD

マルチコンテナ Docker 環境 で DogStatsD を使用してアプリケーションコンテナからカスタムメトリクスを収集するには、Dockerrun.aws.json に以下の追加を行います。

1. dd-agent コンテナの下に環境変数 DD_DOGSTATSD_NON_LOCAL_TRAFFIC を追加します。

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

2. アプリケーションコンテナの下に dd-agent コンテナへのリンクを追加します。

   "links": [ "dd-agent:dd-agent"]
   

詳細については、DogStatsD と Docker を参照してください。