zabbix_host - Создание/обновление/удаление хостов Zabbix
Новая версия с 2.0.
Обзор
- Этот модуль позволяет создавать, изменять и удалять записи о хостах Zabbix, а также связанные группы и шаблоны данных.
Требования
Ниже приведены требования к хосту, на котором выполняется этот модуль.
- python >= 2.6
- zabbix-api >= 0.5.3
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| описание (добавлено в 2.5) | Описание хоста в Zabbix. | |
| force (добавлено в 2.0) |
| Перезаписать конфигурацию хоста, даже если она уже существует |
| host_groups | Список групп хостов, к которым принадлежит хост. | |
| host_name обязательно | Имя хоста в Zabbix. host_name является уникальным идентификатором и не может быть обновлён с помощью этого модуля. | |
| http_login_password (добавлено в 2.1) | Значение по умолчанию: None | Пароль Basic Auth |
| http_login_user (добавлено в 2.1) | Значение по умолчанию: None | Логин Basic Auth |
| interfaces | Значение по умолчанию: [] | Список интерфейсов, которые нужно создать для хоста (см. пример ниже). Доступные ключи: dns, ip, main, port, type, useip и bulk. Для получения дополнительной информации о поддерживаемых свойствах, пожалуйста, ознакомьтесь с документацией по интерфейсу https://www.zabbix.com/documentation/2.0/manual/appendix/api/hostinterface/definitions#host_interface Если определение интерфейса неполное, этот модуль попытается заполнить разумные значения.
type также может быть agent, snmp, ipmi, или jmx вместо его числового значения. |
| inventory_mode (добавлено в 2.1) |
| Настройка режима инвентаризации. |
| inventory_zabbix (добавлено в 2.5) | Добавить Факты для инвентаризации Zabbix (например, тег) (см. пример ниже). Для получения дополнительной информации о поддерживаемых свойствах, пожалуйста, ознакомьтесь с документацией по интерфейсу https://www.zabbix.com/documentation/3.2/manual/api/reference/host/object#host_inventory | |
| ipmi_authtype (добавлено в 2.5) | Алгоритм аутентификации IPMI. Для получения дополнительной информации о поддерживаемых свойствах, пожалуйста, ознакомьтесь с документацией по объекту хост https://www.zabbix.com/documentation/3.4/manual/api/reference/host/object Возможные значения: 0 (none), 1 (MD2), 2 (MD5), 4 (straight), 5 (OEM), 6 (RMCP+), где -1 — значение по умолчанию API.Обратите внимание, что Zabbix API будет использовать значения по умолчанию, если настройки отсутствуют при обновлении параметров ipmi_; это означает, что если вы попытаетесь установить любой из четырёх параметров индивидуально, остальные будут сброшены до значений по умолчанию. | |
| ipmi_password (добавлено в 2.5) | Пароль IPMI. также см. последнее примечание в документации по ipmi_authtype | |
| ipmi_privilege (добавлено в 2.5) | Уровень привилегий IPMI. Для получения дополнительной информации о поддерживаемых свойствах, пожалуйста, ознакомьтесь с документацией по объекту хост https://www.zabbix.com/documentation/3.4/manual/api/reference/host/object Возможные значения: 1 (callback), 2 (user), 3 (operator), 4 (admin), 5 (OEM), где 2 — значение по умолчанию API.также см. последнее примечание в документации по ipmi_authtype | |
| ipmi_username (добавлено в 2.5) | Имя пользователя IPMI. также см. последнее примечание в документации по ipmi_authtype | |
| link_templates | Значение по умолчанию: None | Список шаблонов, связанных с хостом. |
| login_password обязательно | Пароль пользователя Zabbix. | |
| login_user обязательно | Имя пользователя Zabbix. | |
| proxy | Значение по умолчанию: None | Имя Zabbix Proxy, который необходимо использовать |
| server_url обязательно | URL сервера Zabbix с протоколом (http или https). url — псевдоним для server_url. псевдонимы: url | |
| state |
| Состояние хоста. В present, он будет создан, если хост не существует, или обновлен, если связанные данные отличаются.В absent, он удалит хост, если он существует. |
| status |
| Статус мониторинга хоста. |
| timeout | Значение по умолчанию: 10 | Таймаут запроса API (секунды). |
| tls_accept (добавлен в 2.5) | Значение по умолчанию: 1 | Указывает типы соединений, разрешённых для входящих соединений. Параметр tls_accept принимает значения от 1 до 7 Возможные значения: 1 (без шифрования), 2 (PSK), 4 (сертификат). Значения можно комбинировать. Работает только с >= Zabbix 3.0 |
| tls_connect (добавлен в 2.5) | Значение по умолчанию: 1 | Указывает тип шифрования для исходящих соединений. Параметр tls_connect принимает значения от 1 до 7 Возможные значения: 1 (без шифрования), 2 (PSK), 4 (сертификат). Значения можно комбинировать. Работает только с >= Zabbix 3.0 |
| tls_issuer (добавлен в 2.5) | Требуемый издатель сертификата. Работает только с >= Zabbix 3.0 | |
| tls_psk (добавлен в 2.5) | Предопределённый ключ (минимум 32 шестнадцатеричных цифры). Требуется, если tls_connect или tls_accept имеют включённый PSK. Работает только с >= Zabbix 3.0 | |
| tls_psk_identity (добавлен в 2.5) | Значение PSK — сложно угадываемая строка шестнадцатеричных цифр. Это уникальное имя, по которому Zabbix-компоненты ссылаются на этот конкретный PSK. Не вставляйте конфиденциальную информацию в строку идентификатора PSK, она передаётся по сети без шифрования. Работает только с >= Zabbix 3.0 | |
| tls_subject (добавлен в 2.5) | Требуемый субъект сертификата. Работает только с >= Zabbix 3.0 | |
| validate_certs (добавлен в 2.5) |
yes | Если установлено False, SSL-сертификаты не будут проверены. Это следует использовать только на сайтах, контролируемых лично, с самозаверяющимися сертификатами. |
| visible_name (добавлен в 2.3) | Видимое имя хоста в Zabbix. |
Примеры
- name: Create a new host or update an existing host's info
local_action:
module: zabbix_host
server_url: http://monitor.example.com
login_user: username
login_password: password
host_name: ExampleHost
visible_name: ExampleName
description: My ExampleHost Description
host_groups:
- Example group1
- Example group2
link_templates:
- Example template1
- Example template2
status: enabled
state: present
inventory_mode: manual
inventory_zabbix:
tag: "{{ your_tag }}"
alias: "{{ your_alias }}"
notes: "Special Informations: {{ your_informations | default('None') }}"
location: "{{ your_location }}"
site_rack: "{{ your_site_rack }}"
os: "{{ your_os }}"
hardware: "{{ your_hardware }}"
ipmi_authtype: 2
ipmi_privilege: 4
ipmi_username: username
ipmi_password: password
interfaces:
- type: 1
main: 1
useip: 1
ip: 10.xx.xx.xx
dns: ""
port: 10050
- type: 4
main: 1
useip: 1
ip: 10.xx.xx.xx
dns: ""
port: 12345
proxy: a.zabbix.proxy
- name: Update an existing host's TLS settings
local_action:
module: zabbix_host
server_url: http://monitor.example.com
login_user: username
login_password: password
host_name: ExampleHost
visible_name: ExampleName
host_groups:
- Example group1
tls_psk_identity: test
tls_connect: 2
tls_psk: 123456789abcdef123456789abcdef12
Статус
Этот модуль помечен как предварительный, что означает, что он не гарантирует обратную совместимость.
Автор
- (@cove)
- Tony Minfei Ding
- Harrison Gu (@harrisongu)
- Werner Dijkerman
- Eike Frost (@eikef)
Подсказка
Если вы обнаружите какие-либо проблемы в этом руководстве, вы можете отредактировать этот документ, чтобы улучшить его.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.5/modules/zabbix_host_module.html
