Observability
FunkArr stellt einen Prometheus-kompatiblen /metrics-Endpunkt bereit. Damit lassen sich Downloads, Suchen, Scoring, Enrichment, und Rulesets mit jedem Prometheus-kompatiblen Monitoring-Stack überwachen.
Metriken
Download (FunkArr.Download)
| Metrik | Typ | Beschreibung |
|---|---|---|
funkarr_download_completed_total | Counter | Abgeschlossene Downloads |
funkarr_download_failed_total | Counter | Fehlgeschlagene Downloads (Tag: reason) |
funkarr_download_duration_seconds | Histogram | Download-Dauer (FFmpeg) (Tag: status = completed/failed) |
funkarr_download_bytes_total | Counter | Heruntergeladene Bytes |
funkarr_download_enqueued_total | Counter | In die Queue aufgenommene Downloads |
funkarr_download_cancelled_total | Counter | Abgebrochene Downloads |
funkarr_download_retries_total | Counter | Wiederholungsversuche (Tag: reason) |
funkarr_download_move_failed_total | Counter | Fehlgeschlagene Dateiverschiebungen |
funkarr_download_subtitle_total | Counter | Untertitel-Aufbereitungen (Tags: status = succeeded/failed/unavailable, format) |
funkarr_download_subtitle_duration_seconds | Histogram | Dauer der Untertitel-Aufbereitung |
funkarr_download_queue_size | Gauge | Aktuelle Queue-Tiefe |
funkarr_download_active | Gauge | Aktuell laufende Downloads |
funkarr_download_paused | Gauge | Downloads pausiert (0/1) |
funkarr_download_schedule_enabled | Gauge | Zeitplan aktiv (0/1) |
Search (FunkArr.Search)
| Metrik | Typ | Beschreibung |
|---|---|---|
funkarr_search_requests_total | Counter | Suchanfragen (Tag: source) |
funkarr_search_matches_total | Counter | Suchanfragen mit akzeptierten Ergebnissen (Tag: source) |
funkarr_search_no_match_total | Counter | Suchanfragen ohne akzeptierte Ergebnisse (Tag: source) |
funkarr_search_duration_seconds | Histogram | End-to-End Suchdauer (Tags: source, type) |
funkarr_search_timeouts_total | Counter | Such-Timeouts (Tag: source) |
funkarr_search_failed_total | Counter | Fehlgeschlagene Suchen (Tag: source) |
funkarr_search_mediathek_errors_total | Counter | MediathekViewWeb API-Fehler |
funkarr_search_results_per_request | Histogram | Ergebnisanzahl pro Suchanfrage |
funkarr_search_evaluations_total | Counter | Anzahl der Auswertungen durch die Auswertungs-Worker (Tags: source, type, status) |
funkarr_search_evaluation_duration_seconds | Histogram | Dauer einer Auswertung von der Regelwerk-Auflösung bis zu den Releases (Tags: source, type) |
funkarr_search_mediathek_cache_hits_total | Counter | Cache-Treffer bei MediathekViewWeb-Antworten |
funkarr_search_mediathek_cache_misses_total | Counter | Cache-Fehlzugriffe bei MediathekViewWeb-Antworten |
Feed (FunkArr.Feed)
| Metrik | Typ | Beschreibung |
|---|---|---|
funkarr_feed_crawls_total | Counter | Einlese-Läufe nach Ergebnis (Tag: status) |
funkarr_feed_probes_unchanged_total | Counter | Läufe ohne neues Filmlisten-Update |
funkarr_feed_items_seen_total | Counter | Neu eingesammelte Mediathek-Einträge |
funkarr_feed_unmatched_total | Counter | Neue Einträge ohne passendes Regelwerk |
funkarr_feed_published_total | Counter | In den Feed veröffentlichte Releases |
funkarr_feed_rejected_total | Counter | Vom Feed-Filter abgelehnte Releases (Tag: reason; derzeit nicht befüllt) |
funkarr_feed_gaps_total | Counter | Läufe, die das Zeitfenster nicht vollständig abdecken konnten |
funkarr_feed_crawl_duration_seconds | Histogram | Dauer eines Einlese-Laufs |
funkarr_feed_entries | Gauge | Aktuell im Feed enthaltene Releases |
Scoring (FunkArr.Scoring)
| Metrik | Typ | Beschreibung |
|---|---|---|
funkarr_scoring_accepted_total | Counter | Vom Scoring akzeptierte Ergebnisse (Tag: ruleSetId) |
funkarr_scoring_rejected_total | Counter | Vom Scoring abgelehnte Ergebnisse (Tag: ruleSetId) |
funkarr_scoring_duration_seconds | Histogram | Scoring-Dauer |
funkarr_scoring_runs_total | Counter | Scoring-Aufrufe |
funkarr_scoring_regex_timeouts_total | Counter | Regex-Timeouts |
funkarr_scoring_no_config_total | Counter | Anfragen ohne passende Konfiguration |
Enrichment (FunkArr.Enrichment)
| Metrik | Typ | Beschreibung |
|---|---|---|
funkarr_enrichment_requests_total | Counter | Enrichment-Anfragen (Tags: api = tmdb/tvdb, status = hit/miss) |
funkarr_enrichment_failed_total | Counter | Fehlgeschlagene Enrichments (Tag: api) |
funkarr_enrichment_duration_seconds | Histogram | API-Aufruf-Dauer (Tag: api) |
funkarr_enrichment_items_enriched_total | Counter | Angereicherte Items (Tag: api) |
funkarr_enrichment_cache_entries | Gauge | Aktuelle Cache-Einträge |
funkarr_enrichment_cache_hits_total | Counter | Cache-Treffer |
funkarr_enrichment_cache_misses_total | Counter | Cache-Fehlzugriffe |
History (FunkArr.History)
| Metrik | Typ | Beschreibung |
|---|---|---|
funkarr_history_recordings_total | Counter | Aufgezeichnete Scoring-Ergebnisse |
funkarr_history_trimmed_total | Counter | Bereinigte alte Einträge |
funkarr_history_queries_total | Counter | Abgerufene History-Anfragen (Tag: type) |
RuleSet (FunkArr.RuleSet)
| Metrik | Typ | Beschreibung |
|---|---|---|
funkarr_ruleset_loaded_total | Counter | Geladene Rulesets (Tag: source) |
funkarr_ruleset_removed_total | Counter | Entfernte Rulesets |
funkarr_ruleset_active | Gauge | Aktive Rulesets |
funkarr_ruleset_update_checks_total | Counter | Community-Update-Prüfungen |
funkarr_ruleset_updates_applied_total | Counter | Angewendete Community-Updates |
funkarr_ruleset_update_errors_total | Counter | Fehlgeschlagene Community-Updates |
funkarr_ruleset_validation_errors_total | Counter | Validierungsfehler |
funkarr_ruleset_scans_total | Counter | Scan/Rescan-Aufrufe |
funkarr_ruleset_file_events_total | Counter | Dateisystem-Watcher-Events (Tag: type) |
Standardmetriken
Zusätzlich werden ASP.NET Core HTTP-Metriken und .NET Runtime-Metriken (CPU, Speicher, GC, Threads) unter ihren Standard-OpenTelemetry-Namen exportiert. Die Unterscheidung zu anderen .NET-Services erfolgt über das Prometheus job-Label in der Scrape-Konfiguration.
Konfiguration
Der /metrics-Endpunkt ist immer aktiv und erfordert keine Konfiguration. Er ist unter http://<host>:6969/metrics erreichbar. Metriknamen werden im Prometheus-Format exportiert (Punkte werden zu Unterstrichen, z. B. funkarr.download.queue_size wird zu funkarr_download_queue_size).
Health-Checks
/healthz führt folgende Prüfungen aus:
| Prüfung | Status bei Fehler |
|---|---|
data-directory, complete-directory, incomplete-directory (müssen beschreibbar sein) | Unhealthy (503) |
ffmpeg (im PATH gefunden) | Unhealthy (503) |
mediathekviewweb (erreichbar, 3 s Timeout) | Degraded (weiterhin 200) |
/alive ist ein einfacher Liveness-Probe und gibt immer 200 zurück.
Prometheus Scrape-Konfiguration
scrape_configs:
- job_name: funkarr
static_configs:
- targets: ['funkarr:6969']Grafana
Die Metriken lassen sich direkt in Grafana visualisieren. Beispiel-Queries:
- Queue-Tiefe:
funkarr_download_queue_size - Download-Rate:
rate(funkarr_download_completed_total[5m]) - Sucherfolgsrate:
rate(funkarr_search_matches_total[5m]) / rate(funkarr_search_requests_total[5m]) - Scoring-Dauer (p95):
histogram_quantile(0.95, rate(funkarr_scoring_duration_seconds_bucket[5m])) - Untertitel-Fehlerrate:
rate(funkarr_download_subtitle_total{status="failed"}[5m]) - MediathekViewWeb Cache-Trefferrate:
rate(funkarr_search_mediathek_cache_hits_total[5m]) / (rate(funkarr_search_mediathek_cache_hits_total[5m]) + rate(funkarr_search_mediathek_cache_misses_total[5m])) - Enrichment Cache-Trefferrate:
rate(funkarr_enrichment_requests_total{status="hit"}[5m]) / rate(funkarr_enrichment_requests_total[5m]) - Aktive Rulesets:
funkarr_ruleset_active - Download-Wiederholungsrate:
rate(funkarr_download_retries_total[5m])