Rola Ansible dla SolarWinds Snap Agent

Instaluje i konfiguruje SolarWinds Snap Agent na serwerach RHEL/CentOS, Debian/Ubuntu lub Windows.

Aby uzyskać bardziej szczegółowe informacje o SolarWinds Snap Agent, zapoznaj się z dokumentacją

Zmienne Roli

Zmienne roli Ansible z wartościami domyślnymi są wymienione poniżej:

solarwinds_token: ""

Token API AppOptics token. Musisz go skonfigurować przed uruchomieniem roli.

swisnap_hostname_alias: ""

Alias hosta dla serwera, który będzie używany w interfejsie użytkownika AppOptics.

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

Ścieżka do głównego pliku konfiguracyjnego SolarWinds Snap Agent.

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

Ścieżka do plików konfiguracyjnych wtyczek SolarWinds Snap Agent.

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

Ścieżka do plików konfiguracyjnych wydawcy AppOptics SolarWinds Snap Agent.

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

Ścieżka do plików konfiguracyjnych wydawcy procesów SolarWinds Snap Agent.

swisnap_auto_discover_path: /opt/SolarWinds/Snap/autoload

Ścieżka do katalogu autoload SolarWinds Snap Agent dla wtyczek V1.

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

Ścieżka do plików zadań V2 SolarWinds Snap Agent.

swisnap_plugin_path: /opt/SolarWinds/Snap/bin

Ścieżka, w której przechowywane są pliki binarne wtyczek SolarWinds Snap Agent.

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

Ścieżka do plików zadań V1 SolarWinds Snap Agent.

swisnap_service: swisnapd
swisnap_user: solarwinds
swisnap_user_group: solarwinds

Nazwa usługi SolarWinds Snap Agent. Użytkownik i grupa, pod którymi będzie działać usługa.

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

Poziom logowania, ścieżka do pliku logu i format logu.

swisnap_plugin_trust_level: ""
swisnap_keyring_paths: ""

Poziom zaufania do wtyczek dla swisnapd. Po włączeniu będą ładowane tylko podpisane wtyczki, które można zweryfikować. Podpisy są weryfikowane na podstawie plików keyring określonych w swisnap_keyring_path. Dozwolone wartości to 0 - Wyłączone, 1 - Włączone, 2 - Ostrzeżenie. Wartość domyślna to 1 - Włączone. Jeśli nie jest ustawiona, agent użyje wartości domyślnej - włączonej.

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

Opcjonalne parametry zabezpieczonej komunikacji wtyczek.

swisnap_plugin_load_timeout: ""

Maksymalny czas na załadowanie wtyczki. Wartość domyślna to 30.

swisnap_global_tags: {}

Tagi, które będą stosowane do zbieranych metryk w różnych zadaniach.

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: ""

Opcjonalne parametry REST API. Domyślnie REST API jest włączone.

publisher_appoptics_url: ""
publisher_processes_url: ""

Te parametry mogą nadpisywać domyślny URL dla wydawców.

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

Opcjonalne ustawienia proxy.

swisnap_host_check_timeout: ""

swisnap_host_check_timeout pozwala skonfigurować czas oczekiwania na zapytanie o system operacyjny hosta w celu uzyskania informacji identyfikacyjnych. Wartość domyślna to 5s.

swisnap_ec2_check_timeout: ""

swisnap_ec2_check_timeout pozwala skonfigurować czas oczekiwania na zapytanie o URL metadanych instancji EC2 w celu ustalenia, czy agent hosta działa na instancji EC2 (lub OpenStack). Domyślnie ustawione na 1s.

swisnap_ec2_check_retries: ""

swisnap_ec2_check_retries pozwala skonfigurować liczbę prób zapytania o URL metadanych instancji EC2 w celu ustalenia, czy agent hosta działa na instancji EC2 (lub OpenStack). Domyślnie ustawione na 3.

swisnap_floor_seconds: ""

Określa, czy zaokrąglać znaczniki czasowe do określonego przedziału, wartość domyślna to 60 sekund.

swisnap_period: ""

Okres interwału metryk do zgłaszania do API AppOptics, wartość domyślna to 60 sekund.

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

Ścieżki do katalogów z niestandardowymi plikami konfiguracyjnymi zadań i wtyczek. Umożliwia użytkownikom skonfigurowanie dodatkowych wtyczek. Powinna to być ścieżka do katalogu, np. /path/to/directory.

swisnap_win_installer_download_path: ""

Ścieżka do pobrania instalatora Windows. Musi być skonfigurowana przez użytkownika przed uruchomieniem roli na platformie Windows.

swisnap_package_version: ""

Specyficzna wersja pakietu do zainstalowania, np. 4.0.0.863. Działa tylko na platformach Linux. Dla Windows zawsze instalowany jest najnowszy pakiet.

Przykład Playbooka

Zainstaluj rolę SolarWinds swinsap za pomocą Ansible Galaxy:

ansible-galaxy install solarwinds.swisnap

lub sklonuj to repozytorium do katalogu z rolami Twojego playbooka:

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

W pliku vars/my_vars.yaml:

solarwinds_token: 123456789dbba089e9ff613bb9528320188853b1a08d91d23d2fc9bc1c41ec3e

Windows:

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

W pliku vars/my_vars.yaml:

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

W pliku inventory:

[windows]
1.2.3.4

W pliku group_vars/windows:

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