zabbix_maintenance – Создание окон технического обслуживания Zabbix
Описание
- Этот модуль позволяет создавать окна технического обслуживания Zabbix.
Требования
Ниже перечислены требования к хосту, на котором будет выполняться этот модуль.
- python >= 2.6
- zabbix-api >= 0.5.4
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| collect_data boolean |
| Тип технического обслуживания. С сбором данных или без него. |
| 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 / обязательно | Пароль пользователя Zabbix. | |
| login_user string / обязательно | Имя пользователя Zabbix. | |
| minutes integer | Значение по умолчанию: 10 | Продолжительность окна технического обслуживания в минутах. |
| name string / обязательно | Уникальное имя окна технического обслуживания. | |
| server_url string / обязательно | URL сервера Zabbix, с протоколом (http или https). url — псевдоним для server_url. Псевдонимы: url | |
| state string |
| Создать или удалить окно технического обслуживания. Окно технического обслуживания для удаления определяется по имени. |
| timeout integer | Значение по умолчанию: 10 | Таймаут запроса API (секунды). |
| validate_certs boolean добавлен в 2.5 |
| Если установлено в False, сертификаты SSL не будут проверены. Это следует использовать только на управляемых сайтах, использующих самозаверяемые сертификаты. |
Примечания
Примечание
- Полезно для установки хостов в режим технического обслуживания перед большим обновлением и удаления окна технического обслуживания после обновления.
- Модуль создает окно технического обслуживания с текущего времени до текущего времени + минуты, поэтому если время сервера 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
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
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.
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
zabbix_maintenance:
name: Test1
state: absent
server_url: https://monitoring.example.com
login_user: ansible
login_password: pAsSwOrD
Статус
- Интерфейс этого модуля не гарантированно совместим со старыми версиями. [превью]
- Этот модуль поддерживается сообществом Ansible. [сообщество]
Авторы
- Александр Булимов (@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.9/modules/zabbix_maintenance_module.html
