From 972214455d18ee9682608b51e538e3581e506e8e Mon Sep 17 00:00:00 2001 From: Marius Sturm Date: Fri, 29 May 2015 23:00:46 +0200 Subject: [PATCH] add UDP GELF logging-driver allows to send container logs to Graylog or Logstash. Signed-off-by: Marius Sturm --- docs/sources/reference/run.md | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) diff --git a/docs/sources/reference/run.md b/docs/sources/reference/run.md index 90e8ae4992..db0a7d5def 100644 --- a/docs/sources/reference/run.md +++ b/docs/sources/reference/run.md @@ -906,6 +906,25 @@ reference documentation. The following logging options are supported for this logging driver: [none] +#### Logging driver: gelf + +Graylog Extended Log Format (GELF) logging driver for Docker. Writes log messages to a GELF endpoint like +Graylog or Logstash. The `docker logs` command is not available for this logging driver. + +The GELF logging driver supports the following options: + + --log-opt gelf-address=udp://host:port + --log-opt gelf-tag="database" + +The `gelf-address` option specifies the remote GELF server address that the +driver connects to. Currently, only `udp` is supported as the transport and you must +specify a `port` value. The following example shows how to connect the `gelf` +driver to a GELF remote server at `192.168.0.42` on port `12201` + + $ docker run --log-driver=gelf --log-opt gelf-address=udp://192.168.0.42:12201 + +The `gelf-tag` option specifies a tag for easy container identification. + ## Overriding Dockerfile image defaults When a developer builds an image from a [*Dockerfile*](/reference/builder)