IKuznetsov: Новая страница: «= Интеграция Zabbix с Ключ-АСТРОМ = Расширение: `ru.ruscomtech.python.zabbix` Версия: 0.1.27 Минимальная версия Ключ-АСТРОМ: 1.285.0 == Назначение == Расширение интегрирует данные '''Zabbix''' в платформу Ключ-АСТРОМ, обеспечивая единое окно наблюдаемости для гибридных сред,...»

2026-08-25T22:56:51Z

Новая страница: «= Интеграция Zabbix с Ключ-АСТРОМ = Расширение: <code>ru.ruscomtech.python.zabbix</code> Версия: 0.1.27 Минимальная версия Ключ-АСТРОМ: 1.285.0 == Назначение == Расширение интегрирует данные '''Zabbix''' в платформу Ключ-АСТРОМ, обеспечивая единое окно наблюдаемости для гибридных сред,...»

Новая страница

= Интеграция Zabbix с Ключ-АСТРОМ =
Расширение: <code>ru.ruscomtech.python.zabbix</code>

Версия: 0.1.27

Минимальная версия Ключ-АСТРОМ: 1.285.0

== Назначение ==
Расширение интегрирует данные '''Zabbix''' в платформу Ключ-АСТРОМ, обеспечивая единое окно наблюдаемости для гибридных сред, где часть инфраструктуры мониторится только через '''Zabbix'''. Оно не заменяет '''Zabbix''', а делает его данные доступными в Ключ-АСТРОМ для корреляции, анализа ИИ и визуализации.

Основные задачи:

* Синхронизация хостов, групп хостов и проблем '''Zabbix''' как кастомных сущностей и событий в Ключ-АСТРОМ.
* Экспорт числовых метрик '''Zabbix''' в формате пользовательских метрик Ключ-АСТРОМ.
* Привязка проблем '''Zabbix''' к существующим сущностям Ключ-АСТРОМ (хостам, сервисам и др.) по IP или через тег с entity selector.
* Поддержка фильтрации по host group, тегам проблем и ключам метрик (включая регулярные выражения).

== Архитектура и сущности ==
Расширение создаёт следующие типы кастомных сущностей в Ключ-АСТРОМ:
{| class="wikitable"
!Тип сущности
!Идентификатор
!Описание
|-
|Zabbix Server
|<code>zabbix:server</code>
|Представляет один '''Zabbix'''-сервер
|-
|Host Group
|<code>zabbix:hostgroup</code>
|Группа хостов из '''Zabbix'''
|-
|Host in Group
|<code>zabbix:host_on_group</code>
|Промежуточная связь между хостом и группой
|-
|Host
|<code>zabbix:host</code>
|Отдельный хост '''Zabbix'''
|}
Сущности связаны отношениями:

* <code>zabbix:hostgroup</code> → <code>CHILD_OF</code> → <code>zabbix:server</code>
* <code>zabbix:host_on_group</code> → <code>CHILD_OF</code> → <code>zabbix:hostgroup</code>
* <code>zabbix:host_on_group</code> → <code>CALLS</code> → <code>zabbix:host</code>

Для сущности <code>zabbix:host</code> могут быть заполнены:

* IP-адрес (из item’а <code>interfaces</code> или '''Zabbix API''')
* Поля инвентаря (при включении соответствующих флагов в <code>inventory_keys</code>)
* '''Zabbix'''-теги как строковое свойство <code>zabbix_tags</code>

== Синхронизация проблем ==
Проблемы '''Zabbix''' (триггеры в состоянии <code>PROBLEM</code>) передаются в Ключ-АСТРОМ как события с типом <code>CUSTOM_ALERT</code>.

=== Severity mapping ===
Уровни серьёзности '''Zabbix''' сопоставляются уровням проблем Ключ-АСТРОМ через настройки:
{| class="wikitable"
!Zabbix severity
!Dynatrace problem level
|-
|<code>zbx2dt_disaster</code>
|Availability
|-
|<code>zbx2dt_high</code>
|Error
|-
|<code>zbx2dt_average</code>
|Slowdown
|-
|<code>zbx2dt_warning</code>
|Resource
|-
|<code>zbx2dt_information</code>, <code>zbx2dt_not_classified</code>
|Suppress (по умолчанию)
|}
Сопоставление можно изменить в разделе '''Advanced configuration'''.

=== Привязка к существующим сущностям ===
По умолчанию проблема привязывается к сущности <code>zabbix:host</code>. Для привязки к другим объектам используется тег в '''Zabbix''':

* В конфигурации расширения задаётся имя тега: параметр '''Zabbix tag for Dynatrace entities''' (<code>tag_entities</code>, по умолчанию <code>DT_Entity</code>).
* В '''Zabbix''' на триггере/шаблоне/хосте добавляется тег с этим ключом.
* Значение тега должно быть валидным entity selector Ключ-АСТРОМ, например:
** <code>type("HOST"),entityName.equals("{HOST.NAME}")</code>
** <code>entityId("SERVICE-ABC123")</code>
** <code>type("PROCESS_GROUP"),tag("db")</code>

Если selector возвращает одну или несколько сущностей — событие создаётся на каждой из них. Поведение при множественных совпадениях регулируется флагом '''Allow Davis merge''' (<code>dt_allow_davis_merge</code>).

