Модуль community.zabbix.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_sysmap содержит имя карты в 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 >= 3.9
• pydotplus
• webcolors
• Pillow
• Graphviz

Параметры

Примеры

# If you want to use Username and Password to be authenticated by Zabbix Server
- name: Set credentials to access Zabbix Server API
  ansible.builtin.set_fact:
    ansible_user: Admin
    ansible_httpapi_pass: zabbix

# If you want to use API token to be authenticated by Zabbix Server
# https://www.zabbix.com/documentation/current/en/manual/web_interface/frontend_sections/administration/general#api-tokens
- name: Set API token
  ansible.builtin.set_fact:
    ansible_zabbix_auth_key: 8ec0d52432c15c91fcafe9888500cf9a607f44091ab554dbee860f6b44fac895

###
### 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
  # set task level variables as we change ansible_connection plugin here
  vars:
    ansible_network_os: community.zabbix.zabbix
    ansible_connection: httpapi
    ansible_httpapi_port: 443
    ansible_httpapi_use_ssl: true
    ansible_httpapi_validate_certs: false
    ansible_zabbix_url_path: "zabbixeu"  # If Zabbix WebUI runs on non-default (zabbix) path ,e.g. http://<FQDN>/zabbixeu
    ansible_host: zabbix-example-fqdn.org
  community.zabbix.zabbix_map:
    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