homer eleven

100% открытый исходный код для телекоммуникационной наблюдаемости с 2011 года

homer — это универсальный монолитный сервер для захвата HEP и API, лежащий в основе озера данных Homer 11.x

Возможности

• Приложение «все-в-одном» (запись, чтение, координатор, компактор, API)
• Современная кодовая база на golang для X64/ARM64 на Linux/MacOS
• Работает на DuckDB 1.5 и Apache Arrow/IPC/Parquet
• Архитектура озера данных на основе каталога DuckLake и локального/объектного хранилища
• Сквозной столбчатый дизайн OTLP с выполнением запросов по требованию
• Линейное масштабирование для запросов через общий каталог/пул объектного хранилища
• Гибкая поддержка схем для растущих задач и протоколов
• Обратная совместимость со всеми агентами HEPv3
• Опциональный сборщик SIP QoS VQRTCP (application/vq-rtcpxr → DuckLake + UI транзакционного QoS)
• Опциональная поддержка сигнального SRS SIPREC (RFC 7865/7866, захват метаданных)
• Легко поддерживается, эксплуатируется и масштабируется (вплоть до нуля!)
• Облачно-ориентированный дизайн для K8s и стандартных развертываний
• Встроенный пользовательский интерфейс для людей
• Поддержка MCP и дружелюбный к LLM/агентам дизайн (украдите наши скучные работы)

Архитектура

Homer использует модульную архитектуру с четырьмя основными компонентами:

┌─────────────────────────────────────────────────────────────────────────────┐
│                           Homer Core                                        │
│                                                                             │
│  ┌─────────────┐   ┌─────────────┐   ┌──────────┐   ┌─────────────────┐     │
│  │   Ingest    │   │   Storage   │   │   Node   │   │   Coordinator   │     │
│  │  (HEP recv) │──▶│  (DuckLake) │──▶│ gRPC/HTTP│──▶│    (REST API)   │     │
│  └─────────────┘   └─────────────┘   └──────────┘   └─────────────────┘     │
│   UDP/TCP/HTTP      Parquet+S3     Airport :50051     HTTP :8080            │
│                                    FlightSQL :50055  (opt. proxy :32010)    │
└─────────────────────────────────────────────────────────────────────────────┘

Модули

Быстрый старт

Варианты установки

• Скачать релиз и установить пакет homer для вашей ОС/архитектуры
• Использовать официальные docker-сборки и примеры compose
• Собрать свой релиз локально (продолжайте читать)

Развертывание «все-в-одном»

<<>

О других вариантах хранилища см. доступные ПОЛИТИКИ ХРАНИЛИЩА

Опционально: Сборщик VQRTCP и поддержка SIPREC

Обе функции отключены по умолчанию и требуют модуль записи (DuckLake). Включите их в разделе ingest файла homer.json:

<<>

Направьте ваш SBC или медиа-шлюз на SIP-порт VQRTCP для отчетов application/vq-rtcpxr. Направьте клиент записи сессий SIPREC (SRC) на порт SIPREC для записи сигнализации и rs-метаданных.

См. docs/VQRTCP.md и docs/SIPREC.md для деталей формата, корреляции и тюнинга.

Сборка и запуск

# Build
make

# Run as server (default mode)
./homer --config-path /etc/homer/homer.json

# With debug logging
./homer --config-path /etc/homer/homer.json --log-level debug

Подкоманды

Homer использует CLI на основе подкоманд. Запуск homer без аргументов запускает сервер.

homer                         Run the server (default)
homer search [flags]          Search Homer data via coordinator API
homer cli [flags]             Interactive DuckLake SQL shell
homer system [flags]          System operations (compaction, extensions, reload)
homer wizard [flags]          Interactive config generator wizard
homer mcp [flags]             Start MCP stdio server
homer version                 Show version
homer help                    Show full help with all flags

Режим сервера (по умолчанию)

homer --config-path /etc/homer/homer.json
homer --config-path /etc/homer/homer.json --log-level debug --syslog-disable

Поиск (через API координатора)

Поиск данных Homer из командной строки с выводом в виде таблицы, вертикального списка, CSV, JSON, графика, графа вызовов или формата PCAP (только SIP; используйте --format pcap с -o / --output).

<<>

См. docs/SEARCH.md для полной документации и примеров.

CLI (оболочка DuckLake SQL)

Интерактивная оболочка для прямых запросов к DuckLake:

<<>

Системные операции

# Run full compaction
homer system --config-path /etc/homer/homer.json --compaction-force

# Install DuckDB extensions
homer system --config-path /etc/homer/homer.json --install-extensions

# Show DuckDB version
homer system --config-path /etc/homer/homer.json --duckdb-version

# Generate example config
homer system --generate-example-config > homer.json

# Reload running process
homer system --reload

Мастер (генератор конфигурации)

Интерактивный мастер, генерирующий полный файл конфигурации homer.json:

<<>

Примеры конфигураций

См. каталог examples/:

Документация

Опубликованные документы (GitHub Pages): https://sipcapture.github.io/homer/ — построены из docs/ через MkDocs при пуше в homer11. Включите Settings → Pages → Build and deployment: GitHub Actions один раз после первого запуска workflow.

<<>

• CLI поиска - Поиск из командной строки (примеры, форматы, граф вызовов)
• Мастер конфигурации - Интерактивный генератор конфигурации (TUI + пресеты)
• Тюнинг производительности сбора данных - многоядерность, размер пакета DuckLake, интервал сброса Prometheus; scripts/profile_ingest_load.sh / make profile-ingest для воспроизводимых CPU-профилей
• Модуль координатора - REST API шлюз
• Руководство по MCP UI - Помощник для запросов на естественном языке (конфигурация + использование UI)
• Модуль ноды - Датасервер FlightSQL
• Архитектура хранилища - Хранилище DuckLake
• Политики хранилища - Иерархическое хранилище (горячее/холодное)
• Настройка компактации - Компактация файлов
• Сборщик VQRTCP - Отчеты SIP QoS (vqrtcpxr_stats, UI QoS)
• Поддержка SIPREC - Сигнальный SRS (hep_proto_1_siprec)

Лицензия

Выпускается под лицензией AGPL-3.0 License

Copyright (C) 2025 QXIP BV