Jellyfin导出器

![测试与构建]([] ![当前版本]([] ![Docker拉取次数]([] ![Go报告卡]([]

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

安装与使用

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

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

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

Ansible

即将推出！

Docker

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

docker run -d \
  -p 9594:9594 \
  rebelcore/jellyfin-exporter:latest \
  --jellyfin.address=[***] \
  --jellyfin.token=TOKEN

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

---
services:
  jellyfin_exporter:
    image: rebelcore/jellyfin-exporter:latest
    container_name: jellyfin_exporter
    command:
      - '--jellyfin.address=[***]
      - '--jellyfin.token=TOKEN'
    ports:
      - 9594:9594
    restart: unless-stopped

Grafana仪表板

参考此仓库查看该导出器的官方仪表板。

收集器

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

通过--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配置中，可在抓取配置下使用以下语法：

  params:
    collect[]:
      - foo
      - bar

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

开发构建与运行

前提条件：

• Go编译器
• RHEL/CentOS：glibc-static包

构建：

git clone [***]
cd jellyfin_exporter
make build
./jellyfin_exporter <flags>

查看所有可用配置参数：

./jellyfin_exporter --help

运行测试

make test

TLS端点

实验性

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

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

详见exporter-toolkit Web配置。