datadog.datadog

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.

Variable Beschreibung
datadog_api_key Ihr Datadog API-Schlüssel. Diese Variable ist ab Version 4.21 zwingend erforderlich.
datadog_site Die Website, an die Agent-Daten gesendet werden. Standardmäßig auf datadoghq.com, setzen Sie es auf datadoghq.eu, um Daten an die EU-Website zu senden.
datadog_agent_flavor Überschreibt das standardmäßige Debian / RedHat-Paket für IoT-Installationen auf RPI. Standardmäßig ist es "datadog-agent" - verwenden Sie "datadog-iot-agent" für RPI.
datadog_agent_version Die festgelegte Version des zu installierenden Agents (optional, aber empfohlen), z. B. 7.16.0.
datadog_agent_major_version Die Hauptversion des zu installierenden Agents. Mögliche Werte sind 5, 6 oder 7 (Standard).
datadog_checks YAML-Konfiguration für Agent-Checks ablegen.
datadog_disable_untracked_checks Auf true setzen, um alle Checks zu entfernen, die nicht in datadog_checks und datadog_additional_checks vorhanden sind.
datadog_additional_checks Liste von zusätzlichen Checks, die nicht entfernt werden, wenn datadog_disable_untracked_checks auf true gesetzt ist.
datadog_disable_default_checks Auf true setzen, um alle Standardchecks zu entfernen.
datadog_config Setzen Sie die Konfiguration für den Datadog Agent.
datadog_enabled Auf false setzen, um den Dienst datadog-agent zu verhindern (Standard auf true).
datadog_additional_groups Entweder eine Liste oder ein String mit einer durch Kommas getrennten Liste von zusätzlichen Gruppen für den Benutzer datadog_user (nur Linux).
datadog_windows_ddagentuser_name Der Name des Windows-Benutzers, den Sie erstellen oder verwenden möchten, im Format <domain>\<user> (nur Windows).
datadog_windows_ddagentuser_password Das Passwort, das verwendet wird, um den Benutzer zu erstellen und/oder den Dienst zu registrieren (nur Windows).
datadog_macos_user Der Name des Benutzers, unter dem der Agent ausgeführt wird. Der Benutzer muss existieren und wird nicht automatisch erstellt.

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!

Über das Projekt

Install Datadog agent and configure checks

Installieren
ansible-galaxy install datadog.datadog
Lizenz
apache-2.0
Downloads
16.3M
Besitzer