Docker Driver Client
Grafana Loki officially supports a Docker plugin that will read logs from Docker containers and ship them to Loki. The plugin can be configured to send the logs to a private Loki instance or Grafana Cloud.
Docker plugins are not yet supported on Windows; see the Docker Engine managed plugin system documentation for more information.
Documentation on configuring the Loki Docker Driver can be found on the configuration page.
If you have any questions or issues using the Docker plugin feel free to open an issue in this repository.
The Docker plugin must be installed on each Docker host that will be running containers you want to collect logs from.
Run the following command to install the plugin:
docker plugin install grafana/loki-docker-driver:latest --alias loki --grant-all-permissions
To check installed plugins, use the
docker plugin ls command. Plugins that
have started successfully are listed as enabled:
$ docker plugin ls ID NAME DESCRIPTION ENABLED ac720b8fcfdb loki Loki Logging Driver true
Once the plugin is installed it can be configured.
The upgrade process involves disabling the existing plugin, upgrading, then re-enabling and restarting Docker:
docker plugin disable loki --force docker plugin upgrade loki grafana/loki-docker-driver:latest --grant-all-permissions docker plugin enable loki systemctl restart docker
To cleanly uninstall the plugin, disable and remove it:
docker plugin disable loki --force docker plugin rm loki
The driver keeps all logs in memory and will drop log entries if Loki is not reachable and if the quantity of
max_retries has been exceeded. To avoid the dropping of log entries, setting
max_retries to zero allows unlimited retries; the drive will continue trying forever until Loki is again reachable. Trying forever may have undesired consequences, because the Docker daemon will wait for the Loki driver to process all logs of a container, until the container is removed. Thus, the Docker daemon might wait forever if the container is stuck.
Related Enterprise Logs resources
Grafana Enterprise Logs: Logging with security and scale
Join us for this webinar, which will cover: Challenges with logging as organizations scale and the volume of logs explodes, how Grafana Enterprise Logs enables organizations to make logs available to any team members who need them, features available in GEL and how to get access, a live product demo so you can see GEL for the first time
VIDEO: Watch this first-look demo of the new Grafana Enterprise Logs
Based on Loki, Grafana Enterprise Logs is part of the Grafana Enterprise Stack for composing and scaling observability on your own infrastructure.
Introducing Grafana Enterprise Logs, a core part of the Grafana Enterprise Stack integrated observability solution
Powered by the Loki open source project, the Enterprise Logs offering joins metrics and dashboards in our enterprise-ready stack for self-managed observability.