Metriken und Grafana

Castreon veröffentlicht Prometheus-Metriken unter der Adresse /metrics des Servers: Zustand und Gesundheit jedes Kanals, Bitrate, Clients, Neustarts, DVB-Signal und -Fehler, Serverlast, Version und Ablaufdatum der Lizenz. Ein fertiges Grafana-Dashboard ist dabei.

Einrichtung

Öffnen Sie Einstellungen → Überwachung (Grafana).

1. Prometheus

1. Klicken Sie auf Fragment kopieren und fügen Sie es in die Prometheus-Konfiguration (prometheus.yml) unter scrape_configs ein.
2. Tragen Sie die Adresse des Prometheus-Servers unter Erlaubte Adressen ein (ebenfalls in den Einstellungen) — /metrics durchläuft dieselbe Prüfung wie die Streams.
3. Laden Sie Prometheus neu. Nach wenigen Sekunden erscheint der Castreon-Server als aktives Ziel.

2. Grafana

1. Klicken Sie auf Grafana-Dashboard herunterladen.
2. In Grafana: Dashboards → New → Import, die heruntergeladene Datei hochladen und die Prometheus-Datenquelle wählen.

Das Dashboard zeigt den Server, die Kanäle und die DVB-Quellen. Mehrere Castreon-Server lassen sich im selben Dashboard verfolgen.

Warnungen per Telefon oder E-Mail

Castreon selbst verschickt außerhalb des Panels keine Benachrichtigungen. Für Warnungen per Telefon, E-Mail, Telegram oder Slack nutzen Sie Alertmanager (Prometheus) oder die Warnungen in Grafana auf Basis der Castreon-Metriken. Einige sinnvolle Regeln:

• ein Kanal, der länger als ein paar Minuten nicht gesund ist;
• DVB-Kontinuitätsfehler über einem Schwellenwert;
• die Lizenz läuft in weniger als 7 Tagen ab (Metrik zum Lizenzablauf);
• CPU oder Arbeitsspeicher über 90 %.

Sicherheit

Die Metriken enthalten die Kanalnamen und die Anzahl der Clients. Lassen Sie /metrics nicht offen: Beschränken Sie den Zugriff über Erlaubte Adressen auf Ihren Prometheus-Server.