README
¶
Приёмник Zabbix для OpenTelemetry Collector
Нативный приёмник zabbix получает числовые элементы данных через опрос Zabbix API или HTTP Streaming и преобразует их в метрики OpenTelemetry типа gauge. Готовая сборка otelcol-zabbix отправляет их в VictoriaMetrics через стандартный экспортёр Prometheus remote-write. Приёмник можно включить и в собственную сборку Collector.
Документация описывает текущую рабочую копию, включая Streaming. Возможности опубликованного релиза следует сверять с его версией документации.
Быстрый старт
Для знакомства с обоими режимами используйте демонстрацию. Требуются Docker Engine и Compose v2.24 или новее:
make demo-up
make demo-verify
Grafana с готовым дашбордом мониторинга ресивера доступна без входа после запуска. Адреса интерфейсов, запросы для сравнения метрик и настройка портов приведены в руководстве по демонстрации. После работы выполните make demo-down: команда удалит контейнеры и все данные демонстрации, включая токены.
Для подключения к своим сервисам выберите способ установки ниже и настройте API или Streaming. Оба режима используют общие правила имён и лейблов. Без API-обогащения Streaming берёт имя метрики из названия элемента и не получает часть атрибутов API; перед переключением проверьте совместимость Streaming.
Установка и запуск
| Задача | Инструкция |
|---|---|
| Скачать готовый файл для Linux amd64 или arm64 | Установка релиза · Релизы GitHub |
| Собрать и запустить локально | Локальная сборка |
| Запустить контейнер | Docker |
| Установить службу на сервере | VM/systemd |
| Развернуть в кластере | Kubernetes |
| Подключить отправку истории из Zabbix | Коннектор Streaming |
| Добавить приёмник в свою сборку | Collector Builder |
Документация
| Документ | Содержание |
|---|---|
| Настройка | YAML, значения по умолчанию, окружение, аутентификация, контракт метрик, ошибки и телеметрия |
| Развёртывание | Установка, демонстрация, управление службой, сеть и секреты |
| Архитектура | Компоненты, потоки данных, состояние и границы ответственности |
| Масштабирование | Оценка ресурсов, ограничения API и Streaming, демо с четырьмя коллекторами |
| Разработка | Проверки обоих Go-модулей, CI и подготовка релизов |
| Карта документации | Где обновлять сведения и как пользоваться историческими материалами |
Лицензия: Apache License 2.0.
Directories