SolarWinds Snap Agent Ansible Rolle

Installiert und konfiguriert den SolarWinds Snap Agent auf RHEL/CentOS, Debian/Ubuntu oder Windows-Servern.

Für detailliertere Informationen zum SolarWinds Snap Agent siehe bitte die Dokumentation.

Rollenvariablen

Die Standardwerte für die Ansible-Rollenvariablen sind wie folgt aufgeführt:

solarwinds_token: ""

AppOptics API Token. Muss vom Benutzer vor Ausführung der Rolle konfiguriert werden.

swisnap_hostname_alias: ""

Hostname-Alias für den Server, der in der AppOptics UI verwendet wird.

swisnap_main_config_path: /opt/SolarWinds/Snap/etc/config.yaml

Pfad zur Hauptkonfigurationsdatei des SolarWinds Snap Agents.

swisnap_plugins_config: /opt/SolarWinds/Snap/etc/plugins.d

Pfad zu den Plugin-Konfigurationsdateien des SolarWinds Snap Agents.

swinsap_publisher_appoptics_path: /opt/SolarWinds/Snap/etc/plugins.d/publisher-appoptics.yaml

Pfad zu den Konfigurationsdateien des Publishers AppOptics des SolarWinds Snap Agents.

swinsap_processes_appoptics_path: /opt/SolarWinds/Snap/etc/plugins.d/publisher-processes.yaml

Pfad zu den Konfigurationsdateien der Publisher-Prozesse des SolarWinds Snap Agents.

swisnap_auto_discover_path: /opt/SolarWinds/Snap/autoload

Pfad zum Autoload-Verzeichnis des SolarWinds Snap Agents für V1-Plugins.

swisnap_tasks_autoload_path: /opt/SolarWinds/Snap/etc/tasks-autoload.d

Pfad zu den V2-Aufgaben-Dateien des SolarWinds Snap Agents.

swisnap_plugin_path: /opt/SolarWinds/Snap/bin

Pfad, in dem die Plugin-Binärdateien des SolarWinds Snap Agents gespeichert sind.

swisnap_task_path: /opt/SolarWinds/Snap/etc/tasks.d

Pfad zu den V1-Aufgaben-Dateien des SolarWinds Snap Agents.

swisnap_service: swisnapd
swisnap_user: solarwinds
swisnap_user_group: solarwinds

Name des SolarWinds Snap Agent-Dienstes. Benutzer und Gruppe, unter denen der Dienst läuft.

swisnap_log_level: warning
swisnap_log_path: /var/log/SolarWinds/Snap
swisnap_log_format: text

Logging-Level, Pfad zur Logdatei und Logformat.

swisnap_plugin_trust_level: ""
swisnap_keyring_paths: ""

Plugin-Vertrauensstufe für swisnapd. Wenn aktiviert, werden nur signierte Plugins geladen, die verifiziert werden können. Signaturen werden aus den in swisnap_keyring_path angegebenen Schlüsselbunddateien überprüft. Gültige Werte sind 0 - Aus, 1 - Aktiviert, 2 - Warnung. Der Standardwert ist 1 - Aktiviert. Wenn dies nicht festgelegt ist, verwendet der Agent das Standardniveau 'Aktiviert'.

swisnap_tls_cert_path: ""
swisnap_tls_key_path: ""
swisnap_plugin_tls_cert_path: ""
swisnap_plugin_tls_key_path: ""
swisnap_ca_cert_paths: ""

Sichere Parameter für die Plugin-Kommunikation, optional.

swisnap_plugin_load_timeout: ""

Die maximale Zeit, die einem Plugin zum Laden erlaubt ist. Der Standardwert beträgt 30.

swisnap_global_tags: {}

Tags, die auf die gesammelten Metriken über die Aufgaben angewendet werden.

swisnap_restapi_enable: true
swisnap_restapi_https: ""
swisnap_restapi_rest_auth: ""
swisnap_restapi_rest_auth_password: ""
swisnap_restapi_rest_certificate: ""
swisnap_restapi_rest_key: ""
swisnap_restapi_port: ""
swisnap_restapi_addr: ""
swisnap_restapi_plugin_load_timeout: ""

