1C Log Checker
1C Log Parser Service
Парсер журнала регистрации и техжурнала 1С в ClickHouse с дашбордами Grafana и MCP-интерфейсом для агентов
Установка
docker network create infra
cd deploy/docker
docker compose up -dПеред запуском заполните deploy/docker/.env и configs/cluster_map.yaml. Вне devcontainer уберите volume work_data из docker-compose.yml.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Читает журнал регистрации (.lgf, .lgp, .lgx) и технологический журнал 1С, загружает их в ClickHouse и показывает в готовых дашбордах Grafana. MCP-сервер дает агенту выборку событий из обоих журналов в компактном или полном формате. Отдельные инструменты сохраняют, генерируют, восстанавливают и отключают конфигурацию техжурнала logcfg.xml.
Для кого. Разработчикам и администраторам 1С, которые разбирают ошибки и производительность серверных баз.
Подходит, если
- Найти новые ошибки в журнале регистрации за последние сутки
- Разобрать блокировки, долгие SQL-запросы и исключения в техжурнале
- Попросить агента включить техжурнал на нужные события и потом вернуть настройки
- Хранить и анализировать логи нескольких баз в одном месте
Не подходит, если
- Нет Docker или серверы 1С работают не на Windows
- Нужен анализ логов PostgreSQL или MS SQL: пока в планах
Пример запроса к агенту
Покажи ошибки журнала регистрации базы ERP за последние сутки, сгруппированные по тексту ошибкиОграничения
Рассчитан на Windows-хост с логами 1С и Docker Desktop. Требует ручной настройки conf.cfg для каждой версии платформы и файла cluster_map.yaml с GUID кластеров и баз. Скорость разбора техжурнала на больших объемах пока не проверялась, на тестах около 170 записей в секунду. Grafana по умолчанию открыта без авторизации.
Как отключить. Удалите блок 1c-log-checker из конфига MCP-клиента и остановите стек командой docker compose down в deploy/docker. Если техжурнал включался через агента, верните настройки инструментом logc_restore_techlog или logc_disable_techlog.
MCP
- Транспорт
- http, stdio
- Авторизация
- не нужна
| Переменные окружения | |
|---|---|
| LOG_DIRS обязательная | Пути к каталогам журнала регистрации через точку с запятой |
| TECHLOG_DIRS | Пути к каталогам технологического журнала |
| TECHLOG_CONFIG_DIR | Несистемный каталог для logcfg.xml |
| CLICKHOUSE_PASSWORD секрет | Пароль ClickHouse, по умолчанию logchecker |
| LOG_RETENTION_DAYS | Срок хранения логов в днях, по умолчанию 30 |
Проверка безопасности
- Запускает стек Docker с ClickHouse, Grafana и MCP-сервером
- Инструменты меняют конфигурацию техжурнала на сервере 1С
- Grafana по умолчанию без авторизации, логи могут содержать данные пользователей
Коротко о README
Сервис на Go разбирает журнал регистрации и техжурнал 1С, пишет их в ClickHouse с партиционированием по дням и TTL и поднимает дашборды Grafana по активности, ошибкам, метаданным и техжурналу. MCP-сервер доступен по HTTP и stdio. README подробно описывает настройку путей и conf.cfg, внешние ресурсы Docker, таблицы ClickHouse и типичные проблемы. Для работы с техжурналом автор рекомендует отдельный скилл TECHLOG_SKILL.
Частые вопросы
Зачем нужен cluster_map.yaml?
Чтобы агент знал GUID кластеров и баз проекта и мог запрашивать логи конкретной базы. Без него сервис не работает.
Как долго хранятся логи?
По умолчанию 30 дней, срок задается переменной LOG_RETENTION_DAYS.
Сколько времени занимает разбор журнала регистрации?
По README журнал на 30 ГБ и 250 млн строк загружается примерно за 50 минут без дедупликации.
Похожие
Kubernetes MCP
MCP Server Kubernetes
MCP-сервер для управления кластером Kubernetes через kubectl и Helm, с режимом без разрушающих операций
Terraform MCP
Terraform MCP Server
Официальный MCP-сервер HashiCorp для Terraform Registry и HCP Terraform: провайдеры, модули, политики и рабочие пространства
CLI для полного цикла CI/CD в Kubernetes: сборка образов, деплой через Helm и очистка container registry
Terraform Skill
Terraform & OpenTofu Skill for AI Agents
Скилл лучших практик Terraform и OpenTofu: тесты, модули, state, CI/CD и проверки безопасности для AWS, Azure и GCP