community.zabbix.zabbix_screen – Создание/обновление/удаление экранов Zabbix
Примечание
Этот плагин входит в коллекцию community.zabbix (версия 1.1.0).
Для его установки используйте: ansible-galaxy collection install community.zabbix.
Для использования в книге задач укажите: community.zabbix.zabbix_screen.
Обзор
- Этот модуль позволяет создавать, изменять и удалять экраны Zabbix и связанные с ними графики.
Требования
Ниже перечислены требования, необходимые на хосте, на котором выполняется этот модуль.
- python >= 2.6
- zabbix-api >= 0.5.4
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии | |
|---|---|---|---|
| http_login_password строка | Пароль для Basic Auth | ||
| http_login_user строка | Логин для Basic Auth | ||
| login_password строка / обязательно | Пароль пользователя Zabbix. | ||
| login_user строка / обязательно | Имя пользователя Zabbix. | ||
| screens список / элементы=словарь / обязательно | Список экранов, которые нужно создать/обновить/удалить (см. пример). | ||
| graph_height целое число | Высота графика будет установлена в настройках графика. | ||
| graph_names список / элементы=строка | Имена графиков будут добавлены на экран. Регистронезависимо. Обязательно, если state=present. | ||
| graph_width целое число | Ширина графика будет установлена в настройках графика. | ||
| graphs_in_row целое число | По умолчанию: 3 | Ограничение столбцов экрана и создание нескольких строк. | |
| host_group список / элементы=строка | Группа(ы) хостов будут использоваться для поиска хостов. Обязательно, если state=present. псевдонимы: host_groups | ||
| screen_name строка / обязательно | Имя экрана будет использоваться. Если экран уже добавлен, его имя не будет обновлено. | ||
| sort логическое значение |
| Сортировка хостов в алфавитном порядке. Если в именах хостов есть цифры, должны использоваться ведущие нули. | |
| state строка |
|
present - Создает экран, если он не существует. Если экран уже существует, он будет обновлен по мере необходимости.
absent - Если экран существует, он будет удален. | |
| server_url строка / обязательно | URL сервера Zabbix с протоколом (http или https). url — псевдоним для server_url. псевдонимы: url | ||
| timeout целое число | По умолчанию: 10 | Таймаут запроса API (секунды). | |
| validate_certs логическое значение |
| Если установлено в значение False, сертификаты SSL не будут проверены. Это следует использовать только на сайтах, контролируемых лично, с использованием самозаверяющих сертификатов. | |
Примечания
Примечание
- Слишком много одновременных обновлений одного и того же экрана может привести к ошибкам возврата Zabbix, см. примеры для обходного пути, если это необходимо.
- Если вы используете login_password=zabbix, слово «zabbix» заменяется на «****» во всем выводе модуля, потому что login_password использует
no_log. См. эту страницу FAQ для получения дополнительной информации.
Примеры
# Create/update a screen.
- name: Create a new screen or update an existing screen's items 5 in a row
local_action:
module: community.zabbix.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: community.zabbix.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: community.zabbix.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]
# Create/update using multiple hosts_groups. Hosts NOT present in all listed host_groups will be skipped.
- name: Create new screen or update the existing screen's items for hosts in both given groups
local_action:
module: community.zabbix.zabbix_screen
server_url: http://monitor.example.com
login_user: username
login_password: password
screens:
- screen_name: ExampleScreen1
host_group:
- Example group1
- Example group2
state: present
graph_names:
- Example graph1
- Example graph2
graph_width: 200
graph_height: 100
Авторы
- Cove (@cove)
- Tony Minfei Ding (!UNKNOWN)
- 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.10/collections/community/zabbix/zabbix_screen_module.html
