community.zabbix.zabbix_map – Создание/обновление/удаление карт Zabbix
Примечание
Этот плагин входит в коллекцию community.zabbix (версия 1.1.0).
Для его установки используйте: ansible-galaxy collection install community.zabbix.
Для использования в книге задач укажите: community.zabbix.zabbix_map.
Описание
- Этот модуль позволяет создавать, изменять и удалять записи карт Zabbix, используя двоичные файлы Graphviz и текстовое описание, написанное на языке DOT. Узлы графа будут отображаться как элементы карты, а рёбра – как связи между элементами карты. Подробности см. в https://en.wikipedia.org/wiki/DOT_(graph_description_language) и https://www.graphviz.org/. На основе http://blog.zabbix.com/maps-for-the-lazy/.
- Поддерживаются следующие дополнительные атрибуты узлов:
zbx_hostсодержит имя хоста в Zabbix. Используйте его, если желаемый тип элемента карты –host.zbx_groupсодержит имя группы хостов в Zabbix. Используйте его, если желаемый тип элемента карты –host group.zbx_mapсодержит имя карты в Zabbix. Используйте его, если желаемый тип элемента карты –map.zbx_labelсодержит метку элемента карты.zbx_imageсодержит имя изображения, используемого для отображения элемента в стандартном состоянии.zbx_image_disabledсодержит имя изображения, используемого для отображения отключённого элемента карты.zbx_image_maintenanceсодержит имя изображения, используемого для отображения элемента карты в режиме технического обслуживания.zbx_image_problemсодержит имя изображения, используемого для отображения элемента карты с проблемами.zbx_urlсодержит URL элемента карты в форматеname:url. Можно указать несколько URL, добавив постфикс (например,zbx_url1,zbx_url2). - Поддерживаются следующие дополнительные атрибуты связей:
zbx_draw_styleсодержит стиль отображения линии связи. Возможные значения:line,bold,dotted,dashed.zbx_triggerсодержит имя триггера, используемого в качестве индикатора связи в форматеhost_name:trigger_name. Можно указать несколько триггеров, добавив постфикс (например,zbx_trigger1,zbx_trigger2).zbx_trigger_colorсодержит цвет индикатора, указанный либо как имя CSS3, либо как шестнадцатеричный код, начинающийся с#.zbx_trigger_draw_styleсодержит стиль отображения индикатора. Возможные значения такие же, как и дляzbx_draw_style.
Требования
Ниже перечислены требования к хосту, на котором выполняется этот модуль.
- python >= 2.6
- zabbix-api >= 0.5.4
- pydotplus
- webcolors
- Pillow
- Graphviz
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| data строка | Граф, написанный на языке DOT. псевдонимы: dot_data | |
| default_image строка | Имя изображения Zabbix, используемого для отображения элемента, если у этого элемента нет атрибута zbx_image. псевдонимы: image | |
| expand_problem логическое |
| Определяет, будет ли отображаться триггер проблемы для элементов с одной проблемой. |
| height целое число | По умолчанию: 600 | Высота карты. |
| highlight логическое |
| Включено ли выделение значка. |
| http_login_password строка | Пароль авторизации Basic. | |
| http_login_user строка | Логин авторизации Basic. | |
| label_type строка |
| Тип метки элемента карты. |
| login_password строка / обязательно | Пароль пользователя Zabbix. | |
| login_user строка / обязательно | Имя пользователя Zabbix. | |
| margin целое число | По умолчанию: 40 | Размер пробела между границами карты и её элементами. |
| name строка / обязательно | Имя карты. псевдонимы: map_name | |
| server_url строка / обязательно | URL сервера Zabbix с протоколом (http или https). url – псевдоним для server_url. псевдонимы: url | |
| state строка |
| Состояние карты. При значении present, карта будет создана, если она не существует, или обновлена, если связанные данные отличаются.При значении absent, карта будет удалена, если она существует. |
| timeout целое число | По умолчанию: 10 | Таймаут запроса API (секунды). |
| validate_certs логическое |
| Если установлено в значение False, сертификаты SSL не будут проверены. Это следует использовать только на контролируемых вами сайтах с самозаверяющимися сертификатами. |
| width целое число | По умолчанию: 800 | Ширина карты. |
Примечания
Примечание
- Если вы используете login_password=zabbix, слово “zabbix” заменяется на “****” во всем выводе модуля, потому что login_password использует
no_log. Дополнительную информацию см. в этом FAQ.
Примеры
###
### Example inventory:
# [web]
# web[01:03].example.com ansible_host=127.0.0.1
# [db]
# db.example.com ansible_host=127.0.0.1
# [backup]
# backup.example.com ansible_host=127.0.0.1
###
### Each inventory host is present in Zabbix with a matching name.
###
### Contents of 'map.j2':
# digraph G {
# graph [layout=dot splines=false overlap=scale]
# INTERNET [zbx_url="Google:https://google.com" zbx_image="Cloud_(96)"]
# {% for web_host in groups.web %}
# {% set web_loop = loop %}
# web{{ '%03d' % web_loop.index }} [zbx_host="{{ web_host }}"]
# INTERNET -> web{{ '%03d' % web_loop.index }} [zbx_trigger="{{ web_host }}:Zabbix agent on {HOST.NAME} is unreachable for 5 minutes"]
# {% for db_host in groups.db %}
# {% set db_loop = loop %}
# web{{ '%03d' % web_loop.index }} -> db{{ '%03d' % db_loop.index }}
# {% endfor %}
# {% endfor %}
# { rank=same
# {% for db_host in groups.db %}
# {% set db_loop = loop %}
# db{{ '%03d' % db_loop.index }} [zbx_host="{{ db_host }}"]
# {% for backup_host in groups.backup %}
# {% set backup_loop = loop %}
# db{{ '%03d' % db_loop.index }} -> backup{{ '%03d' % backup_loop.index }} [color="blue"]
# {% endfor %}
# {% endfor %}
# {% for backup_host in groups.backup %}
# {% set backup_loop = loop %}
# backup{{ '%03d' % backup_loop.index }} [zbx_host="{{ backup_host }}"]
# {% endfor %}
# }
# }
###
### Create Zabbix map "Demo Map" made of template 'map.j2'
- name: Create Zabbix map
community.zabbix.zabbix_map:
server_url: http://zabbix.example.com
login_user: username
login_password: password
name: Demo map
state: present
data: "{{ lookup('template', 'map.j2') }}"
default_image: Server_(64)
expand_problem: no
highlight: no
label_type: label
delegate_to: localhost
run_once: yes
Авторы
- Antony Alekseyev (@Akint)
© 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_map_module.html