Роль Ansible для SolarWinds Snap Agent

Устанавливает и настраивает SolarWinds Snap Agent на серверах RHEL/CentOS, Debian/Ubuntu или Windows.

Для более подробной информации о SolarWinds Snap Agent ознакомьтесь с документацией

Переменные роли

Переменные роли Ansible со значениями по умолчанию перечислены ниже:

solarwinds_token: ""

API токен AppOptics. Должен быть настроен пользователем перед запуском роли.

swisnap_hostname_alias: ""

Псевдоним для имени хоста сервера, который будет использоваться в пользовательском интерфейсе AppOptics.

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

Путь к основному конфигурационному файлу SolarWinds Snap Agent.

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

Путь к файлам конфигурации плагинов SolarWinds Snap Agent.

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

Путь к файлам конфигурации публикатора AppOptics SolarWinds Snap Agent.

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

Путь к файлам конфигурации публикатора процессов SolarWinds Snap Agent.

swisnap_auto_discover_path: /opt/SolarWinds/Snap/autoload

Путь к директории автозагрузки SolarWinds Snap Agent для плагинов версии 1.

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

Путь к файлам задач версии 2 SolarWinds Snap Agent.

swisnap_plugin_path: /opt/SolarWinds/Snap/bin

Путь, где хранятся бинарные файлы плагинов SolarWinds Snap Agent.

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

Путь к файлам задач версии 1 SolarWinds Snap Agent.

swisnap_service: swisnapd
swisnap_user: solarwinds
swisnap_user_group: solarwinds

Имя службы SolarWinds Snap Agent. Пользователь и группа, от имени которых будет работать служба.

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

Уровень логирования, путь к файлу журнала и формат журнала.

swisnap_plugin_trust_level: ""
swisnap_keyring_paths: ""

Уровень доверия для плагинов swisnapd. При включении загружаются только подписанные плагины, которые можно проверить. Подписи проверяются из файлов ключей, указанных в swisnap_keyring_path. Допустимые значения: 0 - Выключено, 1 - Включено, 2 - Предупреждение. Значение по умолчанию - 1 - Включено. Если это значение не установлено, агент будет использовать уровень по умолчанию.

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

Дополнительные параметры для безопасного общения с плагинами.

swisnap_plugin_load_timeout: ""

Максимальное время, разрешенное для загрузки плагина. Значение по умолчанию - 30 секунд.

swisnap_global_tags: {}

Теги, которые будут применяться к собираемым метрикам в задачах.

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

Дополнительные параметры REST API. По умолчанию REST API включен.

publisher_appoptics_url: ""
publisher_processes_url: ""

Эти параметры могут переопределить URL-адрес по умолчанию для публикаторов.

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

Дополнительные настройки прокси.

swisnap_host_check_timeout: ""

swisnap_host_check_timeout позволяет настроить время ожидания для запроса информации об операционной системе хоста. Значение по умолчанию - 5 секунд.

swisnap_ec2_check_timeout: ""

swisnap_ec2_check_timeout позволяет настроить время ожидания для запроса URL-адреса метаданных экземпляра EC2, чтобы определить, работает ли агент на экземпляре EC2 (или OpenStack). По умолчанию оно установлено на 1 секунду.

swisnap_ec2_check_retries: ""

swisnap_ec2_check_retries позволяет настроить количество попыток запроса URL-адреса метаданных экземпляра EC2, чтобы определить, работает ли агент на экземпляре EC2 (или OpenStack). По умолчанию оно установлено на 3.

swisnap_floor_seconds: ""

Указывает, нужно ли округлять временные метки до определенного интервала, значение по умолчанию - 60 секунд.

swisnap_period: ""

Период интервала метрик для отчета в API AppOptics, значение по умолчанию - 60 секунд.

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

Пути к директориям с пользовательскими файлами конфигурации задач и плагинов. Позволяет пользователям настраивать дополнительные плагины. Должен быть указан путь к директории, например /path/to/directory.

swisnap_win_installer_download_path: ""

Путь для загрузки установщика Windows. Должен быть настроен пользователем перед запуском роли на платформе Windows.

swisnap_package_version: ""

Определенная версия пакета для установки, например 4.0.0.863. Работает только для Linux. Для Windows всегда устанавливается последняя версия пакета.

Пример плейбука

Установите роль SolarWinds swisnap с помощью Ansible Galaxy:

ansible-galaxy install solarwinds.swisnap

или клонируйте этот репозиторий в каталог с ролями вашего плейбука:

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

Внутри vars/my_vars.yaml:

solarwinds_token: 123456789dbba089e9ff613bb9528320188853b1a08d91d23d2fc9bc1c41ec3e

Windows:

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

Внутри vars/my_vars.yaml:

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

Внутри inventory:

[windows]
1.2.3.4

Внутри group_vars/windows:

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