Datadog Agent Ansibleロール

Datadog Agent Ansibleロールは、Datadog Agentと統合をインストールおよび設定します。

AnsibleロールとAnsibleコレクションの違い

Datadog Agent Ansibleロールは、2つの異なる方法で利用可能です。

• Datadogコレクションの一部として、datadog.ddという名前でAnsible Galaxyからアクセスできます（推奨）。
• スタンドアロンロールとして、datadog.datadogという名前でAnsible Galaxyからアクセスできます（旧式）。

このロールのバージョン4およびコレクションのバージョン5は、デフォルトでDatadog Agent v7をインストールします。

セットアップ

この文書のインストール手順は、スタンドアロンのDatadogロールのインストールについて説明しています。Datadogコレクションのインストール手順については、コレクションのREADMEファイルを参照してください。構成変数は、スタンドアロンロールとコレクションを通じてアクセスされるロールの両方で同じです。

要件

• Ansible v2.6以上が必要です。

• DebianおよびRHELベースのLinuxディストリビューション、macOS、およびWindowsの大部分をサポートしています。

• Ansible 2.10以上でWindowsホストを管理する場合、ansible.windowsコレクションをインストールする必要があります。

  ansible-galaxy collection install ansible.windows
  

• Ansible 2.10以上でopenSUSE/SLESホストを管理する場合、community.generalコレクションをインストールする必要があります。

  ansible-galaxy collection install community.general
  

インストール

AnsibleサーバーでAnsible Galaxyから[Datadogロール][1]をインストールします。

ansible-galaxy install datadog.datadog

ホストにDatadog Agentをデプロイするには、DatadogロールとAPIキーをプレイブックに追加します。

- hosts: servers
  roles:
    - { role: datadog.datadog, become: yes }
  vars:
    datadog_api_key: "<YOUR_DD_API_KEY>"

APIキーは必須で、これがないとロールは失敗します。他の方法で提供したい場合は、プレースホルダーキーを指定し、後でキーを置き換えます。

ロール変数

これらの変数は、Datadog Agentのインストール中に追加の構成を提供します。これらはプレイブックのvarsセクションに指定する必要があります。

統合

Datadog統合（チェック）を構成するには、datadog_checksセクションにエントリを追加します。最初のレベルのキーはチェックの名前で、値は設定ファイルを書き込むためのYAMLペイロードです。以下に例を示します。

プロセスチェック

processチェックの2つのインスタンスを定義するには、以下の構成を使用します。これにより、対応する設定ファイルが作成されます。

    datadog_checks:
      process:
        init_config:
        instances:
          - name: ssh
            search_string: ['ssh', 'sshd']
          - name: syslog
            search_string: ['rsyslog']
            cpu_check_interval: 0.2
            exact_match: true
            ignore_denied_access: true

その他の設定やトラブルシューティング、バージョン管理、プレイブックの例については、元の英語のドキュメントをご覧ください。