reloopsh/be-logs repository overview

⁠📊 Reloop — Logs Service

The Logs Service is the email event logging and analytics microservice in the Reloop⁠ platform. It ingests, stores, and queries high-volume email delivery events — such as sends, opens, clicks, bounces, and complaints — powered by ClickHouse for fast analytical queries at scale. Includes automated log cleanup via a built-in cron job.

Built on Bun⁠ + Elysia⁠, backed by ClickHouse and Redis.

⁠🚀 Features

• Event Ingestion — Capture email delivery events (send, open, click, bounce, complaint, unsubscribe)
• ClickHouse Backend — High-performance analytical storage for billions of events
• Query API — Filter and paginate logs by org, domain, campaign, and event type
• Auto Cleanup — Built-in cron job to purge old log data on a schedule
• Organization-scoped — All logs are isolated per org
• API Key Auth — Secured via x-api-key header
• OpenAPI Docs — Auto-generated spec at /api/logs/openapi
• NATS Bus — Subscribes to delivery events from the Reloop message bus

⁠🔗 Quick Links

⁠⚡ Quick Start

docker pull reloopsh/be-logs:latest

docker run -d \
  -p 8016:8016 \
  -e REDIS_URL=redis://:password@host:6379 \
  -e NATS_URL=nats://host:4222 \
  -e BASE_URL=https://your-domain.com \
  -e CLICKHOUSE_URL=http://clickhouse-host:8123 \
  -e CLICKHOUSE_USER=default \
  -e CLICKHOUSE_PASSWORD=your-password \
  -e CLICKHOUSE_DATABASE=reloop \
  reloopsh/be-logs:latest

The service will be available at http://localhost:8016/api/logs.

⁠🔧 Environment Variables

⁠🛠 Tech Stack

• Runtime: Bun⁠
• Framework: Elysia⁠
• Analytics DB: ClickHouse⁠
• Cache: Redis
• Messaging: NATS

⁠📦 Part of the Reloop Platform

This image is one of several microservices that make up the Reloop backend. See the full list at hub.docker.com/u/reloopsh⁠.