Skip to content

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) ​

MetrikTypBeschreibung
funkarr_download_completed_totalCounterAbgeschlossene Downloads
funkarr_download_failed_totalCounterFehlgeschlagene Downloads (Tag: reason)
funkarr_download_duration_secondsHistogramDownload-Dauer (FFmpeg) (Tag: status = completed/failed)
funkarr_download_bytes_totalCounterHeruntergeladene Bytes
funkarr_download_enqueued_totalCounterIn die Queue aufgenommene Downloads
funkarr_download_cancelled_totalCounterAbgebrochene Downloads
funkarr_download_retries_totalCounterWiederholungsversuche (Tag: reason)
funkarr_download_move_failed_totalCounterFehlgeschlagene Dateiverschiebungen
funkarr_download_subtitle_totalCounterUntertitel-Aufbereitungen (Tags: status = succeeded/failed/unavailable, format)
funkarr_download_subtitle_duration_secondsHistogramDauer der Untertitel-Aufbereitung
funkarr_download_queue_sizeGaugeAktuelle Queue-Tiefe
funkarr_download_activeGaugeAktuell laufende Downloads
funkarr_download_pausedGaugeDownloads pausiert (0/1)
funkarr_download_schedule_enabledGaugeZeitplan aktiv (0/1)
MetrikTypBeschreibung
funkarr_search_requests_totalCounterSuchanfragen (Tag: source)
funkarr_search_matches_totalCounterSuchanfragen mit akzeptierten Ergebnissen (Tag: source)
funkarr_search_no_match_totalCounterSuchanfragen ohne akzeptierte Ergebnisse (Tag: source)
funkarr_search_duration_secondsHistogramEnd-to-End Suchdauer (Tags: source, type)
funkarr_search_timeouts_totalCounterSuch-Timeouts (Tag: source)
funkarr_search_failed_totalCounterFehlgeschlagene Suchen (Tag: source)
funkarr_search_mediathek_errors_totalCounterMediathekViewWeb API-Fehler
funkarr_search_results_per_requestHistogramErgebnisanzahl pro Suchanfrage
funkarr_search_evaluations_totalCounterAnzahl der Auswertungen durch die Auswertungs-Worker (Tags: source, type, status)
funkarr_search_evaluation_duration_secondsHistogramDauer einer Auswertung von der Regelwerk-Auflösung bis zu den Releases (Tags: source, type)
funkarr_search_mediathek_cache_hits_totalCounterCache-Treffer bei MediathekViewWeb-Antworten
funkarr_search_mediathek_cache_misses_totalCounterCache-Fehlzugriffe bei MediathekViewWeb-Antworten

Feed (FunkArr.Feed) ​

MetrikTypBeschreibung
funkarr_feed_crawls_totalCounterEinlese-Läufe nach Ergebnis (Tag: status)
funkarr_feed_probes_unchanged_totalCounterLäufe ohne neues Filmlisten-Update
funkarr_feed_items_seen_totalCounterNeu eingesammelte Mediathek-Einträge
funkarr_feed_unmatched_totalCounterNeue Einträge ohne passendes Regelwerk
funkarr_feed_published_totalCounterIn den Feed veröffentlichte Releases
funkarr_feed_rejected_totalCounterVom Feed-Filter abgelehnte Releases (Tag: reason; derzeit nicht befüllt)
funkarr_feed_gaps_totalCounterLäufe, die das Zeitfenster nicht vollständig abdecken konnten
funkarr_feed_crawl_duration_secondsHistogramDauer eines Einlese-Laufs
funkarr_feed_entriesGaugeAktuell im Feed enthaltene Releases

Scoring (FunkArr.Scoring) ​

MetrikTypBeschreibung
funkarr_scoring_accepted_totalCounterVom Scoring akzeptierte Ergebnisse (Tag: ruleSetId)
funkarr_scoring_rejected_totalCounterVom Scoring abgelehnte Ergebnisse (Tag: ruleSetId)
funkarr_scoring_duration_secondsHistogramScoring-Dauer
funkarr_scoring_runs_totalCounterScoring-Aufrufe
funkarr_scoring_regex_timeouts_totalCounterRegex-Timeouts
funkarr_scoring_no_config_totalCounterAnfragen ohne passende Konfiguration

Enrichment (FunkArr.Enrichment) ​

MetrikTypBeschreibung
funkarr_enrichment_requests_totalCounterEnrichment-Anfragen (Tags: api = tmdb/tvdb, status = hit/miss)
funkarr_enrichment_failed_totalCounterFehlgeschlagene Enrichments (Tag: api)
funkarr_enrichment_duration_secondsHistogramAPI-Aufruf-Dauer (Tag: api)
funkarr_enrichment_items_enriched_totalCounterAngereicherte Items (Tag: api)
funkarr_enrichment_cache_entriesGaugeAktuelle Cache-Einträge
funkarr_enrichment_cache_hits_totalCounterCache-Treffer
funkarr_enrichment_cache_misses_totalCounterCache-Fehlzugriffe

History (FunkArr.History) ​

MetrikTypBeschreibung
funkarr_history_recordings_totalCounterAufgezeichnete Scoring-Ergebnisse
funkarr_history_trimmed_totalCounterBereinigte alte Einträge
funkarr_history_queries_totalCounterAbgerufene History-Anfragen (Tag: type)

RuleSet (FunkArr.RuleSet) ​

MetrikTypBeschreibung
funkarr_ruleset_loaded_totalCounterGeladene Rulesets (Tag: source)
funkarr_ruleset_removed_totalCounterEntfernte Rulesets
funkarr_ruleset_activeGaugeAktive Rulesets
funkarr_ruleset_update_checks_totalCounterCommunity-Update-Prüfungen
funkarr_ruleset_updates_applied_totalCounterAngewendete Community-Updates
funkarr_ruleset_update_errors_totalCounterFehlgeschlagene Community-Updates
funkarr_ruleset_validation_errors_totalCounterValidierungsfehler
funkarr_ruleset_scans_totalCounterScan/Rescan-Aufrufe
funkarr_ruleset_file_events_totalCounterDateisystem-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üfungStatus 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 ​

yaml
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])