sequra/logstash_exporter

Logstash Exporter

Prometheus exporter，用于收集Logstash 5.0及以上版本的指标数据，支持不同版本Logstash的兼容性适配。

版本兼容性

Logstash的API指标可能随版本变化（如v7.3.0），因此logstash_exporter版本号前三位对应最低支持的Logstash版本，第四位为自身迭代版本：

• v7.3.0.0：最低支持Logstash 7.3.0
• v5.0.0.0：最低支持Logstash 5.0且低于7.3.0

分支对应：master（最新支持版本）、v7.3.0（>=7.3.0）、v5.0.0（5.0<=版本<7.3.0）

核心功能

• 收集Logstash的JVM、节点、内存、管道、插件、进程等多维度指标
• 暴露HTTP接口供Prometheus抓取指标
• 支持日志级别、监听地址等参数配置

使用场景

• 监控Logstash服务运行状态（如JVM内存使用、管道事件处理量）
• 结合Prometheus和Grafana构建Logstash监控dashboard
• 排查Logstash性能瓶颈（如GC时长、队列大小）

配置说明

Docker部署示例

bash
# 基本运行（默认监听9198端口，连接本地Logstash的9600端口）
docker run -d -p 9198:9198 sequra/logstash_exporter

# 指定Logstash端点
docker run -d -p 9198:9198 sequra/logstash_exporter --logstash.endpoint=http://your-logstash-host:9600

# 自定义监听地址和日志级别
docker run -d -p 1234:1234 sequra/logstash_exporter --web.listen-address=:1234 --log.level=debug

主要参数

• --logstash.endpoint: Logstash指标API地址（默认：http://localhost:9600）
• --web.listen-address: 指标暴露监听地址（默认：:9198）
• --log.level: 日志级别（可选：debug/info/warn/error/fatal，默认：info）
• --log.format: 日志格式（默认：logger:stderr）

已实现的指标

涵盖JVM信息、节点状态、内存使用、管道事件、插件统计、进程资源等指标，关键指标包括：

• logstash_node_up: Logstash节点在线状态（1=在线，0=离线）
• logstash_node_mem_heap_used_bytes: JVM堆内存使用量
• logstash_node_pipeline_events_in_total: 管道接收事件总数
• logstash_node_plugin_documents_successes_total: 插件文档处理成功数

集成测试

若需验证与特定Logstash版本的兼容性，请参考integration-tests/README.md。