tgbyte/mtail

docker-mtail 镜像文档

概述

docker-mtail是一个用于运行http://github.com/google/mtail%E5%B7%A5%E5%85%B7%E7%9A%84Docker%E9%95%9C%E5%83%8F%EF%BC%8C%E5%9F%BA%E4%BA%8Escratch%E6%9E%84%E5%BB%BA%EF%BC%8C%E6%97%A8%E5%9C%A8%E8%BD%BB%E9%87%8F%E7%BA%A7%E5%9C%B0%E4%BB%8E%E5%BA%94%E7%94%A8%E6%97%A5%E5%BF%97%E4%B8%AD%E6%8F%90%E5%8F%96%E7%99%BD%E7%9B%92%E7%9B%91%E6%8E%A7%E6%95%B0%E6%8D%AE%EF%BC%8C%E5%B9%B6%E5%B0%86%E5%85%B6%E6%94%B6%E9%9B%86%E5%88%B0%E6%97%B6%E5%BA%8F%E6%95%B0%E6%8D%AE%E5%BA%93%E4%B8%AD%E3%80%82%E8%AF%A5%E9%95%9C%E5%83%8F%E6%8F%90%E4%BE%9B%E4%BA%86%E4%BE%BF%E6%8D%B7%E7%9A%84%E5%AE%B9%E5%99%A8%E5%8C%96%E9%83%A8%E7%BD%B2%E6%96%B9%E5%BC%8F%EF%BC%8C%E9%80%82%E7%94%A8%E4%BA%8E%E5%90%84%E7%B1%BB%E6%97%A5%E5%BF%97%E7%9B%91%E6%8E%A7%E5%9C%BA%E6%99%AF%E3%80%82

核心功能与特性

• 轻量级基础：基于scratch镜像构建，镜像体积小巧，运行时资源占用极低
• 原生mtail集成：完整包含google/mtail工具，支持其全部日志解析和指标提取能力
• 白盒监控支持：可从结构化或非结构化应用日志中提取自定义业务指标和系统指标
• 时序数据库兼容：支持将提取的监控数据输出到Prometheus、Graphite等主流时序数据库

使用场景与适用范围

• 构建基于日志的白盒监控系统，补充传统黑盒监控方案
• 从应用日志中提取关键业务指标（如请求量、响应时间、错误率等）
• 容器化环境中快速部署日志指标提取工具
• 开发测试环境验证mtail规则文件的有效性
• 生产环境小规模日志监控部署

使用方法与配置说明

基本部署

通过docker run命令启动容器，需挂载应用日志目录和mtail规则文件：

bash
docker run -d \
  --name mtail \
  -v /path/to/application/logs:/logs:ro \
  -v /path/to/mtail/rules:/rules \
  -p 3903:3903 \
  dylanmei/mtail \
  -logtostderr \
  -progs /rules \
  -logs /logs/*.log

参数说明

规则文件示例

在挂载的规则目录（如/path/to/mtail/rules）中创建.mtail规则文件，定义指标提取逻辑：

mtail
# 示例：提取HTTP请求总数和状态码分布
counter http_requests_total
counter http_requests_by_status{status_code=~"\\d+"}

/^.* "GET .*" (?P<status>\d+) .*$/ {
  http_requests_total++
  http_requests_by_status{status_code: status}++
}

# 示例：提取响应时间指标
gauge response_time_seconds

/^.* response_time=(?P<time>\d+\.\d+)s .*$/ {
  response_time_seconds = time
}

指标访问

容器启动后，可通过http://<容器IP>:3903/metrics访问提取的监控指标，指标格式符合Prometheus规范，可直接配置Prometheus进行抓取。

镜像信息

• 官方镜像地址：http://hub.docker.com/r/dylanmei/mtail
• 上游项目：http://github.com/google/mtail