krrishnaaaa/log-collector repository overview

⁠Log Collector

A lightweight, self-hosted centralized logging service for collecting, storing, and viewing logs from multiple applications in real-time.

⁠Features

• Real-time Dashboard - View logs as they arrive via WebSocket
• REST API - Simple HTTP API for log ingestion and querying
• Multi-service Support - Collect logs from multiple applications
• Filtering - Filter by service, level, correlation ID, time range
• Auto Cleanup - Configurable log retention with automatic cleanup
• Lightweight - SQLite storage, minimal resource usage
• Hardened - Distroless base image, non-root user, minimal attack surface

⁠Quick Start

docker run -d \
  --name log-collector \
  -p 7777:7777 \
  -v log-collector-data:/app/data \
  krrishnaaaa/log-collector:latest

Access dashboard: http://localhost:7777⁠

Configuration

┌──────────────────────┬───────────────────┬──────────────────────────┐
│ Environment Variable │      Default      │       Description        │
├──────────────────────┼───────────────────┼──────────────────────────┤
│ SERVER_PORT          │ 7777              │ Server port              │
├──────────────────────┼───────────────────┼──────────────────────────┤
│ DATABASE_PATH        │ /app/data/logs.db │ SQLite database path     │
├──────────────────────┼───────────────────┼──────────────────────────┤
│ LOG_RETENTION_HOURS  │ 24                │ Hours to retain logs     │
├──────────────────────┼───────────────────┼──────────────────────────┤
│ CLEANUP_ENABLED      │ true              │ Enable automatic cleanup │
└──────────────────────┴───────────────────┴──────────────────────────┘

Client Libraries

• JavaScript/TypeScript: @pcsalt/log-collector-client
• Kotlin/Java: com.pcsalt:log-collector-client

API Endpoints

• POST /api/logs - Submit single log
• POST /api/logs/batch - Submit multiple logs
• GET /api/logs - Query logs with filters
• GET /api/logs/services - List services
• GET /actuator/health - Health check

Links

• https://github.com/pcsalt/log-collector⁠
• https://github.com/pcsalt/log-collector#readme⁠
• https://github.com/pcsalt/log-collector/issues⁠

License

MIT License

⁠Categories/Tags

logging, log-management, log-collector, monitoring, observability, real-time, dashboard, rest-api, websocket, kotlin, spring-boot, sqlite, self-hosted, lightweight, distroless