brandond/syslog_ng_exporter

Syslog-NG Prometheus导出器

镜像概述

该镜像用于将syslog-ng的统计数据通过HTTP接口暴露，供Prometheus采集和监控，帮助用户实时了解syslog-ng的运行状态。已测试兼容syslog-ng 3.5.6、3.20.1和3.22.1版本。

核心功能

• 暴露syslog-ng关键统计指标，包括消息处理、丢弃、存储数量及服务可达状态
• 支持自定义监控端口、指标路径、syslog-ng控制socket路径和日志级别
• 提供清晰的指标类型（计数器、gauge），便于Prometheus分析和告警

使用场景

适用于以下场景：

• 监控syslog-ng服务的日志处理吞吐量和丢弃率
• 检测syslog-ng服务的可用性
• 结合Prometheus和Grafana构建日志系统监控面板，实现可视化分析

配置说明

支持的命令行参数如下：

• --help：显示上下文敏感帮助信息
• --version：打印版本信息
• --telemetry.address=":9577"：暴露指标的地址（默认端口9577）
• --telemetry.endpoint="/metrics"：暴露指标的路径（默认/metrics）
• --socket.path="/var/lib/syslog-ng/syslog-ng.ctl"：syslog-ng控制socket的路径
• --log.level="info"：日志级别（可选值：debug、info、warn、error、fatal）
• --log.format="logger:stderr"：日志目标和格式设置（如json格式输出）

Docker部署示例

bash
docker run -d -p 9577:9577 -v /var/lib/syslog-ng/syslog-ng.ctl:/syslog-ng.ctl \
  docker.xuanyuan.run/brandond/syslog_ng_exporter --socket.path=/syslog-ng.ctl

指标说明

导出的主要指标：

• syslog_ng_destination_messages_dropped_total：目标端丢弃的消息总数（计数器）
• syslog_ng_destination_messages_processed_total：目标端处理的消息总数（计数器）
• syslog_ng_destination_messages_stored_total：目标端存储的消息数量（gauge）
• syslog_ng_source_messages_processed_total：源端处理的消息总数（计数器）
• syslog_ng_up：syslog-ng服务可达状态（1为可达，0为不可达，gauge）

作者信息

该导出器由https://github.com/brandond%E5%88%9B%E5%BB%BA%EF%BC%8C%E7%81%B5%E6%84%9F%E6%9D%A5%E6%BA%90%E4%BA%8Ehttps://github.com/Lusitaniae/apache_exporter/%E3%80%82