Este artigo é sobre como escrever playbooks ansible simples para instalar automaticamente agentes em hosts Linux / Windows e registrar hosts por meio da API Zabbix, incluindo hosts SNMP. Serão usados funções e módulos prontos para o Ansible Galaxy Zabbix.
Zabbix preparou suas próprias funções e módulos para configurar muitos componentes do Zabbix via Ansible - uma lista completa pode ser encontrada aqui .
Neste artigo, falaremos apenas sobre zabbix_agent e zabbix_host .
* Este artigo não cobre ou mostra a instalação e configuração do Ansible, há muito disso na Internet.
zabbix_agent
Esta é uma função que oferece suporte à instalação do agente nos seguintes sistemas operacionais:
chapéu vermelho
Fedora
Debian
Ubuntu
opensuse
Windows (melhor esforço)
Mac OS
Uma lista atualizada no github oficial do projeto .
zabbix_host
Este é um módulo para adicionar / remover / alterar hosts no servidor zabbix. Uma descrição completa do módulo está aqui .
Então, vamos prosseguir com a configuração
O primeiro passo é instalar a coleção ansible (funciona apenas na versão 2.9+ do ansible):
ansible-galaxy collection install community.zabbix
Depois de instalar a coleção, crie um arquivo com um manual. Este manual faz duas coisas - define a função community.zabbix.zabbix_agent para os hosts especificados e, na segunda etapa, registra o host no zabbix por meio do módulo 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 #
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
Como resultado, os arquivos devem ter a seguinte estrutura de arquivo:
.
├── linux-inventory
├── snmp-inventory
├── windows-inventory
└── zabbix-agent-all.yaml
Lançamento de um manual
Para executar manuais, você precisa executar os seguintes comandos:
Para instalar em hosts Linux:
ansible-playbook -i linux-inventory zabbix-agent-all.yaml
Janelas:
ansible-playbook -i windows-inventory zabbix-agent-all.yaml
SNMP:
ansible-playbook -i snmp-inventory zabbix-agent-all.yaml
Se apenas a instalação for necessária, você pode executar os comandos acima com a tag de instalação:
ansible-playbook -i linux-inventory zabbix-agent-all.yaml -t install
Se você tem configurações especiais do zabbix ou deseja personalizar, uma lista completa de funções e variáveis de módulo pode ser encontrada na página do projeto: zabbix_agent e zabbix_host
Todas as fontes deste artigo estão no github .