docker-logs-grafana-clickhouse/README.md
2024-09-26 12:48:22 +03:00

16 lines
828 B
Markdown

# Grafana Clickhouse Docker Log Aggregation
This demo project can aggregate logs from Docker containers and store them in Clickhouse. In the `dashboards` directory you can find dashboard examples for specific log format. `Logs + Structured via Query` is recommended because the other one is deprecated now.
**Note**: dashboards are tuned for structured logging (JSON log records).
## How to start
Obviously, you'll need Docker:
1. `make migrate` (use `clickhouse-client` inside container and execute migration SQL directly if migrator doesn't work).
2. Navigate to `http://grafana.test` or `http://localhost:3000` (if you did not configure Traefik locally), use `admin:admin` as credentials.
3. Import `dashboards/Logs + Structured via Query.json` dashboard.
4. Run any Docker project with structured JSON logs.
5. Done.