community.zabbix.zabbix_host_info – Сбор информации о хосте Zabbix

Примечание

Этот плагин входит в коллекцию community.zabbix (версия 1.1.0).

Для его установки используйте: ansible-galaxy collection install community.zabbix.

Для использования в книге задач укажите: community.zabbix.zabbix_host_info.

Обзор
Требования
Параметры
Примечания
Примеры
Возвращаемые значения

Обзор

Этот модуль позволяет искать записи о хостах Zabbix.
Этот модуль назывался zabbix_host_facts до Ansible 2.9. Способ использования не изменился.

Требования

Ниже приведены требования, необходимые на хосте, на котором выполняется этот модуль.

python >= 2.6
zabbix-api >= 0.5.4

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
exact_match boolean	Варианты: нет ← да	Найти точное совпадение
host_inventory список / элементы=строка		Список ключей инвентаризации хостов для отображения в результате. Вся инвентаризация хостов извлекается, если ключи не указаны.
host_ip список / элементы=строка		IP-адрес сетевого интерфейса хоста в Zabbix. Необходимо, когда host_name не используется.
host_name строка		Имя хоста в Zabbix. host_name — уникальный идентификатор, который нельзя обновить с помощью этого модуля. Необходимо, когда host_ip не используется.
http_login_password строка		Пароль для аутентификации Basic Auth
http_login_user строка		Логин для аутентификации Basic Auth
login_password строка / требуется		Пароль пользователя Zabbix.
login_user строка / требуется		Имя пользователя Zabbix.
remove_duplicate boolean	Варианты: нет да ←	Удалить дубликаты хостов из результата поиска
server_url строка / требуется		URL сервера Zabbix, с протоколом (http или https). `url` — псевдоним для `server_url`. псевдонимы: url
timeout целое число	По умолчанию: 10	Таймаут запроса API (секунды).
validate_certs boolean	Варианты: нет да ←	Если установлено в значение False, сертификаты SSL не будут проверяться. Это следует использовать только на управляемых вами сайтах с самозаверяющимися сертификатами.

Примечания

Примечание

Если вы используете login_password=zabbix, слово «zabbix» заменяется на «****» во всем выводе модуля, так как login_password использует no_log. Дополнительную информацию см. в этой справке.

Примеры

- name: Get host info
  local_action:
    module: community.zabbix.zabbix_host_info
    server_url: http://monitor.example.com
    login_user: username
    login_password: password
    host_name: ExampleHost
    host_ip: 127.0.0.1
    timeout: 10
    exact_match: no
    remove_duplicate: yes

- name: Reduce host inventory information to provided keys
  local_action:
    module: community.zabbix.zabbix_host_info
    server_url: http://monitor.example.com
    login_user: username
    login_password: password
    host_name: ExampleHost
    host_inventory:
      - os
      - tag
    host_ip: 127.0.0.1
    timeout: 10
    exact_match: no
    remove_duplicate: yes

Возвращаемые значения

Общие возвращаемые значения описаны здесь, следующие — поля, уникальные для данного модуля:

Ключ	Возвращаемое	Описание
hosts словарь	успех	Список хостов Zabbix. См. https://www.zabbix.com/documentation/4.0/manual/api/reference/host/get для списка значений хоста. Пример: [{'...': None, 'available': '1', 'description': '', 'disable_until': '0', 'error': '', 'flags': '0', 'groups': ['1'], 'host': 'Host A'}]

Авторы

Michael Miko (@RedWhiteMiko)

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/community/zabbix/zabbix_host_info_module.html