logzio/logzio-docker

logzio/logzio-docker镜像描述

镜像概述

该镜像提供了将Docker容器日志、实时统计信息和事件转发至Logz.io平台的简化方案，无需复杂配置即可实现日志集中管理与分析。

核心功能

• 转发容器日志、统计数据及Docker事件至Logz.io
• 支持按容器名称/镜像正则匹配过滤转发目标
• 可添加自定义字段（如环境标签）
• 选择日志发送区域（美国/欧洲）
• 处理JSON格式日志
• 灵活禁用统计、日志或事件转发
• 调整统计信息采样间隔

使用场景

• 生产/测试环境Docker容器日志集中监控
• 多容器部署下的日志统一分析
• 需要将Docker数据同步至Logz.io平台的场景

配置说明

基础部署命令

sh
docker run -d --restart=always -v /var/run/docker.sock:/var/run/docker.sock logzio/logzio-docker -t <你的Logz.io令牌> -a env=prod

关键参数

• --no-stats: 禁用每秒统计发送（适用于Docker版本<1.5）
• --no-logs: 禁用日志转发
• --no-dockerEvents: 禁用事件转发
• -i/--statsinterval <间隔>: 调整统计采样间隔
• -a: 添加自定义字段（如-a env=prod）
• -z: 指定区域（eu=欧洲，us=美国，默认us）
• -j: 假设日志为JSON格式
• 过滤规则：
  • --matchByName REGEXP: 仅转发名称匹配正则的容器
  • --matchByImage REGEXP: 仅转发镜像匹配正则的容器
  • --skipByName REGEXP: 跳过名称匹配正则的容器
  • --skipByImage REGEXP: 跳过镜像匹配正则的容器

受限环境部署（如GCE）

添加--privileged获取Docker socket权限：

sh
docker run --privileged -d --restart=always -v /var/run/docker.sock:/var/run/docker.sock logzio/logzio-docker -t <你的Logz.io令牌> -a env=prod

工作原理

通过调用Docker API实现：

1. POST /containers/{id}/attach: 获取日志
2. GET /containers/{id}/stats: 获取统计数据
3. GET /containers/json: 检测启动时容器
4. GET /events: 检测后续启动容器
   封装docker-loghose和docker-stats库，以流方式处理数据。