alexkrauss/logspout-counter-prometheus

logspout-counter-prometheus

这是基于https://github.com/gliderlabs/logspout%E7%9A%84%E8%87%AA%E5%AE%9A%E4%B9%89%E6%A8%A1%E5%9D%97%E9%95%9C%E5%83%8F%EF%BC%8C%E8%83%BD%E5%A4%9F%E8%81%9A%E5%90%88%E6%97%A5%E5%BF%97%E4%B8%AD%E7%89%B9%E5%AE%9A%E6%96%87%E6%9C%AC%E7%89%87%E6%AE%B5%E7%9A%84%E5%87%BA%E7%8E%B0%E6%AC%A1%E6%95%B0%EF%BC%8C%E5%B9%B6%E5%B0%86%E8%AE%A1%E6%95%B0%E7%BB%93%E6%9E%9C%E4%BD%9C%E4%B8%BAhttps://prometheus.io/%E6%8C%87%E6%A0%87%E5%AF%BC%E5%87%BA%E3%80%82

核心功能

• 子字符串匹配日志消息并统计计数
• 导出log_count指标（含自定义标签）供Prometheus抓取
• 支持通过配置文件灵活定义匹配规则

使用场景

1. 缺乏完整日志分析栈时，快速获取关键事件计数
2. 日志保留周期短，但需长期跟踪核心指标
3. 团队优先通过指标仪表盘监控系统状态

配置说明

1. 创建counters.yaml配置文件：

   yaml
   counters:
     handshake_start:
       match: "Starting handshake for type"
       level: INFO
     heartbeat_warn:
       match: "heartbeat interval is growing too large"
       level: ERROR
   

   • match：需统计的日志文本片段
   • level：指标标签（如INFO/ERROR）

2. 部署要求：

   • 挂载配置文件到容器内
   • 设置LOG_COUNTER_FILE环境变量指定配置路径
   • 使用counter://dummy作为Logspout路由

部署示例

Docker Run命令

bash
docker run -d \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -v ./counters.yaml:/etc/counters.yaml \
  -e LOG_COUNTER_FILE=/etc/counters.yaml \
  -p 8000:80 \
  alexkrauss/logspout-counter-prometheus counter://dummy

Docker Compose示例

yaml
version: '3'
services:
  logspout-counter:
    image: alexkrauss/logspout-counter-prometheus
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
      - ./counters.yaml:/etc/counters.yaml
    environment:
      - LOG_COUNTER_FILE=/etc/counters.yaml
    ports:
      - "8000:80"
    command: counter://dummy

构建与改进

• 基于Logspout父镜像构建，自定义Go模块实现计数逻辑
• 未来可扩展正则匹配、版本固定等功能

访问容器的/metrics端点即可获取Prometheus指标。 ===END===