docker-logs-grafana-clickhouse/README.md

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.