Optionale REST API-Parameter. Standardmäßig ist die REST API aktiviert.

publisher_appoptics_url: ""
publisher_processes_url: ""

Diese Parameter können die Standard-URL für Publisher überschreiben.

swisnap_proxy_url: ""
swisnap_proxy_user: ""
swisnap_proxy_password: ""

Optionale Proxy-Einstellungen.

swisnap_host_check_timeout: ""

Der Parameter swisnap_host_check_timeout ermöglicht die Konfiguration des Timeouts für die Abfrage des Host-Betriebssystems zur Identifikation. Der Standardwert beträgt 5s.

swisnap_ec2_check_timeout: ""

Der Parameter swisnap_ec2_check_timeout ermöglicht die Konfiguration des Timeouts für die Abfrage der EC2-Instanz-Metadaten-URL, um festzustellen, ob der Host-Agent auf einer EC2 (oder OpenStack)-Instanz läuft. Standardmäßig ist er auf 1s eingestellt.

swisnap_ec2_check_retries: ""

Der Parameter swisnap_ec2_check_retries ermöglicht die Konfiguration der Anzahl von Wiederholungen für die Abfrage der EC2-Instanz-Metadaten-URL, um festzustellen, ob der Host-Agent auf einer EC2 (oder OpenStack)-Instanz läuft. Standardmäßig ist er auf 3 eingestellt.

swisnap_floor_seconds: ""

Ob Zeitstempel auf ein bestimmtes Intervall gerundet werden sollen; der Standardwert beträgt 60 Sekunden.

swisnap_period: ""

Metriken-Intervallzeitraum, der an die AppOptics API gemeldet wird; der Standardwert beträgt 60 Sekunden.

swisnap_custom_v1_task_path: ""
swisnap_custom_v2_task_path: ""
swisnap_custom_plugin_configs_path: ""

Pfade zu Verzeichnissen mit benutzerdefinierten Aufgaben- und Plugin-Konfigurationsdateien. Ermöglicht es den Benutzern, zusätzliche Plugins zu konfigurieren. Es sollte der Pfad zu einem Verzeichnis sein, z.B. /path/to/directory.

swisnap_win_installer_download_path: ""

Pfad zum Herunterladen des Windows-Installers. Muss vom Benutzer vor der Ausführung der Rolle auf der Windows-Plattform konfiguriert werden.

swisnap_package_version: ""

Spezifische Version des Pakets, das installiert werden soll, z.B. 4.0.0.863. Funktioniert nur für Linux-Plattformen. Unter Windows wird immer das neueste Paket installiert.

Beispiel-Playbook

Installieren Sie die SolarWinds swisnap-Rolle mit Ansible Galaxy:

ansible-galaxy install solarwinds.swisnap

oder klonen Sie dieses Repository in das Verzeichnis mit den Rollen Ihres Playbooks:

git clone https://github.com/solarwinds/ansible-swisnap.git solarwinds.swisnap

Linux

- hosts: localhost
  connection: local
  vars_files:
    - vars/my_vars.yaml
  roles:
    - solarwinds.swisnap

In vars/my_vars.yaml:

solarwinds_token: 123456789dbba089e9ff613bb9528320188853b1a08d91d23d2fc9bc1c41ec3e

Windows:

- hosts: windows
  vars_files:
    - vars/main.yml
  roles:
    - solarwinds.swisnap

In vars/my_vars.yaml:

solarwinds_token: 123456789dbba089e9ff613bb9528320188853b1a08d91d23d2fc9bc1c41ec3e
swisnap_win_installer_download_path: "C:\\Users\\Administrator\\Downloads\\solarwinds-snap-agent-installer.msi"

In inventory:

[windows]
1.2.3.4

In group_vars/windows:

ansible_user: Administrator
ansible_password: password
ansible_port: 5986
ansible_connection: winrm
ansible_winrm_server_cert_validation: ignore