Ein gutes Monitoring gehört für mich zu jedem Homelab dazu. Fast alle meine Dienste werden bereits über Prometheus erfasst und in Grafana visualisiert. Nur bei Jellyfin fehlten mir genau die Informationen, die ich im Alltag sehen wollte.

Deshalb habe ich mich dazu entschieden, einen eigenen Jellyfin Prometheus Exporter zu entwickeln und als Open-Source-Projekt auf GitHub zu veröffentlichen.

---

Warum ein eigener Exporter?

Natürlich gibt es bereits einige Projekte, die Jellyfin-Metriken für Prometheus bereitstellen. Allerdings fehlten mir einige Informationen oder die vorhandenen Exporter passten nicht zu meinen Anforderungen.

Da ich ohnehin Prometheus und Grafana für das Monitoring meines gesamten Homelabs verwende, lag es nahe, einen Exporter zu entwickeln, der genau die Metriken liefert, die ich benötige.

---

Welche Informationen liefert der Exporter?

Der Exporter verbindet sich direkt mit der Jellyfin-API und stellt die Daten im Prometheus-Format bereit. Dadurch können sie problemlos von Prometheus abgefragt und anschließend in Grafana visualisiert werden.

Je nach Jellyfin-Version und Konfiguration können unter anderem folgende Informationen überwacht werden:

• Aktive Wiedergabesitzungen
• Anzahl verbundener Benutzer
• Laufende Transcodes
• Informationen zu Clients und Geräten
• Server- und Bibliotheksstatistiken
• Weitere Metriken rund um den Zustand des Jellyfin-Servers

Der Fokus lag dabei nicht darauf, möglichst viele Werte bereitzustellen, sondern sinnvolle Informationen für den täglichen Betrieb eines Medienservers.

---

Fertiges Grafana-Dashboard inklusive

Damit der Einstieg möglichst einfach ist, enthält das Repository nicht nur den Exporter selbst, sondern auch ein fertig konfiguriertes Grafana-Dashboard.

Nach der Installation müssen lediglich Prometheus und das Dashboard eingebunden werden – schon erhält man eine übersichtliche Darstellung der wichtigsten Jellyfin-Metriken, ohne erst eigene Panels erstellen zu müssen.

Natürlich kann das Dashboard jederzeit erweitert oder an die eigenen Bedürfnisse angepasst werden.

---

Open Source auf GitHub

Den kompletten Quellcode sowie eine ausführliche Installationsanleitung habe ich auf GitHub veröffentlicht.

Dort findet ihr außerdem das Grafana-Dashboard, Beispielkonfigurationen und alle Informationen zur Einrichtung.

GitHub Repository:

https://github.com/eurosatofficial/jellyfin-prometheus-exporter

Ich freue mich über Feedback, Verbesserungsvorschläge oder Pull Requests. Vielleicht hilft das Projekt ja auch anderen Homelab- oder Jellyfin-Nutzern dabei, ihren Medienserver besser im Blick zu behalten.

---

Fazit

Monitoring ist für mich inzwischen ein fester Bestandteil meines Homelabs. Durch den eigenen Jellyfin Prometheus Exporter kann ich meinen Medienserver wesentlich detaillierter überwachen und sehe auf einen Blick, was gerade passiert.

Dass bereits ein fertiges Grafana-Dashboard mitgeliefert wird, macht den Einstieg besonders einfach. Wer Prometheus und Grafana bereits nutzt, kann den Exporter innerhalb weniger Minuten integrieren und erhält sofort aussagekräftige Visualisierungen.

Dieses Projekt ist gleichzeitig ein schönes Beispiel dafür, wie aus einem persönlichen Bedarf ein Open-Source-Projekt entstehen kann, das hoffentlich auch für andere einen Mehrwert bietet.