70b8c37de7 | ||
---|---|---|
.github/workflows | ||
docs | ||
src | ||
web@e55c146b15 | ||
.dockerignore | ||
.gitignore | ||
.gitmodules | ||
Cargo.lock | ||
Cargo.toml | ||
Dockerfile | ||
README.md | ||
config.example.json |
README.md
Rustlog
Description
Rustlog is a Twitch logging service based on justlog. It provides the same web UI and API, but it utilizes Clickhouse for storage instead of text files.
Installation
Create a config.json
file (see config.example.json)
Docker
version: "3.8"
services:
clickhouse:
image: clickhouse/clickhouse-server:latest
container_name: clickhouse
volumes:
- "./ch-data:/var/lib/clickhouse:rw"
environment:
CLICKHOUSE_DB: "rustlog"
restart: unless-stopped
rustlog:
image: ghcr.io/boring-nick/rustlog:master
container_name: rustlog
ports:
- 8025:8025
volumes:
- "./config.json:/config.json"
depends_on:
- clickhouse
restart: unless-stopped
From source
- Set up Clickhouse
cargo install --locked --git https://github.com/boring-nick/rustlog
- You can now run the
rustlog
binary
Advantages over justlog
- Significantly better storage efficiency (2x+ improvement) thanks to not duplicating log files and better compression (using ZSTD in Clickhouse)
- Blazing fast log queries with response streaming and a highly performant IRC parser
Migrating from justlog
See MIGRATION.md