:warning:	New Relic bietet eine neue Ansible-Lösung, die das Skalieren Ihrer New Relic Observability-Bemühungen vereinfacht. Bitte ziehen Sie in Betracht, diese Lösung künftig zu nutzen.

Ansible-Rolle für den New Relic Infrastruktur-Agenten

Eine Ansible-Rolle, die verwendet werden kann, um den New Relic Infrastruktur-Agenten zu installieren und/oder zu konfigurieren sowie New Relic Infrastructure OHIs zu installieren.

Installation

Verwenden Sie den folgenden Befehl, um die neueste Version der New Relic Rolle herunterzuladen:

ansible-galaxy install newrelic.newrelic-infra

Erste Schritte

Um die Rolle newrelic.newrelic-infra direkt in einem Playbook zu verwenden, fügen Sie die Rolle einfach in Ihr Playbook ein. Zum Beispiel:

# myplaybook.yml
---
- hosts: webservers
  roles:
    - role: newrelic.newrelic-infra
      vars:
        nrinfragent_config:
          license_key: 12345

Um newrelic.newrelic-infra als Abhängigkeit in Ihrer eigenen Rolle zu benötigen, fügen Sie eine Abhängigkeit in der Datei meta/main.yml Ihrer Rolle hinzu. Zum Beispiel:

# roles/myapp/meta/main.yml
---
dependencies:
  - role: newrelic.newrelic-infra

Verwendung

Diese Rolle kann für die folgenden Interaktionen mit dem New Relic Infrastruktur-Agenten verwendet werden:

• Installieren des Agenten über den OS-Paketmanager
• Installieren des Agenten über Tarball (nur Linux)
• Installieren von Integrationen über den OS-Paketmanager
• Konfigurieren des Agenten
• Einrichten des Agenten-Init-Dienstes

Standardmäßig installiert die Rolle den Agenten über den OS-Paketmanager, installiert Integrationen, konfiguriert den Agenten und richtet den Init-Dienst ein. Zusätzlich sind folgende Tags verfügbar, um andere Interaktionen durchzuführen:

• nria_install
• nria_install_tarball
• nria_install_integrations
• nria_configure
• nria_setup_service

Grundlegende Verwendung

Das folgende Snippet installiert den Agenten über den OS-Paketmanager, konfiguriert den Agenten mit der angegebenen Konfiguration und richtet den OS-Init-Dienst des Agenten ein.

---
- hosts: ap_ne_1
  roles:
    - name: newrelic.newrelic-infra
      vars:
        log_file: /opt/logs/newrelic-infra.log
        verbose: 0
        nrinfragent_config:
          license_key: 12345
          custom_attributes:
            environment: dev

Tarball-Installation (nur Linux)

Um die Tarball-Installationsmethode zu verwenden, müssen Sie die Variable nrinfragent_tarball_version auf eine gültige Tarball-Version setzen. Die Installation über die Tarball-Methode führt auch die Konfigurations- und Init-Dienstaufgaben aus, es sei denn, das Tag nria_install_tarball wird angegeben.

- hosts: ap_ne_1
  roles:
    - name: newrelic.newrelic-infra
      vars:
        nrinfragent_tarball_version: 1.18.0
        nrinfragent_tarball_download_dir: /opt/newrelic/
        nrinfragent_config:
          log_file: /opt/logs/newrelic-infra.log
          verbose: 0
          license_key: 12345
          custom_attributes:
            environment: dev

Offline-Tarball-Installation

Um einen lokalen Tarball anstelle eines Downloads aus dem Internet zu verwenden, müssen Sie den Wert der Variablen nrinfragent_tarball_local_file_path auf einen lokalen Pfad zum Tarball setzen.

- hosts: ap_ne_1
  roles:
    - name: newrelic.newrelic-infra
      vars:
        nrinfragent_tarball_version: 1.18.0
        nrinfragent_tarball_download_dir: /opt/newrelic/
        nrinfragent_tarball_from_local: yes
        nrinfragent_config:
          log_file: /opt/logs/newrelic-infra.log
          verbose: 0
          license_key: 12345
          custom_attributes:
            environment: dev

Nur Konfigurieren

Das folgende Snippet konfiguriert nur die Konfiguration des bereits installierten Agenten, sofern das Playbook mit --tags nria_configure ausgeführt wird. Beachten Sie, dass in diesem Fall include_role verwendet werden muss.

- hosts: ap_ne_1
  tasks:
  - name: Konfigurieren des New Relic Infrastruktur-Agenten
    include_role:
      name: newrelic.newrelic-infra
    vars:
      nrinfragent_config:
        license_key: 12345
        log_file: /opt/logs/newrelic-infra.log
        verbose: 0
        custom_attributes:
          environment: dev
    tags:
    - nria_configure

Referenz

Rollen-Konfiguration

Variablen

Die Konfigurationsvariablen der Rolle sind inline sowie unten dokumentiert.

nrinfragent_state (Optional)

Installiert oder deinstalliert Pakete (Paketmanager-Installation). Installationen über den Paketmanager werden mit dem Ansible-Paketmodul durchgeführt.

• 'latest' - [Standard] Installiert die neueste Version des Agenten. Auch present.
• 'absent' - Deinstalliert den Agenten.

nrinfragent_service_state (Optional)

Gibt den Status des newrelic-infra-Dienstes nach der Installation an. Standardmäßig auf started, damit der Dienst läuft. Ändern Sie es in stopped, um nur zu installieren, ohne ihn sofort zu starten.

nrinfragent_service_enabled (Optional)

Gibt an, ob der Dienst beim Booten gestartet wird. Standardmäßig auf yes. Ändern Sie es in no, um zu verhindern, dass der Dienst automatisch beim Booten gestartet wird.

nrinfragent_config_file (Optional)

Gibt einen benutzerdefinierten Pfad zur Konfigurationsdatei des New Relic Infrastruktur-Agenten an. Standardmäßig auf /etc/newrelic-infra.yml unter Linux.

nrinfragent_config (Erforderlich)

Wird verwendet, um die Konfiguration des Agenten zu füllen. Mindestens müssen Sie license_key bereitstellen.

nrinfragent_integrations (Optional)

Gibt die On-Host-Integrationen an, die über den OS-Paketmanager installiert werden sollen.

Standardmäßig ist der Status absent, der das Paket nicht installiert; ändern Sie ihn in latest oder present.

nrinfragent_integrations:
  - name: nri-nginx
    state: latest
  - name: nri-mysql
    state: absent

Entfernen des newrelic-infra-integrations-Pakets und seiner integrierten Integrationen

Um das newrelic-infra-integrations-Paket oder eine der integrierten Integrationen zu entfernen, fügen Sie newrelic-infra-integrations als ersten Eintrag in nrinfragent_integrations mit dem Status absent hinzu.

nrinfragent_integrations:
  - name: newrelic-infra-integrations
    state: "absent"

Testen

Die infrastructure-agent-ansible-Rolle verwendet molecule für Tests. Es gibt drei Szenarien.

1. Das Standard-Szenario testet die Installation und Konfiguration des Agenten sowie die Einrichtung der OS-Init-Dienste.
2. Das Konfigurations-Szenario testet das Ausführen der Konfiguration des Agenten mit dem Tag nria_configure. Dies erfordert, dass das default-Szenario zuerst ausgeführt wird.
3. Das targz-Szenario testet die Installation und Konfiguration des Agenten über die Tarball-Installationsmethode.

Lizenz

Die infrastructure-agent-ansible-Rolle wird unter der Apache 2.0 Lizenz lizenziert.