Ubuntu ホストの場合

1. 1 行のインストールコマンドを実行します。

   DD_API_KEY=<YOUR_DD_API_KEY> DD_SITE="<YOUR_DD_SITE>" DD_APM_INSTRUMENTATION_ENABLED=host DD_APM_INSTRUMENTATION_LIBRARIES="java:1,python:2,js:5,dotnet:3" DD_ENV=<AGENT_ENV> bash -c "$(curl -L https://install.datadoghq.com/scripts/install_script_agent7.sh)"
   

   <YOUR_DD_API_KEY> をお使いの Datadog API キーに、<YOUR_DD_SITE> をお使いの Datadog サイトに、<AGENT_ENV> を Agent がインストールされる環境 (例: staging) に置き換えてください。

   その他のオプションについては、高度なオプションをご覧ください。

2. 新しいシェルセッションを開始します。

3. ホストまたは VM 上のサービスを再起動します。

Docker Linux コンテナの場合

1. 1 行のインストールコマンドを実行します。

   DD_APM_INSTRUMENTATION_ENABLED=docker DD_APM_INSTRUMENTATION_LIBRARIES="java:1,python:2,js:5,dotnet:3" DD_NO_AGENT_INSTALL=true bash -c "$(curl -L https://install.datadoghq.com/scripts/install_script_agent7.sh)"
   

2. Docker で Agent を構成します。

   docker run -d --name dd-agent \
     -e DD_API_KEY=<YOUR_DD_API_KEY> \
     -e DD_APM_ENABLED=true \
     -e DD_ENV=<AGENT_ENV> \
     -e DD_APM_NON_LOCAL_TRAFFIC=true \
     -e DD_DOGSTATSD_NON_LOCAL_TRAFFIC=true \
     -e DD_APM_RECEIVER_SOCKET=/var/run/datadog/apm.socket \
     -e DD_DOGSTATSD_SOCKET=/var/run/datadog/dsd.socket \
     -v /var/run/datadog:/var/run/datadog \
     -v /var/run/docker.sock:/var/run/docker.sock:ro \
     gcr.io/datadoghq/agent:7
   

   <YOUR_DD_API_KEY> をお使いの Datadog API キーに、<AGENT_ENV> を Agent がインストールされる環境 (例: staging) に置き換えてください。
   その他のオプションについては、高度なオプションをご覧ください。
3. Docker コンテナを再起動します。
4. Datadog でサービスのパフォーマンス可観測性を調べます。

Datadog Agent を以下のいずれかの方法でインストールすることで APM を有効にできます、

• Datadog Operator
• Datadog Helm chart

要件

• Kubernetes v1.20+
• Helm (Datadog Operator をデプロイするため)
• Kubectl CLI (Datadog Agent をインストールするため)

DD_APM_INSTRUMENTATION_LIBRARIES - APM ライブラリのカスタマイズ

DD_APM_INSTRUMENTATION_ENABLED が設定されている場合、デフォルトでは Java、Python、Ruby、Node.js、.NET Core の Datadog APM ライブラリがインストールされます。DD_APM_INSTRUMENTATION_LIBRARIES は、インストールするライブラリを上書きするために使用されます。値は、コロンで区切られたライブラリ名とバージョンのペアをカンマ区切りで並べた文字列です。

DD_APM_INSTRUMENTATION_LIBRARIES の例:

• DD_APM_INSTRUMENTATION_LIBRARIES="java:1" - Java の Datadog APM ライブラリのみを、メジャーバージョン 1 のリリースラインに固定してインストールします。
• DD_APM_INSTRUMENTATION_LIBRARIES="java:1,python:2" - Java と Python の Datadog APM ライブラリのみを、メジャーバージョンをそれぞれ 1 と 2 に固定してインストールします。
• DD_APM_INSTRUMENTATION_LIBRARIES="java:1.38.0,python:2.10.5" - Java と Python の Datadog APM ライブラリのみを、それぞれ特定のバージョン 1.38.0 と 2.10.5 に固定してインストールします。

利用可能なバージョンは、各言語のソースリポジトリに一覧があります。

• Java (java)
• Node.js (js)
• Python (python)
• .NET (dotnet)
• Ruby (ruby)

DD_APM_INSTRUMENTATION_LIBRARIES - APM ライブラリのカスタマイズ

DD_APM_INSTRUMENTATION_ENABLED が設定されている場合、デフォルトでは Java、Python、Ruby、Node.js、.NET Core の Datadog APM ライブラリがインストールされます。DD_APM_INSTRUMENTATION_LIBRARIES は、インストールするライブラリを上書きするために使用されます。値は、コロンで区切られたライブラリ名とバージョンのペアをカンマ区切りで並べた文字列です。

DD_APM_INSTRUMENTATION_LIBRARIES の例:

• DD_APM_INSTRUMENTATION_LIBRARIES="java:1" - Java の Datadog APM ライブラリのみを、メジャーバージョン 1 のリリースラインに固定してインストールします。
• DD_APM_INSTRUMENTATION_LIBRARIES="java:1,python:2" - Java と Python の Datadog APM ライブラリのみを、メジャーバージョンをそれぞれ 1 と 2 に固定してインストールします。
• DD_APM_INSTRUMENTATION_LIBRARIES="java:1.38.0,python:2.10.5" - Java と Python の Datadog APM ライブラリのみを、それぞれ特定のバージョン 1.38.0 と 2.10.5 に固定してインストールします。

利用可能なバージョンは、各言語のソースリポジトリに一覧があります:

