Rôle Ansible de SolarWinds Snap Agent

Installe et configure l'agent SolarWinds Snap sur des serveurs RHEL/CentOS, Debian/Ubuntu ou Windows.

Pour des informations plus détaillées sur l'agent SolarWinds Snap, veuillez consulter la documentation

Variables du rôle

Les variables du rôle Ansible avec des valeurs par défaut sont listées ci-dessous :

solarwinds_token: ""

Token API AppOptics token. Doit être configuré par l'utilisateur avant de lancer le rôle.

swisnap_hostname_alias: ""

Alias d'hôte pour le serveur qui sera utilisé dans l'interface AppOptics.

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

Chemin vers le fichier de configuration principal de l'agent SolarWinds Snap.

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

Chemin vers les fichiers de configuration des plugins de l'agent SolarWinds Snap.

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

Chemin vers les fichiers de configuration du plugin éditeur AppOptics de l'agent SolarWinds Snap.

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

Chemin vers les fichiers de configuration des processus éditeurs de l'agent SolarWinds Snap.

swisnap_auto_discover_path: /opt/SolarWinds/Snap/autoload

Chemin vers le répertoire d'autoload de l'agent SolarWinds Snap pour les plugins V1.

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

Chemin vers les fichiers de tâches V2 de l'agent SolarWinds Snap.

swisnap_plugin_path: /opt/SolarWinds/Snap/bin

Chemin où sont stockés les binaires des plugins de l'agent SolarWinds Snap.

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

Chemin vers les fichiers de tâches V1 de l'agent SolarWinds Snap.

swisnap_service: swisnapd
swisnap_user: solarwinds
swisnap_user_group: solarwinds

Nom du service SolarWinds Snap Agent. Utilisateur et groupe sous lesquels le service fonctionnera.

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

Niveau de journalisation, chemin vers le fichier journal et format du journal.

swisnap_plugin_trust_level: ""
swisnap_keyring_paths: ""

Niveau de confiance des plugins pour swisnapd. Lorsqu'il est activé, seuls les plugins signés et vérifiables seront chargés dans swisnapd. Les signatures sont vérifiées à partir des fichiers de clé spécifiés dans swisnap_keyring_path. Valeurs valides : 0 - Désactivé, 1 - Activé, 2 - Avertissement. La valeur par défaut est 1 - Activé. Si cela n'est pas défini, l'agent utilisera le niveau activé par défaut.

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

Paramètres optionnels pour la communication sécurisée des plugins.

swisnap_plugin_load_timeout: ""

Le temps maximal autorisé pour le chargement d'un plugin. La valeur par défaut est 30.

swisnap_global_tags: {}

Étiquettes qui seront appliquées aux métriques collectées à travers les tâches.

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

Paramètres REST API optionnels. Par défaut, l'API REST est activée.

publisher_appoptics_url: ""
publisher_processes_url: ""

Ces paramètres peuvent remplacer l'URL par défaut pour les éditeurs.

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

Paramètres proxy optionnels.

swisnap_host_check_timeout: ""

swisnap_host_check_timeout permet de configurer un délai d'attente pour interroger le système d'exploitation de l'hôte pour obtenir des informations d'identification. La valeur par défaut est fixée à 5 secondes.

swisnap_ec2_check_timeout: ""

swisnap_ec2_check_timeout permet de configurer un délai d'attente pour interroger l'URL de métadonnées EC2 afin de déterminer si l'agent hôte fonctionne sur une instance EC2 (ou OpenStack). Par défaut, il est fixé à 1 seconde.

swisnap_ec2_check_retries: ""

swisnap_ec2_check_retries permet de configurer le nombre de tentatives pour interroger l'URL de métadonnées EC2 afin de déterminer si l'agent hôte fonctionne sur une instance EC2 (ou OpenStack). Par défaut, il est fixé à 3.

swisnap_floor_seconds: ""

Indique si les horodatages doivent être arrondis à un intervalle spécifique, la valeur par défaut est de 60 secondes.

swisnap_period: ""

Période d'intervalle des métriques à signaler à l'API AppOptics, la valeur par défaut est de 60 secondes.

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

Chemins vers les répertoires contenant des fichiers de configuration personnalisés pour les tâches et les plugins. Cela permet aux utilisateurs de configurer des plugins supplémentaires. Cela doit être le chemin vers un répertoire, par ex. /path/to/directory.

swisnap_win_installer_download_path: ""

Chemin pour télécharger le programme d'installation Windows. Doit être configuré par l'utilisateur avant de lancer le rôle sur la plateforme Windows.

swisnap_package_version: ""

Version spécifique du package à installer, par ex. 4.0.0.863. Cela fonctionne uniquement pour les plateformes Linux. Pour Windows, le dernier package est toujours installé.

Exemple de Playbook

Installez le rôle SolarWinds swisnap en utilisant Ansible Galaxy :

ansible-galaxy install solarwinds.swisnap

ou clonez ce dépôt dans le répertoire de vos rôles de 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

Dans vars/my_vars.yaml :

solarwinds_token: 123456789dbba089e9ff613bb9528320188853b1a08d91d23d2fc9bc1c41ec3e

Windows :

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

Dans vars/my_vars.yaml :

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

Dans inventory :

[windows]
1.2.3.4

Dans group_vars/windows :

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