== Метрики ==
Расширение экспортирует три типа метрик:
{| class="wikitable"
!Метрика
!Ключ
!Назначение
|-
|Проблемная метрика
|<code>zabbix.problem_count.gauge</code>
|Число активных проблем на хосте (включается опцией <code>problem_metric</code>)
|-
|Пользовательские item’ы
|<code>zabbix.item</code>
|Значения '''Zabbix'''-метрик по списку ключей из <code>item_keys</code>
|-
|Топологическая метрика
|<code>zabbix.topology</code>
|Служебная метрика для создания и поддержки сущностей
|}
Ключи item’ов задаются как список строк или регулярных выражений в поле '''Zabbix item keys to export''' (<code>item_keys</code>).

== Инвентарь хостов ==
При включении опций в разделе '''Zabbix host inventory''' (<code>inventory_keys</code>) данные из '''Zabbix Inventory''' передаются как свойства сущности <code>zabbix:host</code> с префиксом <code>in_</code> (например, <code>in_os</code>, <code>in_host_networks</code>).

По умолчанию включены:

* <code>host_networks</code> → <code>in_host_networks</code>
* <code>os</code> → <code>in_os</code>

Остальные поля (оборудование, контакты, геолокация и т.д.) включаются явно.

== Настройка ==

=== Требования ===

* '''Zabbix''': пользователь или '''API'''-токен с правами '''Read''' на нужные host groups.
* Ключ-АСТРОМ: АктивныйШлюз окружения с поддержкой '''Python'''-расширений.
* Расширение загружено и активировано в Расширениях.

=== Конфигурация endpoint’а ===
Обязательные параметры:

* <code>url</code> — URL '''Zabbix''' (например, <code>https://zabbix.example.com/zabbix</code>)
* <code>username</code> / <code>password</code> — учётные данные или '''API'''-токен в поле <code>password</code>
* <code>groups</code> — список host groups для синхронизации (минимум одна)

Опциональные (в '''Advanced configuration'''):

* <code>timeout</code> — таймаут запроса к '''Zabbix API''' (по умолчанию 5 сек)
* <code>cert_verify</code> — проверка '''SSL'''-сертификата (по умолчанию <code>false</code>)
* <code>refresh_*</code> — интервалы обновления данных (хосты: 20 мин, проблемы: 15 мин)
* <code>interfaces_key</code> — ключ item’а с IP-адресами (по умолчанию <code>interfaces</code>)
* <code>synchronize_problems</code> — включить синхронизацию проблем (по умолчанию <code>true</code>)
* <code>problem_resend</code> — интервал переотправки/закрытия проблем (по умолчанию 5 мин)
* <code>tag_entities</code> — имя тега для маппинга на сущности Ключ-АСТРОМ (по умолчанию <code>DT_Entity</code>)
* <code>dt_allow_davis_merge</code> — разрешить объединение событий ИИ (по умолчанию <code>true</code>)

Если требуется '''HTTP/HTTPS'''-прокси, он настраивается отдельно в блоке '''Proxy''' (<code>proxy.url</code>, <code>proxy.user</code>, <code>proxy.password</code>).

== Интерфейс в Ключ-АСТРОМ ==
После первого цикла синхронизации доступны:

* Экраны: '''Zabbix Servers''', '''Zabbix HostGroups''', '''Zabbix Hosts'''
* Дашборд: '''Zabbix Overview''' (автоматически импортируется из пакета расширения)
* Метрики в '''Metrics browser''' по пространству имён <code>zabbix.*</code>
* События в разделах '''Events''' и '''Problems'''

Каждый '''Zabbix'''-хост отображает:

* Свойства (IP, инвентарь, теги)
* Ссылку на '''Zabbix UI''' (<code>zabbix_host_url</code>)
* Метрику <code>zabbix.problem_count.gauge</code>
* Привязанные события

== Тегирование ==
Расширение автоматически добавляет тег <code>technology: zabbix</code> ко всем создаваемым сущностям.

Рекомендуется настроить дополнительные auto-tag’и:

* Глобальный тег '''Zabbix''' для всех <code>zabbix:*</code> сущностей.
* Теги по группам, например <code>ZabbixHG:Linux servers</code>, с использованием entity selector:
<pre>
type("zabbix:hostgroup"),entityName.equals("Linux servers")
</pre>и<pre>
type("zabbix:host"),toRelationships.calls(
type("zabbix:host_on_group"),
fromRelationships.isChildOf(
type("zabbix:hostgroup"),
entityName.equals("Linux servers")
)
)
</pre>

== Ограничения ==

* Проблемы, живущие менее <code>problem_resend</code> минут (по умолчанию 5), могут не попасть в Ключ-АСТРОМ.
* Закрытие проблемы в Ключ-АСТРОМ происходит с задержкой до следующего цикла опроса.
* Порт не передаётся из '''Zabbix''' → невозможно точное совпадение сущности по (IP, port).
* Acknowledgements отображаются только в свойствах события, не влияют на состояние проблемы.
* Максимум 100 endpoint’ов на один экземпляр расширения.

== Release Notes ==

=== Версия 0.1.27 (custom) ===
Версия плагина с префиксом <code>custom</code>.

=== Версия 0.1.27 ===
Стандартная версия плагина.

Zabbix - История изменений