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 [Logs + Structured via Query](dashboards/Logs + Structured via Query.json) dashboard.
4. Run any Docker project with structured JSON logs.
5. Done.