zabbix_maintenance – Создание плановых остановов Zabbix
Новая версия 1.8.
Описание
- Этот модуль позволяет создавать плановые остановки 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 не будут проверены. Это следует использовать только на сайтах, контролируемых лично, с самозаверяющимися сертификатами. |
Примечания
Примечание
- Полезно для установки хостов в режим планового останова перед крупным обновлением и удаления планового останова после обновления.
- Модуль создаёт плановый останов с момента now() до now() + minutes, поэтому если время сервера 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. [сообщество]
Авторы
- Александр Булимов (@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.7/modules/zabbix_maintenance_module.html
