Rol de Ansible para SolarWinds Snap Agent

Instala y configura el SolarWinds Snap Agent en servidores RHEL/CentOS, Debian/Ubuntu o Windows.

Para obtener información más detallada sobre SolarWinds Snap Agent, por favor consulta la documentación.

Variables del Rol

Las variables del rol de Ansible con valores predeterminados se enumeran a continuación:

solarwinds_token: ""

Token de la API de AppOptics token. Debe ser configurado por el usuario antes de ejecutar el rol.

swisnap_hostname_alias: ""

Alias de hostname para el servidor que se usará en la interfaz de usuario de AppOptics.

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

Ruta al archivo de configuración principal del SolarWinds Snap Agent.

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

Ruta a los archivos de configuración de plugins del SolarWinds Snap Agent.

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

Ruta a los archivos de configuración del publicador AppOptics del SolarWinds Snap Agent.

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

Ruta a los archivos de configuración de procesos del publicador del SolarWinds Snap Agent.

swisnap_auto_discover_path: /opt/SolarWinds/Snap/autoload

Ruta al directorio de autoload del SolarWinds Snap Agent para plugins V1.

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

Ruta a los archivos de tareas V2 del SolarWinds Snap Agent.

swisnap_plugin_path: /opt/SolarWinds/Snap/bin

Ruta donde se almacenan los binarios de los plugins del SolarWinds Snap Agent.

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

Ruta a los archivos de tareas V1 del SolarWinds Snap Agent.

swisnap_service: swisnapd
swisnap_user: solarwinds
swisnap_user_group: solarwinds

Nombre del servicio del SolarWinds Snap Agent. Usuario y grupo bajo los cuales operará el servicio.

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

Nivel de registro, ruta al archivo de log y formato del log.

swisnap_plugin_trust_level: ""
swisnap_keyring_paths: ""

Nivel de confianza para los plugins en swisnapd. Cuando está habilitado, solo se cargarán plugins firmados que se puedan verificar. Las firmas se verifican desde los archivos de keyring especificados en swisnap_keyring_path. Valores válidos son 0 - Desactivado, 1 - Habilitado, 2 - Aviso. El valor predeterminado es 1 - Habilitado. Si no está configurado, el agente usará el nivel habilitado por defecto.

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

Parámetros opcionales para la comunicación segura de plugins.

swisnap_plugin_load_timeout: ""

El tiempo máximo permitido para cargar un plugin. El valor predeterminado es 30.

swisnap_global_tags: {}

Etiquetas que se aplicarán a las métricas recolectadas a través de las tareas.

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

Parámetros opcionales para la API REST. Por defecto, la API REST está habilitada.

publisher_appoptics_url: ""
publisher_processes_url: ""

Estos parámetros pueden reemplazar la URL por defecto para los publicadores.

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

Configuraciones opcionales de proxy.

swisnap_host_check_timeout: ""

swisnap_host_check_timeout permite configurar el tiempo de espera para consultar el sistema operativo del host para obtener información de identificación. El valor predeterminado es 5s.

swisnap_ec2_check_timeout: ""

swisnap_ec2_check_timeout permite configurar el tiempo de espera para consultar la URL de metadatos de la instancia EC2 para determinar si el agente del host está funcionando en una instancia EC2 (o OpenStack). Por defecto, se establece en 1s.

swisnap_ec2_check_retries: ""

swisnap_ec2_check_retries permite configurar el número de reintentos para consultar la URL de metadatos de la instancia EC2. Por defecto, se establece en 3.

swisnap_floor_seconds: ""

si se deben redondear las marcas de tiempo a un intervalo específico, el valor predeterminado es 60 segundos.

swisnap_period: ""

período de intervalo de métricas para reportar a la API de AppOptics, el valor predeterminado es 60 segundos.

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

Rutas a directorios con archivos de configuración de tareas y plugins personalizados. Permite a los usuarios configurar plugins adicionales. Debe ser una ruta a un directorio, por ejemplo, /ruta/al/directorio.

swisnap_win_installer_download_path: ""

Ruta para descargar el instalador de Windows. Debe ser configurado por el usuario antes de ejecutar el rol en la plataforma Windows.

swisnap_package_version: ""

Versión específica del paquete a instalar, por ejemplo, 4.0.0.863. Solo funciona para plataformas Linux. Para Windows, siempre se instala el paquete más reciente.

Ejemplo de Playbook

Instala el rol solarwinds swisnap usando Ansible Galaxy:

ansible-galaxy install solarwinds.swisnap

o clona este repositorio en el directorio de roles de tu playbook:

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

Dentro de vars/my_vars.yaml:

solarwinds_token: 123456789dbba089e9ff613bb9528320188853b1a08d91d23d2fc9bc1c41ec3e

Windows:

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

Dentro de vars/my_vars.yaml:

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

Dentro de inventory:

[windows]
1.2.3.4

Dentro de group_vars/windows:

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