zabbix_screen – Создание/обновление/удаление экранов Zabbix
Новое в версии 2.0.
Описание
- Этот модуль позволяет создавать, изменять и удалять экраны Zabbix и связанные графические данные.
Требования
Ниже приведены требования к хосту, на котором будет выполняться этот модуль.
- python >= 2.6
- zabbix-api
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| http_login_password - добавлен в 2.1 | Пароль для аутентификации Basic Auth | |
| http_login_user - добавлен в 2.1 | Логин для аутентификации Basic Auth | |
| login_password - / обязательно | Пароль пользователя Zabbix. | |
| login_user - / обязательно | Имя пользователя Zabbix. | |
| screens - / обязательно | Список экранов для создания/обновления/удаления (см. пример). Если экран(ы) уже добавлены, имя(на) экрана(ов) не будет обновлено. При создании или обновлении экрана(ов), screen_name, host_group являются обязательными.При удалении экрана(ов), необходимо screen_name. Опция graphs_in_row ограничит столбцы экрана и создаст несколько строк (по умолчанию 3).Доступные состояния: present (по умолчанию) и absent. Если экран(ы) уже существует(ют), и состояние не absent, экран(ы) будет(ют) обновлен(ы) по мере необходимости. | |
| server_url - / обязательно | URL сервера Zabbix, с протоколом (http или https). url является псевдонимом для server_url. псевдонимы: url | |
| timeout - | Значение по умолчанию: 10 | Таймаут запроса API (секунды). |
| validate_certs boolean добавлен в 2.5 |
| Если установлено в False, сертификаты SSL не будут проверены. Это следует использовать только на контролируемых вами сайтах с самоподписанными сертификатами. |
Примечания
Примечание
- Слишком много одновременных обновлений одного и того же экрана может привести к ошибкам Zabbix. Смотрите примеры для обхода этой проблемы, если это необходимо.
Примеры
# Create/update a screen.
- name: Create a new screen or update an existing screen's items 5 in a row
local_action:
module: zabbix_screen
server_url: http://monitor.example.com
login_user: username
login_password: password
screens:
- screen_name: ExampleScreen1
host_group: Example group1
state: present
graph_names:
- Example graph1
- Example graph2
graph_width: 200
graph_height: 100
graphs_in_row: 5
# Create/update multi-screen
- name: Create two of new screens or update the existing screens' items
local_action:
module: zabbix_screen
server_url: http://monitor.example.com
login_user: username
login_password: password
screens:
- screen_name: ExampleScreen1
host_group: Example group1
state: present
graph_names:
- Example graph1
- Example graph2
graph_width: 200
graph_height: 100
- screen_name: ExampleScreen2
host_group: Example group2
state: present
graph_names:
- Example graph1
- Example graph2
graph_width: 200
graph_height: 100
# Limit the Zabbix screen creations to one host since Zabbix can return an error when doing concurrent updates
- name: Create a new screen or update an existing screen's items
local_action:
module: zabbix_screen
server_url: http://monitor.example.com
login_user: username
login_password: password
state: present
screens:
- screen_name: ExampleScreen
host_group: Example group
state: present
graph_names:
- Example graph1
- Example graph2
graph_width: 200
graph_height: 100
when: inventory_hostname==groups['group_name'][0]
Статус
- Этот модуль не гарантирует обратную совместимость интерфейса. [превью]
- Этот модуль поддерживается сообществом Ansible. [сообщество]
Авторы
- (@cove)
- Tony Minfei Ding
- Harrison Gu (@harrisongu)
Подсказка
Если вы заметили какие-либо проблемы в этой документации, вы можете редактировать этот документ, чтобы улучшить его.
© 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_screen_module.html
