Datadog Agent Ansible Rolle

Die Datadog Agent Ansible Rolle installiert und konfiguriert den Datadog Agent und Integrationen.

Ansible Rolle versus Ansible Sammlung

Die Datadog Agent Ansible Rolle ist über zwei verschiedene Kanäle verfügbar:

• Als Teil der Datadog Sammlung, zugänglich unter dem Namen datadog.dd auf Ansible Galaxy (empfohlen).
• Als eigenständige Rolle, zugänglich unter dem Namen datadog.datadog auf Ansible Galaxy (veraltet).

Version 4 der Rolle und Version 5 der Sammlung installieren standardmäßig den Datadog Agent v7.

Einrichtung

Bitte beachten Sie, dass die Installationsanweisungen in diesem Dokument die Installation der eigenständigen Datadog Rolle beschreiben. Für Installationsanweisungen der Datadog Sammlung verweisen Sie bitte auf die README-Datei der Sammlung. Die Konfigurationsvariablen sind für sowohl die eigenständige Rolle als auch die Rolle über die Sammlung gleich.

Anforderungen

• Benötigt Ansible v2.6+.

• Unterstützt die meisten Debian- und RHEL-basierten Linux-Distributionen, macOS und Windows.

• Wenn Sie Ansible 2.10+ zur Verwaltung von Windows-Hosts verwenden, müssen Sie die Sammlung ansible.windows installieren:

  ansible-galaxy collection install ansible.windows
  

• Wenn Sie Ansible 2.10+ zur Verwaltung von openSUSE/SLES-Hosts verwenden, müssen Sie die Sammlung community.general installieren:

  ansible-galaxy collection install community.general
  

Installation

Installieren Sie die [Datadog Rolle][1] von Ansible Galaxy auf Ihrem Ansible-Server:

ansible-galaxy install datadog.datadog

Um den Datadog Agent auf Hosts zu installieren, fügen Sie die Datadog Rolle und Ihren API-Schlüssel in Ihr Playbook ein:

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

Der API-Schlüssel ist erforderlich und sein Fehlen führt zum Fehler der Rolle. Wenn Sie ihn auf eine andere Weise bereitstellen möchten, die nicht von Ansible verwaltet wird, geben Sie einen Platzhalter-Schlüssel an und setzen Sie den Schlüssel später ein.

Rollenvariablen

Diese Variablen bieten zusätzliche Konfiguration während der Installation des Datadog Agents. Sie sollten im Abschnitt vars Ihres Playbooks angegeben werden.

Integrationen

Um eine Datadog-Integration (Check) zu konfigurieren, fügen Sie einen Eintrag zum Abschnitt datadog_checks hinzu. Der Schlüssel auf der ersten Ebene ist der Name des Checks, und der Wert ist die YAML-Nutzlast für die Konfigurationsdatei. Beispiele sind unten angegeben.

Beispielkonfiguration

datadog_config:
  process_config:
    enabled: "true" # Typ: String
    scrub_args: true
system_probe_config:
  sysprobe_socket: /opt/datadog-agent/run/sysprobe.sock

Hinweis: Diese Konfiguration funktioniert mit Agent 6.24.1+ und 7.24.1+. Für ältere Agent-Versionen siehe die Dokumentation zu Network Performance Monitoring zur Aktivierung des System-Probes.

Playbooks

Nachfolgend einige Beispiel-Playbooks zur Unterstützung bei der Verwendung der Datadog Ansible Rolle.

Das folgende Beispiel sendet Daten an Datadog US (Standard), aktiviert Protokolle, NPM und konfiguriert einige Checks.

- hosts: servers
  roles:
    - { role: datadog.datadog, become: yes }
  vars:
    datadog_api_key: "<IHRE_DD_API_KEY>"
    datadog_agent_version: "7.16.0"
    datadog_config:
      log_level: INFO
      apm_config:
        enabled: true
      logs_enabled: true
    datadog_checks:
      ssh_check:
        init_config:
        instances:
          - host: localhost
            port: 22
            username: root
            password: <IHRE_PASSWORT>

Deinstallation

Auf Windows ist es möglich, den Agenten mit folgendem Code in Ihrer Ansible-Rolle zu deinstallieren:

- name: Überprüfen, ob Datadog Agent installiert ist
  win_shell: |
    (@(Get-ChildItem -Path "HKLM:SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall" -Recurse) | Where {$_.GetValue("DisplayName") -like "Datadog Agent" }).PSChildName
  register: agent_installed_result
- name: Datadog Agent installiertes Fakt festlegen
  set_fact:
    agent_installed: "{{ agent_installed_result.stdout | trim }}"
- name: Datadog Agent deinstallieren
  win_package:
    product_id: "{{ agent_installed }}"
    state: absent
  when: agent_installed != ""

Fehlersuche

Wenn Sie Anweisungen zur Fehlersuche benötigen, können Sie spezifische Fragen stellen oder auf häufige Probleme der Plattform zurückgreifen.

Bitte lassen Sie mich wissen, wenn ich Ihnen weiterhelfen kann!