zabbix_map – Создание/обновление/удаление карт Zabbix

• Обзор
• Требования
• Параметры
• Примеры
• Статус

Обзор

• Этот модуль позволяет создавать, изменять и удалять записи в картах 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
• pydotplus
• webcolors
• Pillow
• Graphviz

Параметры

Примеры

###
### 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 presents in Zabbix with same 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
  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

Статус

• Этот модуль не гарантирует обратной совместимости интерфейса. [превью]
• Этот модуль поддерживается сообществом Ansible. [сообщество]

Авторы

• Antony Alekseyev (@Akint)