コミュニティとマーケットプレイスのインテグレーションを使用する

概要

Datadog Agent のコミュニティ開発のインテグレーションは、Datadog の Integrations-extra GitHub リポジトリに格納されています。これらは Agent にはパッケージ化されていませんが、アドオンとしてインストールできます。

セットアップ

新規ユーザーの方は、最新版の Datadog Agent をダウンロードおよびインストールしてください。

インストール

Agent v7.21 / v6.21 以降の場合:

  1. 以下のコマンドを実行して、Agent インテグレーションをインストールします。

    datadog-agent integration install -t datadog-<INTEGRATION_NAME>==<INTEGRATION_VERSION>
    

    インテグレーションのバージョンは、インテグレーションの Github リポジトリにあるそれぞれの変更履歴で確認できます

  2. コアのインテグレーションと同様にインテグレーションを構成します。

  3. Agent を再起動します

: 必要に応じて、インストールコマンドの先頭に sudo -u dd-agent を追加します。

コンテナ化された環境でコミュニティまたはマーケットプレイスのインテグレーションを使用するには、希望するコミュニティインテグレーション を含むカスタムイメージを構築する必要があります。

integrations-extrasから <INTEGRATION_NAME> を含むカスタムバージョンの Agent を構築するには、以下の Dockerfileを使用します。マーケットプレイスインテグレーション をインストールする場合、<INTEGRATION_NAME> は構成手順で確認できます。

FROM gcr.io/datadoghq/agent:latest
RUN agent integration install -r -t datadog-<INTEGRATION_NAME>==<INTEGRATION_VERSION>

(Docker 内で実行された) datadog-agent integration install コマンドは、無害な警告 Error loading config: Config File "datadog" Not Found in "[/etc/datadog-agent]": warn を発行します。この警告は無視してかまいません。

Kubernetes を使用している場合は、Helm チャートまたは Datadog Operator の構成を更新して、カスタムイメージをプルします。

インテグレーションを有効化して構成するには、オートディスカバリーを使用します。

Agent v7.21 / v6.21 以前の場合:

  1. <INTEGRATION_NAME>/datadog_checks/<INTEGRATION_NAME>/ フォルダーに ファイルを integrations-extra リポジトリからダウンロードします
  2. <INTEGRATION_NAME>.py とその他の Python ファイルを Agent の checks.d ディレクトリに配置します。
  3. Agent のコンフィギュレーションディレクトリに新しい <INTEGRATION_NAME>.d/ フォルダーを作成します。
  4. 作成したディレクトリに、<INTEGRATION_NAME>/datadog_checks/<INTEGRATION_NAME>/data/ から conf.yaml.example ファイルを配置します。
  5. このファイルの名前を conf.yaml に変更します。
  6. コアのインテグレーションと同様にインテグレーションを構成します。
  7. Agent を再起動します

サイトがネットワークアクセスを制限している場合は、ip-ranges をすべて包含リストに追加していることを確認するか、インテグレーションを手動でダウンロードしてください。


その他の参考資料