tgbyte/mtail Docker Image Overview

tgbyte/mtail

自动构建

基于scratch的Docker镜像，用于运行google/mtail工具，可从应用日志中提取白盒监控数据并收集到时序数据库，轻量级且资源占用低。

0 次下载activetgbyte镜像

🚀专业版镜像服务，面向生产环境设计

中文简介版本下载

🚀专业版镜像服务，面向生产环境设计

docker-mtail 镜像文档

概述

docker-mtail是一个用于运行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 \
  dylanmei/mtail \
  -logtostderr \
  -progs /rules \
  -logs /logs/*.log

参数说明

参数	说明
`-v /path/to/application/logs:/logs:ro`	挂载应用日志目录到容器内`/logs`路径，建议使用只读模式（`:ro`）
`-v /path/to/mtail/rules:/rules`	挂载mtail规则文件目录，规则文件需以`.mtail`为后缀
`-p 3903:3903`	暴露mtail的HTTP指标端口（默认3903），用于监控系统抓取指标
`-logtostderr`	将mtail自身运行日志输出到标准错误流
`-progs /rules`	指定mtail规则文件所在目录
`-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
}