この記事は、Linux / Windowsホストにエージェントを自動的にインストールし、SNMPホストを含むZabbixAPIを介してホストを登録するための簡単なansibleプレイブックの作成について説明しています。Ansible GalaxyZabbixの既製の役割とモジュールが使用されます。
Zabbixは、Ansibleを介して多くのZabbixコンポーネントを構成するための独自の役割とモジュールを用意しています。完全なリストはここにあります。
この記事では、zabbix_agentとzabbix_hostについてのみ説明します。
*この記事では、Ansibleのインストールと構成については説明または示していません。これは、インターネット上にたくさんあります。
zabbix_agent
これは、次のオペレーティングシステムへのエージェントのインストールをサポートする役割です。
Red Hat
Fedora
Debian
Ubuntu
opensuse
Windows(ベストエフォート)
マックOS
zabbix_host
これは、zabbixサーバー上のホストを追加/削除/変更するためのモジュールです。モジュールの完全な説明はここにあります。
それでは、セットアップに移りましょう
最初のステップは、ansibleコレクションをインストールすることです(ansibleバージョン2.9以降でのみ機能します)。
ansible-galaxy collection install community.zabbix
コレクションをインストールした後、プレイブックを使用してファイルを作成します。このプレイブックは2つのことを行います。community.zabbix.zabbix_agentロールを指定されたホストに設定し、2番目のステップでcommunity.zabbix.zabbix_hostモジュールを介してホストをzabbixに登録します。
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
結果として、ファイルは次のファイル構造を持つ必要があります。
.
├── linux-inventory
├── snmp-inventory
├── windows-inventory
└── zabbix-agent-all.yaml
プレイブックの立ち上げ
プレイブックを実行するには、次のコマンドを実行する必要があります。
Linuxホストにインストールするには:
ansible-playbook -i linux-inventory zabbix-agent-all.yaml
ウィンドウズ:
ansible-playbook -i windows-inventory zabbix-agent-all.yaml
SNMP:
ansible-playbook -i snmp-inventory zabbix-agent-all.yaml
インストールのみが必要な場合は、installタグを使用して上記のコマンドを実行できます。
ansible-playbook -i linux-inventory zabbix-agent-all.yaml -t install
特別なzabbix設定がある場合、またはカスタマイズしたい場合は、ロール変数とモジュール変数の完全なリストがプロジェクトページにあります:zabbix_agentおよびzabbix_host