zabbix_screen – Создание/обновление/удаление экранов Zabbix
Описание
- Этот модуль позволяет создавать, изменять и удалять экраны Zabbix и связанные данные графиков.
Требования
Ниже перечислены требования, необходимые на хосте, на котором выполняется этот модуль.
- python >= 2.6
- zabbix-api >= 0.5.4
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии | |
|---|---|---|---|
| http_login_password строка | Пароль для базовой аутентификации | ||
| http_login_user строка / обязательно | Логин для базовой аутентификации | ||
| login_password строка / обязательно | Пароль пользователя Zabbix. | ||
| login_user строка / обязательно | Имя пользователя Zabbix. | ||
| screens список / элементы=словарь / обязательно | Список экранов для создания/обновления/удаления (см. пример). | ||
| graph_height целое число | Высота графика будет установлена в настройках графика. | ||
| graph_names список / элементы=строка | Названия графиков будут добавлены на экран. Регистронезависимо. Требуется, если state=present. | ||
| graph_width целое число | Ширина графика будет установлена в настройках графика. | ||
| graphs_in_row целое число | Значение по умолчанию: 3 | Ограничение столбцов экрана и создание нескольких строк. | |
| host_group строка | Группа хостов будет использована для поиска хостов. Требуется, если state=present. | ||
| screen_name строка / обязательно | Будет использовано имя экрана. Если экран уже добавлен, имя экрана не будет обновлено. | ||
| sort логическое |
| Сортировать хосты по алфавиту. Если в именах хостов есть цифры, следует использовать ведущий ноль. | |
| state строка |
|
present - Создать экран, если он не существует. Если экран уже существует, он будет обновлен по мере необходимости.
absent - Если экран существует, он будет удален. | |
| server_url строка / обязательно | URL сервера Zabbix, с протоколом (http или https). url — псевдоним для server_url. псевдонимы: url | ||
| timeout целое число | Значение по умолчанию: 10 | Таймаут запроса к API (секунды). | |
| validate_certs логическое добавлено в 2.5 |
| Если значение равно 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: 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 (@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.9/modules/zabbix_screen_module.html