tutum/syslogger

tutum/syslogger

镜像概述和主要用途

tutum/syslogger是一个基于gliderlabs/logspout的Docker镜像，针对syslog和Tutum平台进行了优化。它作为运行在Docker内部的日志路由器，能够附加到主机上的所有容器，捕获其日志并路由到用户指定的目标位置，实现Docker容器日志的集中管理。

核心功能和特性

• 日志路由：作为Docker容器内的日志路由器，可将容器日志路由到用户指定的任意目标位置
• 日志捕获：支持捕获容器的标准输出(stdout)和标准错误(stderr)
• 容器兼容性：仅收集以无-t选项启动的容器日志
• 灵活配置：可通过环境变量自定义主机名，支持与多种日志管理服务集成
• 容器忽略：支持通过设置环境变量忽略特定容器的日志收集

使用场景和适用范围

适用于需要集中管理Docker容器日志的场景，尤其适合与第三方日志管理服务（如Papertrail、Loggly等）集成，可在Tutum平台或其他标准Docker环境中使用。

使用方法和配置说明

基本使用方法

使用docker-compose运行容器，需指定主机名和日志目标URI：

bash
docker-compose run -d -e HOSTNAME=<YOUR-HOSTNAME> syslogger "<YOUR-URI>"

参数说明：

• <YOUR-HOSTNAME>：自定义主机名，将显示在日志管理服务中
• <YOUR-URI>：日志发送目标的URI地址

与Papertrail集成示例

bash
docker-compose run -d -e HOSTNAME=<YOUR-HOSTNAME> syslogger "syslog://<YOUR-PAPERTRAIL-URI>"

参数说明：

• <YOUR-PAPERTRAIL-URI>：Papertrail服务的URI，格式示例为logs.papertrailapp.com:55555

与Loggly集成示例

bash
docker-compose run -d -e HOSTNAME=<YOUR-HOSTNAME> syslogger "syslog://logs-01.loggly.com:514?structured_data=<YOUR-CUSTOMER-TOKEN>@41058"

参数说明：

• <YOUR-CUSTOMER-TOKEN>：Loggly的客户令牌，可在Loggly控制台的"Source Setup"->"Customer Tokens"中获取

忽略特定容器

通过在目标容器中设置LOGSPOUT=ignore环境变量，可使syslogger忽略该容器的日志：

bash
docker run -d -e 'LOGSPOUT=ignore' <name-image>