octoblu/docker-librato

docker-librato

镜像概述

该镜像可将Docker容器的日志和统计信息轻松转发至Librato Metrics平台，帮助用户高效监控容器运行状态。

核心功能

• 转发容器日志至Librato Metrics
• 收集并转发容器统计信息
• 支持受限环境下的特权模式运行
• 可使用不同令牌分别处理日志和统计数据

使用场景

• 容器运行状态监控
• 日志集中管理与分析
• 多容器环境的统一指标收集

配置说明

环境变量

• LIBRATO_EMAIL: Librato账号***
• LIBRATO_TOKEN: Librato访问令牌
• CLUSTER_NAME: 集群名称（用于标识不同环境的容器）

权限要求

在部分受限环境（如Google Compute Engine）中，需添加--privileged参数以访问Docker socket。

部署示例

基础运行

sh
docker run \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -e LIBRATO_EMAIL="你的邮箱" \
  -e LIBRATO_TOKEN="你的令牌" \
  -e CLUSTER_NAME="你的集群名称" \
  octoblu/docker-librato:v1.0.0

受限环境运行

sh
docker run --privileged \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -e LIBRATO_EMAIL="你的邮箱" \
  -e LIBRATO_TOKEN="你的令牌" \
  -e CLUSTER_NAME="你的集群名称" \
  octoblu/docker-librato:v1.0.0

构建镜像

bash
# 克隆仓库
git clone https://github.com/octoblu/docker-librato.git
cd docker-librato
# 构建镜像
docker build -t librato .
# 运行镜像
docker run \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -e LIBRATO_EMAIL="你的邮箱" \
  -e LIBRATO_TOKEN="你的令牌" \
  -e CLUSTER_NAME="你的集群名称" \
  librato

工作原理

该镜像封装了四个Docker API：

1. POST /containers/{id}/attach：获取容器日志
2. GET /containers/{id}/stats：获取容器统计信息
3. GET /containers/json：检测启动时运行的容器
4. GET /events：检测模块启动后新启动的容器

同时，它使用docker-loghose和docker-stats工具获取日志和统计信息的持续数据流，并通过never-ending-stream处理请求流。

Credits

本应用基于https://github.com/nearform/docker-logentries%E5%BC%80%E5%8F%91%E3%80%82

许可证

MIT