# docker-observation

Various tools to monitor Docker containers

## Services

### [Telegraf](https://www.influxdata.com/time-series-platform/telegraf/) - [Docker plugin](https://github.com/influxdata/telegraf/blob/master/plugins/inputs/docker/README.md)

> Telegraf is the open source server agent to help you collect metrics from your stacks, sensors, and systems.

### Grafana [Promtail](https://grafana.com/docs/loki/latest/send-data/promtail/)

> Promtail is an agent which ships the contents of local logs to a private Grafana Loki instance or Grafana Cloud. It is usually deployed to every machine that runs applications which need to be monitored.

## Environment Variables

- `DOCKER_INFLUXDB_INIT_ORG`
- `INFLUX_WRITE_TOKEN`
- `INFLUX_HOST` (optional)
- `LOKI_HOST` (optional)

## Setup

Set the DOCKER_GUID so the container has permission to access the socket

```shell
export DOCKER_GUID=$(getent group docker | awk -F ':' '{print $3}')
```