Cet article concerne l'écriture de playbooks simples et modifiables pour installer automatiquement les agents sur les hôtes Linux / Windows et enregistrer les hôtes via l'API Zabbix, y compris les hôtes SNMP. Les rôles et modules prêts à l'emploi d'Ansible Galaxy Zabbix seront utilisés.
Zabbix a préparé ses propres rôles et modules pour configurer de nombreux composants Zabbix via Ansible - une liste complète peut être trouvée ici .
Dans cet article, nous ne parlerons que de zabbix_agent et zabbix_host .
* Cet article ne couvre pas ou ne montre pas l'installation et la configuration d'Ansible, il y en a beaucoup sur Internet.
zabbix_agent
Il s'agit d'un rôle qui prend en charge l'installation de l'agent sur les systèmes d'exploitation suivants:
chapeau rouge
Feutre
Debian
Ubuntu
ouvre
Windows (meilleur effort)
macOS
Une liste à jour sur le github officiel du projet .
hôte_zabbix
Il s'agit d'un module pour ajouter / supprimer / modifier des hôtes sur le serveur zabbix. Une description complète du module est ici .
Alors passons à la configuration
La première étape consiste à installer la collection ansible (ne fonctionne que dans la version ansible 2.9+):
ansible-galaxy collection install community.zabbix
Après avoir installé la collection, créez un fichier avec un playbook. Ce playbook fait deux choses: il définit le rôle community.zabbix.zabbix_agent sur les hôtes spécifiés et dans la deuxième étape enregistre l'hôte dans zabbix via le module community.zabbix.zabbix_host.
zabbix-agent-all.yaml :
- hosts: all
tasks:
- name: Install agent
include_role:
name: community.zabbix.zabbix_agent #
tags:
- install #
- name: Create a new host or update an existing host's info # zabbix
local_action:
module: community.zabbix.zabbix_host # zabbix_host
server_url: "{{ zabbix_url }}" # - url API
login_user: "{{ zabbix_api_user }}" # - Admin
login_password: "{{ zabbix_api_pass }}" # -
host_name: "{{ item }}" - #
visible_name: "{{ hostvars[item].zabbix_visible_name | default(item) }}" #
description: "{{ hostvars[item].zabbix_host_description | default('') }} OS: {{ hostvars[item].ansible_distribution | default('') }} {{ hostvars[item].ansible_distribution_version | default('') }}" # ansible
host_groups: "{{ hostvars[item].zabbix_host_groups }}" #
link_templates: "{{ hostvars[item].zabbix_link_templates }}" # template
status: "{{ hostvars[item].zabbix_host_status }}" # - Enabled Disabled
state: present # ansible , absent
inventory_mode: disabled # inventory mode
interfaces: #
- type: "{{ hostvars[item].zabbix_interface_type }}" # - SNMP, Agent, JMX, IPMI
main: 1
useip: "{{ hostvars[item].zabbix_interface_use_ip }}" # ip dns
ip: "{{ hostvars[item].zabbix_interface_ip }}" # ip - ip
dns: "{{ item }}" # useip: 0 FQDN
port: "{{ hostvars[item].zabbix_interface_port }}" #
loop: "{{ groups['all'] }}" #
run_once: true # ,
tags:
- add-host #
, zabbix http, .., .
linux-inventory, windows-inventory snmp-inventory, , .
Linux
linux-inventory:
[all]
host1.local # FQDN IP-
host2.local zabbix_host_description=”The host2 description”
host3.local zabbix_host_status=disabled #
host4.local zabbix_host_groups=’["Custom group"]’ #
[all:vars]
zabbix_agent_server=my.zabbix.server #
zabbix_url=https://my.zabbix.server # URL
zabbix_api_use=true # API
zabbix_api_user=Admin
zabbix_api_pass=StrongPa$$w0rd
zabbix_interface_port="10050" #
zabbix_host_groups=["Linux servers"] #
zabbix_link_templates=["Linux by Zabbix agent"] # template
zabbix_interface_type=agent # -
zabbix_interface_use_ip="0" # dns fqdn
zabbix_interface_ip=""
zabbix_host_description="My linux server" #
zabbix_host_status=enabled #
Windows
Windows ansible - , ansible.
windows-inventory:
[all]
winhost01.local
winhost02.local zabbix_host_groups=’["Custom group"]’ #
winhost03.local zabbix_host_status=disabled #
[all:vars]
ansible_user=user@DOMAIN.LOCAL # , kerberos linux
ansible_password=StrongPa$$w0rd
ansible_connection=winrm # windows WinRM
ansible_winrm_server_cert_validation=ignore # , ignore
zabbix_agent_server=my.zabbix.server #
zabbix_url=https://my.zabbix.server # URL
zabbix_api_use=true # API
zabbix_api_user=Admin
zabbix_api_pass=StrongPa$$w0rd
zabbix_interface_port="10050" #
zabbix_host_groups=["Windows servers"] #
zabbix_link_templates=["Windows by Zabbix agent"] # template
zabbix_interface_type=agent # -
zabbix_interface_use_ip="0" # dns fqdn
zabbix_interface_ip=""
zabbix_host_description="My windows server" #
zabbix_host_status=enabled #
SNMP
SNMP snmp-inventory:
[all]
snmphost1.local zabbix_link_templates='["Cisco IOS SNMP","Network Generic Device SNMP"]' zabbix_host_groups='["Network devices"]'
snmp2.local zabbix_link_templates='["Template SNMP OS ESXi"]' zabbix_host_groups='["Hypervisors"]' zabbix_snmp_community=”Community”
[all:vars]
zabbix_url=https://my.zabbix.server # URL
zabbix_api_use=true # API
zabbix_api_user=Admin
zabbix_api_pass=StrongPa$$w0rd
zabbix_interface_port="161" # , 161
zabbix_interface_type=snmp # snmp
zabbix_interface_use_ip="0" # dns
zabbix_interface_ip="" # ip
zabbix_host_description="My SNMP host" #
zabbix_host_status=enabled #
zabbix_snmp_community="MyCommunity" # SNMP community
En conséquence, les fichiers doivent avoir la structure de fichiers suivante:
.
├── linux-inventory
├── snmp-inventory
├── windows-inventory
└── zabbix-agent-all.yaml
Lancer un playbook
Pour exécuter des playbooks, vous devez exécuter les commandes suivantes:
Pour installer sur des hôtes Linux:
ansible-playbook -i linux-inventory zabbix-agent-all.yaml
Les fenêtres:
ansible-playbook -i windows-inventory zabbix-agent-all.yaml
SNMP:
ansible-playbook -i snmp-inventory zabbix-agent-all.yaml
Si seule l'installation est nécessaire, vous pouvez exécuter les commandes ci-dessus avec la balise d'installation:
ansible-playbook -i linux-inventory zabbix-agent-all.yaml -t install
Si vous avez des paramètres zabbix spéciaux ou que vous souhaitez personnaliser, une liste complète des variables de rôle et de module est disponible sur la page du projet: zabbix_agent et zabbix_host
Toutes les sources de cet article sont sur github .