服务监控

非官方测试版翻译

本页面由 PageTurner AI 翻译（测试版）。未经项目官方认可。 发现错误？ 报告问题 →

Jellyfin 内置了两类监控与指标端点：基础健康检查端点和兼容 Prometheus 的指标端点。

健康检查端点

备注

服务器启动过程中健康检查端点无法正常工作。 监控/看门狗程序可能在数据库迁移期间意外终止服务。

Jellyfin 提供专用的 /health 端点用于检测底层服务状态。当前该端点会验证 HTTP 连接和数据库连通性，若检测通过将返回 200 OK 响应。您可使用 curl 命令进行验证：

curl -i http://myserver:8096/health

参数 -i 指示 curl 同时输出 HTTP 响应码及头部信息。

Prometheus 指标

Jellyfin 支持在 /metrics 端点提供 Prometheus 指标数据，但默认处于关闭状态以防止敏感信息意外暴露于公网。启用需编辑 /etc/jellyfin/system.xml 文件，并将配置值从 false 改为 true：

<EnableMetrics>false</EnableMetrics>

若您已配置反向代理，可通过代理设置仅允许内网访问 /metrics 端点。