• Java (java)
• Node.js (js)
• Python (python)
• .NET (dotnet)
• Ruby (ruby)

ネームスペース単位でインスツルメンテーションを有効/無効にする

特定のネームスペース内のアプリケーションに対して、インスツルメンテーションを有効または無効にできます。enabledNamespaces と disabledNamespaces は同時に設定できません。

どのファイルを編集するかは、Datadog Operator か Helm で Single Step Instrumentation を有効にしたかによって異なります。

   features:
     apm:
       instrumentation:
         enabled: true
         enabledNamespaces: # インスツルメントを有効にするネームスペースを追加
           - default
           - applications

   features:
     apm:
       instrumentation:
         enabled: true
         disabledNamespaces: # インスツルメンテーションを無効にするネームスペースを追加
           - default
           - applications

   datadog:
      apm:
        instrumentation:
          enabled: true
          enabledNamespaces: # インスツルメントを有効にするネームスペースを追加
             - namespace_1
             - namespace_2

   datadog:
      apm:
        instrumentation:
          enabled: true
          disabledNamespaces: # インスツルメンテーションを無効にするネームスペースを追加
            - namespace_1
            - namespace_2

トレースライブラリバージョンの指定

アプリケーションが使用する言語に対応する Datadog のトレースライブラリとそのバージョンを指定すると、その言語で書かれたアプリケーションを自動的にインスツルメントできます。構成方法は以下の 2 つがあり、優先順位は次の順序で適用されます。

1. サービスレベルで指定、または
2. クラスターレベルで指定

デフォルト: もしライブラリバージョンを一切指定せずに apm.instrumentation.enabled=true を設定した場合、サポートされている言語で書かれたアプリケーションは、最新のトレースライブラリバージョンを使用して自動的にインスツルメントされます。

サービスレベルでの指定

特定のポッドで動作するアプリケーションを自動的にインスツルメントするには、ポッドの spec にアプリケーション対応の言語アノテーションとライブラリバージョンを追加してください。

<CONTAINER IMAGE TAG> を、使用したいライブラリのバージョンに置き換えてください。利用可能なバージョンは、Datadog コンテナレジストリと各言語のトレーサーのソースリポジトリに掲載されています。

• Java
• Node.js
• Python
• .NET
• Ruby

例えば、Java アプリケーションを自動的にインスツルメントする場合は以下のようになります。

apiVersion: apps/v1
kind: Deployment
metadata:
  labels:
    # ...
spec:
  template:
    metadata:
      annotations:
        admission.datadoghq.com/java-lib.version: "<CONTAINER IMAGE TAG>"
    spec:
      containers:
        - # ...

クラスターレベルでの指定

ポッドごとにアノテーションを用いて自動インスツルメントを有効にしない場合は、Single Step Instrumentation の構成を使ってクラスター全体でどの言語をインスツルメントするか指定できます。apm.instrumentation.libVersions が設定されている場合、指定した言語のアプリケーションのみ、指定したライブラリバージョンでインスツルメントされます。

どのファイルを構成するかは、Datadog Operator か Helm を使って Single Step Instrumentation を有効にしたかによって異なります。

   features:
     apm:
       instrumentation:
         enabled: true
         libVersions: # 設定したいライブラリとバージョンを追加
            dotnet: "3.2.0"
            python: "1.20.6"
            js: "4.17.0"

   datadog:
     apm:
       instrumentation:
         enabled: true
         libVersions: # 設定したいライブラリとバージョンを追加
            dotnet: "3.2.0"
            python: "1.20.6"
            js: "4.17.0"

コンテナレジストリ

Datadog は、以下の gcr.io、Docker Hub、Amazon ECR にインスツルメンテーションライブラリのイメージを公開しています。

Datadog Cluster Agent の構成にある DD_ADMISSION_CONTROLLER_AUTO_INSTRUMENTATION_CONTAINER_REGISTRY 環境変数は、Admission Controller が使用するレジストリを指定します。デフォルト値は、gcr.io/datadoghq です。

ローカルコンテナレジストリでイメージをホストしている場合は、docker.io/datadog、public.ecr.aws/datadog、または他の URL に変更することで、別のレジストリからトレーシングライブラリを引き出すことができます。

コンテナレジストリを変更する手順については、コンテナレジストリの変更を参照してください。

1. サービス起動コマンドに環境変数 DD_INSTRUMENT_SERVICE_WITH_APM を追加します。

   DD_INSTRUMENT_SERVICE_WITH_APM=false <service_start_command>
   

2. サービスを再起動します。

1. サービス起動コマンドに環境変数 DD_INSTRUMENT_SERVICE_WITH_APM を追加します。

   docker run -e DD_INSTRUMENT_SERVICE_WITH_APM=false <service_start_command>
   

2. サービスを再起動します。

1. ポッド仕様の admission.datadoghq.com/enabled: ラベルを "false" に設定します。

   spec:
     template:
       metadata:
         labels:
           admission.datadoghq.com/enabled: "false"
   

2. コンフィギュレーションを適用します。

   kubectl apply -f /path/to/your/deployment.yaml
   

3. インスツルメンテーションを削除したいサービスを再起動します。

1. 次を実行します。

   dd-host-install --uninstall
   

2. ホストまたは VM 上のサービスを再起動します。

1. 次を実行します。

   dd-container-install --uninstall
   

2. Docker を再起動します。

   systemctl restart docker
   

   または、環境に応じたコマンドを使用してください。

どのファイルを構成するかは、Datadog Operator か Helm を使って Single Step Instrumentation を有効にしたかによって異なります。