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

Примечание

Этот плагин входит в коллекцию community.zabbix (версия 1.1.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 строка	Значение по умолчанию: "Создано Ansible"	Краткое описание окна технического обслуживания.
host_groups список / элементы=строка		Группы хостов для управления окном технического обслуживания. Требуемый параметр, когда state=present и host_names не используется. Псевдонимы: host_group
host_names список / элементы=строка		Хосты для управления окном технического обслуживания. Требуемый параметр, когда state=present и host_groups не используется. Псевдонимы: host_name
http_login_password строка		Пароль авторизации Basic.
http_login_user строка		Логин авторизации Basic.
login_password строка / обязательно		Пароль пользователя Zabbix.
login_user строка / обязательно		Имя пользователя Zabbix.
minutes целое число	Значение по умолчанию: 10	Длительность окна технического обслуживания в минутах.
name строка / обязательно		Уникальное имя окна технического обслуживания.
server_url строка / обязательно		URL сервера Zabbix, с протоколом (http или https). `url` является псевдонимом для `server_url`. Псевдонимы: url
state строка	Варианты: present ← absent	Создать или удалить окно технического обслуживания. Окно технического обслуживания для удаления определяется по имени.
timeout целое число	Значение по умолчанию: 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–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/community/zabbix/zabbix_maintenance_module.html