community.zabbix.zabbix_maintenance – Создание временных планов технического обслуживания Zabbix

Примечание

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

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

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

Описание
Требования
Параметры
Примечания
Примеры

Описание

Этот модуль позволяет создавать временные планы технического обслуживания Zabbix.

Требования

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

python >= 2.6
zabbix-api >= 0.5.4

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
collect_data boolean	Варианты: no yes ←	Тип технического обслуживания. С сбором данных или без.
desc string	Значение по умолчанию: "Создано Ansible"	Краткое описание временного плана технического обслуживания.
host_groups list / elements=string		Группы хостов для управления временным планом технического обслуживания. Обязательный параметр, когда state=present и host_names не используется. псевдонимы: host_group
host_names list / elements=string		Хосты для управления временным планом технического обслуживания. Обязательный параметр, когда state=present и host_groups не используется. псевдонимы: host_name
http_login_password string		Пароль аутентификации Basic.
http_login_user string		Логин аутентификации Basic.
login_password string / required		Пароль пользователя Zabbix.
login_user string / required		Имя пользователя Zabbix.
minutes integer	Значение по умолчанию: 10	Длительность временного плана технического обслуживания в минутах.
name string / required		Уникальное имя временного плана технического обслуживания.
server_url string / required		URL сервера Zabbix, с протоколом (http или https). `url` является псевдонимом `server_url`. псевдонимы: url
state string	Варианты: present ← absent	Создание или удаление временного плана технического обслуживания. Временный план технического обслуживания для удаления определяется по имени.
timeout integer	Значение по умолчанию: 10	Таймаут запроса API (секунды).
validate_certs boolean	Варианты: no yes ←	Если установлено в False, сертификаты SSL не будут проверены. Это следует использовать только на управляемых вами сайтах, использующих самозаверенные сертификаты.

Примечания

Примечание

Полезно для установки хостов в режим технического обслуживания перед крупным обновлением и удаления временного плана технического обслуживания после обновления.
Модуль создает временный план технического обслуживания с момента now() до now() + minutes, поэтому если время на сервере Zabbix и время на хосте не синхронизированы, вы получите странные результаты.
Установите необходимый модуль командой «pip install zabbix-api».
Если вы используете login_password=zabbix, слово «zabbix» заменяется на «****» во всем выводе модуля, так как login_password использует no_log. См. данный FAQ для получения дополнительной информации.

Примеры

- name: Create a named maintenance window for host www1 for 90 minutes
  community.zabbix.zabbix_maintenance:
    name: Update of www1
    host_name: www1.example.com
    state: present
    minutes: 90
    server_url: https://monitoring.example.com
    login_user: ansible
    login_password: pAsSwOrD

- name: Create a named maintenance window for host www1 and host groups Office and Dev
  community.zabbix.zabbix_maintenance:
    name: Update of www1
    host_name: www1.example.com
    host_groups:
      - Office
      - Dev
    state: present
    server_url: https://monitoring.example.com
    login_user: ansible
    login_password: pAsSwOrD

- name: Create a named maintenance window for hosts www1 and db1, without data collection.
  community.zabbix.zabbix_maintenance:
    name: update
    host_names:
      - www1.example.com
      - db1.example.com
    state: present
    collect_data: False
    server_url: https://monitoring.example.com
    login_user: ansible
    login_password: pAsSwOrD

- name: Remove maintenance window by name
  community.zabbix.zabbix_maintenance:
    name: Test1
    state: absent
    server_url: https://monitoring.example.com
    login_user: ansible
    login_password: pAsSwOrD

Авторы

Александр Булимов (@abulimov)

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