zabbix_maintenance – Создание окон технического обслуживания Zabbix
Описание
- Этот модуль позволяет создавать окна технического обслуживания Zabbix.
Требования
Ниже перечислены требования к хосту, на котором будет выполняться этот модуль.
- python >= 2.6
- zabbix-api
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| collect_data boolean |
| Тип технического обслуживания. С сбором данных или без. |
| desc - / обязательно | Значение по умолчанию: "Создано Ansible" | Краткое описание окна технического обслуживания. |
| host_groups - | Группы хостов для управления окном технического обслуживания. Разделяйте несколько групп запятыми. host_group — псевдоним для host_groups. Обязательный параметр, когда state присутствует и не указан host_names. псевдонимы: host_group | |
| host_names - | Хосты для управления окном технического обслуживания. Разделяйте несколько хостов запятыми. host_name — псевдоним для host_names. Обязательный параметр, когда state присутствует и не указан host_groups. псевдонимы: host_name | |
| http_login_password строка добавлено в 2.1 | Пароль Basic Auth | |
| http_login_user строка / обязательно добавлено в 2.1 | Логин Basic Auth | |
| login_password строка / обязательно | Пароль пользователя Zabbix. | |
| login_user строка / обязательно | Имя пользователя Zabbix. | |
| minutes - | Значение по умолчанию: 10 | Длительность окна технического обслуживания в минутах. |
| name - / обязательно | Уникальное имя окна технического обслуживания. | |
| server_url строка / обязательно | URL сервера Zabbix, с протоколом (http или https). url — псевдоним для server_url.псевдонимы: url | |
| state - |
| Создать или удалить окно технического обслуживания. Окно технического обслуживания для удаления определяется по имени. |
| timeout целое число | Значение по умолчанию: 10 | Время ожидания запроса API (секунды). |
| validate_certs boolean добавлено в 2.5 |
| Если значение равно False, сертификаты SSL не будут проверены. Это следует использовать только на сайтах, контролируемых лично, с самозаверяющимися сертификатами. |
Примечания
Примечание
- Полезно для установки хостов в режим технического обслуживания перед большим обновлением и удаления окна технического обслуживания после обновления.
- Модуль создает окно технического обслуживания с текущего времени до текущего времени + количество минут, поэтому, если время сервера Zabbix и время хоста не синхронизированы, результаты будут странными.
- Установите необходимый модуль с помощью команды ‘pip install zabbix-api’.
Примеры
- 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. [community]
Авторы
- Александр Булимов (@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.8/modules/zabbix_maintenance_module.html
