markuslindenberg/icecast_exporter

Prometheus Icecast Exporter

这是一个简单的Prometheus exporter，用于从Icecast流媒体服务器抓取统计数据。它依赖Icecast 2.4.0或更高版本提供的JSON API（/status-json.xsl）。

默认情况下，icecast_exporter在9146端口监听HTTP请求，以暴露监控指标。

核心功能

• 抓取Icecast服务器的运行状态数据（如在线听众数、流状态等）
• 将数据转换为Prometheus兼容的指标格式
• 支持自定义抓取URI、超时时间及日志配置

使用场景

• 监控Icecast流媒体服务器的实时运行状态
• 集成到Prometheus+Grafana体系中，实现流服务的可视化监控
• 告警配置：当听众数异常波动或服务不可用时触发告警

安装与运行

Docker部署

bash
# 拉取镜像
docker pull markuslindenberg/icecast_exporter

# 运行容器（替换icecast地址为实际服务地址）
docker run --rm -p 9146:9146 markuslindenberg/icecast_exporter -icecast.scrape-uri http://your-icecast-server:8000/status-json.xsl

参数配置说明

通过命令行参数可自定义 exporter 行为：

# 查看所有参数
go run icecast_exporter --help

主要参数：
-icecast.scrape-uri string：Icecast数据抓取URI（默认：http://localhost:8000/status-json.xsl）
-icecast.timeout duration：抓取超时时间（默认：5s）
-web.listen-address string：监听地址（默认：":9146"）
-web.telemetry-path string：指标暴露路径（默认："/metrics"）
-log.level value：日志级别（可选：debug/info/warn/error/fatal）

访问http://localhost:9146/metrics即可查看Prometheus格式的指标数据。