nabi911/onec-log-server repository overview

onec-log-server

1C:Enterprise event log exporter to modern analytics backends.

What is onec-log-server?

onec-log-server exports 1C:Enterprise (1С:Предприятие) event logs in real time to multiple storage backends:

• ClickHouse — JDBC bulk insert
• Elasticsearch — Bulk API (9.x)
• OpenSearch — Bulk API
• Logstash — HTTP JSON Lines
• Grafana Loki — Push API (Snappy/GZIP)
• Grafana Alloy — OTLP protobuf
• VictoriaLogs — JSON Lines
• File — JSON/CSV/LOG with rotation

Built with Java 25 and Spring Boot 4, the application uses a producer-consumer architecture with at-least-once delivery, circuit breakers, exponential backoff retries, and a disk spill buffer for
graceful degradation.

Features

• Multi-backend export — write to one or more backends simultaneously
• Resilience — circuit breaker, retry with backoff, disk spill buffer for crash recovery
• Web UI — built-in dashboard with real-time status via WebSocket
• REST API — manage exporters, storages, config, and query events
• Security — HTTP Basic + Form auth, rate limiting, audit logging
• Monitoring — Prometheus metrics at /actuator/prometheus, 14 health indicators
• CLI — separate native image for one-off exports (nabi911/onec-log-cli)

Quick Start

docker run -d \
--name 1cexporter \
-p 8080:8080
-v /path/to/1c/logs:/logs:ro
-e ONEC_LOG_ENABLED=true \
-e ONEC_LOG_CLICKHOUSE_ENABLED=true
-e ONEC_LOG_CLICKHOUSE_URL=jdbc:clickhouse://clickhouse:8123/logs \
nabi911/onec-log-server

Or with Docker Compose:

services: 1cexporter: image: nabi911/onec-log-server
ports:
- "8080:8080"
volumes:
- /path/to/1c/logs:/logs:ro
- ./config:/config environment:
ONEC_LOG_ENABLED: "true" ONEC_LOG_PORTION: 5000
ONEC_LOG_CLICKHOUSE_ENABLED: "true"
ONEC_LOG_CLICKHOUSE_URL: jdbc:clickhouse://clickhouse:8123/default

Environment Variables

ONEC_LOG_ENABLED true - Enable export
ONEC_LOG_PORTION 5000 - Batch size
ONEC_LOG_WRITING_MAX_DOP 2 - Max write parallelism
ONEC_LOG_CLICKHOUSE_ENABLED true - Enable ClickHouse export
ONEC_LOG_CLICKHOUSE_URL jdbc:clickhouse://clickhouse:8123/logs - ClickHouse JDBC URL
ONEC_LOG_ELASTICSEARCH_ENABLED true - Enable Elasticsearch export
ONEC_LOG_LOKI_ENABLED true - Enable Loki export
ONEC_LOG_SECURITY_USERS_FILE /app/users.json - Path to users JSON file

Volumes

/logs ro 1C event log files (.lgp, .lgf) /config rw Configuration files

Exposed Ports

8080 - Web UI, REST API, Actuator

Healthcheck

curl -sf http://localhost:8080/actuator/health⁠

Image Details

• Base image: eclipse-temurin:25-jre
• Architecture: linux/amd64
• License: MIT