logmatic/logmatic-docker

logmatic/logmatic-docker

该镜像能够从Docker主机上所有运行中的容器中收集日志、事件和统计数据，并直接流式传输至Logmatic.io平台，便于用户集中管理与分析容器相关数据。

如需帮助或试用Logmatic.io：

• 官方文档：Logmatic.io文档页面
• 支持团队：***
• 官网：[***]

版本与标签

• 1.2, 1.2.2, latest：官方稳定版本
• 1.0（已弃用）：基于NodeJS的Docker客户端，与Logmatic.io集成不兼容
• dev：从GitHub仓库构建的开发版本

快速使用

该容器唯一必需的参数是Logmatic.io平台的API密钥。运行以下命令即可启动：

bash
docker run -dt --name logmatic.io -v /var/run/docker.sock:/var/run/docker.sock:ro docker.xuanyuan.run/logmatic/logmatic-docker:1.2 <你的API密钥>

注意：映射Docker套接字（/var/run/docker.sock）是关键，这是镜像能够识别所有运行中容器并跟踪其日志的基础。

核心功能

1. 日志收集：获取容器输出的原始日志，并附加容器标识元数据（如ID、名称、镜像等）。
2. 事件跟踪：记录Docker主机上的容器活动（创建、启动、停止等）。
3. 统计监控：收集容器的CPU、内存、网络等资源使用情况。

配置选项

在API密钥后可添加多个可选参数，以自定义镜像行为：

基础配置

• --no-logs：禁用日志流
• --no-stats：禁用统计数据流
• --no-events：禁用事件流
• --namespace NAMESPACE：设置Docker属性的命名空间（默认值为docker）
• -i INTERVAL：统计报告间隔（默认30秒）

容器过滤

• --matchByImage REGEX：仅收集匹配镜像名称的容器数据
• --skipByName REGEX：跳过匹配名称的容器
• --matchByLabel LABEL：根据标签筛选容器（格式：key或key=value）

其他选项

• --debug：启用调试模式
• --attr ATTRS：添加额外属性（如--attr env="production"）

数据类型说明

日志数据

日志内容会保留原始格式，并附加容器元数据。例如NGINX日志：

json
{
    "message": "192.168.99.1 - - [15/Dec/2015:17:36:50 +0000] \"GET / HTTP/1.1\" 304 0 \"-\" \"Mozilla/5.0 ...\"",
    "docker": {
        "image": "logmatic/logmatic-docker:latest",
        "name": "grave_goldwasser",
        "id": "47cb6e825ac0...",
        "status": "running"
    },
    "severity": "INFO",
    "timestamp": "2017-02-10T08:21:14.258Z"
}

Docker事件

记录容器生命周期事件：

json
{
    "message": "[Docker event] name:amazing_engelbart >> event:start (image=chentex/random-logger)",
    "docker": {
        "image": "chentex/random-logger",
        "name": "amazing_engelbart",
        "event": "start"
    },
    "severity": "INFO",
    "timestamp": "2017-02-10T08:24:47.044Z"
}

统计数据

包含容器资源使用情况：

json
{
    "message": "[Docker stats] name:grave_goldwasser >> cpu:0.11% mem:0.21% ...",
    "docker": {
        "name": "grave_goldwasser",
        "stats": { /* 资源使用详情 */ }
    },
    "severity": "INFO",
    "timestamp": "2017-02-10T08:26:42.255Z"
}

未来规划

该工具尚处于早期阶段，欢迎用户反馈需求，团队将持续优化功能。