rebelcore/jellyfin-exporter

Jellyfin导出器

https://github.com/rebelcore/jellyfin_exporter/actions/workflows/test.yml/badge.svg?branch=master](https://github.com/rebelcore/jellyfin_exporter/actions/workflows/test.yml) https://img.shields.io/github/v/release/rebelcore/jellyfin_exporter](https://github.com/rebelcore/jellyfin_exporter/releases/latest) https://img.shields.io/docker/pulls/rebelcore/jellyfin-exporter](https://hub.docker.com/r/rebelcore/jellyfin-exporter) https://goreportcard.com/badge/github.com/rebelcore/jellyfin_exporter](https://goreportcard.com/report/github.com/rebelcore/jellyfin_exporter)

Jellyfin媒体系统的Prometheus导出器，用Go编写，支持可插拔指标收集器，用于导出Jellyfin的各类指标。

安装与使用

如果您刚接触Prometheus和jellyfin_exporter，可参考简单分步指南。

jellyfin_exporter默认监听HTTP端口9594。更多选项可查看--help输出。

--jellyfin.token参数为必填项。您可在Jellyfin管理面板中生成API密钥。

Ansible

即将推出！

Docker

jellyfin_exporter用于监控Jellyfin媒体系统。若需容器化部署，需设置Jellyfin URL参数以使用Docker容器主机名。

bash
docker run -d \
  -p 9594:9594 \
  docker.xuanyuan.run/rebelcore/jellyfin-exporter:latest \
  --jellyfin.address=http://jellyfin:8096 \
  --jellyfin.token=TOKEN

Docker Compose配置类似，需修改相应参数：

yaml
---
services:
  jellyfin_exporter:
    image: docker.xuanyuan.run/rebelcore/jellyfin-exporter:latest
    container_name: jellyfin_exporter
    command:
      - '--jellyfin.address=http://jellyfin:8096'
      - '--jellyfin.token=TOKEN'
    ports:
      - 9594:9594
    restart: unless-stopped

Grafana仪表板

参考https://github.com/rebelcore/jellyfin_grafana%E6%9F%A5%E7%9C%8B%E8%AF%A5%E5%AF%BC%E5%87%BA%E5%99%A8%E7%9A%84%E5%AE%98%E6%96%B9%E4%BB%AA%E8%A1%A8%E6%9D%BF%E3%80%82

收集器

收集器支持多种指标收集。下表列出所有现有收集器。

通过--collector.<name>参数启用收集器。默认启用的收集器可通过--no-collector.<name>参数禁用。若需仅启用特定收集器，使用--collector.disable-defaults --collector.<name> ...。

默认启用

默认禁用

jellyfin_exporter还实现了一些默认禁用的收集器，原因因收集器而异，可能包括：

• 需要插件

您可根据需要通过在启动配置中添加参数启用额外收集器，但需谨慎。建议先在非生产环境测试，一次启用一个，然后在单个生产节点手动测试。启用额外收集器时，应通过观察scrape_duration_seconds指标监控收集是否完成且未超时，并通过scrape_samples_post_metric_relabeling指标观察基数变化。

活动收集器

活动收集器可通过--collector.activity启用，支持从Playback Reporting插件导出指标。使用前需先启用该插件，并将“数据保留时间”设置为“永久”。collector.activity.days参数默认设为100年（以天为单位）以显示最大数据量，建议保持默认以获得最佳数据报告，也可修改拉取数据的天数。

过滤启用的收集器

默认情况下，jellyfin_exporter会公开所有启用收集器的指标，这是推荐方式以避免错误。

高级用法中，可通过collect[]参数筛选指标，该参数可多次使用。在Prometheus配置中，可在https://prometheus.io/docs/prometheus/latest/configuration/configuration/#<scrape_config>下使用以下语法：

  params:
    collect[]:
      - foo
      - bar

这有助于不同Prometheus服务器从节点收集特定指标。

开发构建与运行

前提条件：

• https://golang.org/dl/
• RHEL/CentOS：glibc-static包

构建：

git clone https://github.com/rebelcore/jellyfin_exporter.git
cd jellyfin_exporter
make build
./jellyfin_exporter <flags>

查看所有可用配置参数：

./jellyfin_exporter --help

运行测试

make test

TLS端点

实验性

导出器支持通过新的Web配置文件启用TLS。

console
./jellyfin_exporter --web.config.file=web-config.yml

详见https://github.com/prometheus/exporter-toolkit/blob/master/docs/web-configuration.md%E3%80%82