tgbyte/mtail

docker-mtail 镜像文档

概述

docker-mtail是一个用于运行http://github.com/google/mtail工具的Docker镜像，基于scratch构建，旨在轻量级地从应用日志中提取白盒监控数据，并将其收集到时序数据库中。该镜像提供了便捷的容器化部署方式，适用于各类日志监控场景。

核心功能与特性

• 轻量级基础：基于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 \
  docker.xuanyuan.run/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