TechDocs

Telemetrie#

Telemetrie in IT-Systemen bezeichnet die automatische Erfassung und Übertragung von System- oder Anwendungsdaten wie Leistung, Fehler oder Nutzungsverhalten. Mithilfe von Telemetrie können Software, Server oder Netzwerke in Echtzeit überwacht und analysiert werden, was häufig der Fehlererkennung, Performance-Optimierung oder Sicherheitsüberwachung dient.

Für die Datenerfassung unterstützt XPhone Connect Prometheus und für die Auswertung Grafana. Prometheus wird über die Installation der Systemvoraussetzungen bereitgestellt. Aus lizenzrechtlichen Gründen darf Grafana nicht in die XPhone-Connect-Installation integriert werden und muss daher separat installiert werden.

Übersicht Prometheus

Prometheus ist ein Open-Source-Monitoring- und Alerting-System, das sich besonders für die Überwachung von Infrastruktur und Anwendungen eignet. Hier ist ein Überblick, was man alles mit Prometheus machen kann:

  • Monitoring (Metrikbasiert)

    Prometheus sammelt zeitbasierte Metriken von Systemen, Diensten und Anwendungen. Diese Metriken werden in einer Zeitreihendatenbank gespeichert.

    Beispiele
    • CPU-, RAM- und Festplattennutzung von Servern

    • Anzahl von HTTP-Anfragen pro Sekunde

    • Antwortzeiten von Webservices

    • Anzahl aktiver Nutzer

    • Status von Batch-Jobs oder Queues

  • Alerting / Benachrichtigungen

    Prometheus hat ein Alert-System namens Alertmanager.

    Features
    • Definition von Regeln wie:

      Wenn die CPU-Auslastung länger als 5 Minuten über 90 Prozent liegt, sende einen Alarm.

    • Alarme verschicken (per E-Mail, Slack, Webhook, PagerDuty etc.)

    • Wiederholungen und Eskalationen steuern

    • Alerts gruppieren

  • Service Discovery & Skalierung

    Prometheus kann automatisch Dienste finden (via Service Discovery). Dies ist besonders praktisch in dynamischen Umgebungen wie Kubernetes oder Docker Swarm. Es erkennt neue Container, Hosts oder Pods ohne manuelles Zutun.

  • Eigene Metriken

    C4B stellt eine eigene Server-Metrik bereit.

  • Exporters nutzen

    Exporters sind Brücken, die bestehende Systeme für Prometheus „sichtbar“ machen.

    Beispiele
    • node_exporter - Hardware- und OS-Metriken von Linux/Windows

    • blackbox_exporter - HTTP-, TCP-, ICMP-Checks (z.B. Webseiten-Pings)

    • mysqld_exporter, postgres_exporter - Datenbankmetriken

    • snmp_exporter - für Netzwerkgeräte

  • Use Cases

    • Server- und Netzwerkinfrastruktur überwachen

    • Applikations-Monitoring (z.B. Webservices, APIs)

    • Container-/Kubernetes-Cluster analysieren

    • Kapazitätsplanung (z.B. anhand von Langzeitdaten)

    • Frühzeitige Erkennung von Störungen

    • SLA/SLO-Überwachung

Übersicht Grafana

Grafana ist eine Open-Source-Plattform zur Visualisierung, Überwachung und Analyse von Zeitreihendaten.

  • Unterstützt zahlreiche Datenquellen, darunter:

    Beispiele
    • Zeitreihendatenbanken (Prometheus, InfluxDB, Graphite, OpenTSDB)

    • SQL-Datenbanken (MySQL, PostgreSQL, Microsoft SQL Server, Cloud- und Monitoring-Dienste)

    • Cloud Dienste (AWS CloudWatch, Azure Monitor, Google Cloud Monitoring)

    • Weitere (Elasticsearch, Loki (für Logs, Teil des Grafana-Stacks))

  • Dashboards und Visualisierung

    Beispiele
    • Interaktive, anpassbare Dashboards

    • Verschiedene Visualisierungstypen:

      • Liniendiagramme

      • Balkendiagramme

      • Heatmaps

      • Tabellen

      • Gauge, Stat, Pie etc.

    • Unterstützung für Variablen und Drilldowns

    • Darstellung von Live-Daten

  • Monitoring und Alarmierung

    Beispiele
    • Alarme direkt aus Panels oder Query-Regeln definierbar

    • Benachrichtigungen über:

      • E-Mail

      • Slack

      • Microsoft Teams

      • Webhooks

      • PagerDuty, Opsgenie u.a.

    • Schwellenwerte und Bedingungsregeln

  • Benutzerverwaltung

    Beispiele
    • Nutzer- und Teamverwaltung

    • Rollenbasierte Zugriffskontrolle

    • Unterstützung für Authentifizierung über:

      • LDAP

      • OAuth

      • SAML

      • andere externe Anbieter

  • Erweiterbarkeit und Ökosystem

    Beispiele
    • Unterstützung für Plugins (Panels, Datenquellen, Apps)

    • Grafana Cloud (gehosteter Dienst)

    • Integrierbar mit:

      • Prometheus

      • Loki (Logs)

      • Tempo (Tracing)

    • Annotations zur Markierung von Ereignissen im Zeitverlauf

  • Typische Einsatzgebiete

    • IT- und Infrastruktur-Monitoring

    • Performanceanalyse von Webanwendungen

    • Visualisierung von IoT-Daten

    • Business

Einrichtung#

Prometheus
  • Die Installation von Prometheus-Server auf dem XPhone Server erfolgt in der Betriebsart XPhone als UC Server durch den Installationsassistenten für die Systemvoraussetzungen.

  • Sie können die Prometheus Web-UI unter folgender URL im Browser öffnen:

    http://localhost:9090
    
  • Durch die XPhone Connect Sever Installation wird ein XPhone-Endpoint erstellt und die Metrik unter folgender URL veröffentlicht:

    http://localhost:9876/metrics
    
  • Öffnen Sie die Prometheus Web-UI und navigieren Sie zu Status > Targets.

    Dort sollte der XPhone-Server-Endpunkt mit dem Status up angezeigt werden.

Grafana
  • Navigieren Sie zur Grafana-Software Seite.

  • Wählen Sie die Windows-Variante von Grafana.

  • Wählen Sie die Edition Enterprise oder Open Source.

    Hinweis

    Beide Editionen sind funktional identisch. Die Enterprise-Version enthält jedoch zusätzliche Funktionen, die durch eine Lizenz freigeschaltet werden können. XPhone Connect unterstützt beide Varianten.

  • Klicken Sie auf Download the installer. Ihr Browser lädt die Installationsdatei herunter.

  • Installieren Sie die heruntergeladene MSI-Datei und folgen Sie dem Installationsassistenten.

  • Öffnen Sie Ihren Browser und rufen Sie die Grafana-Webseite auf:

    http://localhost:3000/
    
    • Die Standard-Anmeldedaten von Grafana sind:

      Benutzername: admin Passwort: admin

    • Sie werden aufgefordert das Standard-Passwort zu ändern.

  • Fügen Sie eine Datenquelle hinzu:

    • Navigieren Sie zu Connections > Data sources.

    • Klicken Sie auf Add data source.

    • Nennen Sie die Datenquelle: ds_xp_telemetry_prometheus

    • Geben Sie die Prometheus server URL ein: http://localhost:9090

    • Speichern Sie die Einstellungen.

  • Erstellen Sie neue Dashboards:

    • Die XPhone-Grafana-Dashboards befinden sich auf dem Installationsmedium unter:

      \XPhoneConnect_V10_X_XXX\Software\Server\3rdParty\Telemetrie
      
    • Navigieren Sie in der Grafana-Webseite zu Dashboards.

    • Klicken Sie auf die Schaltfläche New > Import.

    • Ziehen Sie via Drag&Drop eine JSON-Dashboarddatei aus dem o.g. Verzeichnis in die Upload-Fläche.

    • Wählen Sie die Datenquelle: ds_xp_telemetry_prometheus.

    • Klicken Sie auf Import.

    • Damit sollte das Dashboard einsatzfähig sein:

      grafana-dashboard

Bemerkung

Diese Dokumentation erhebt keinen Anspruch auf Vollständigkeit, sondern dient als erste Orientierung. Für weiterführende Informationen konsultieren Sie bitte die offiziellen Dokumentationen von Prometheus und Grafana.

Ihre Meinung zählt!

Ob Lob, hilfreiche Ideen oder ein Hinweis auf einen Fehler - wir freuen uns über jede Nachricht.
Schreiben Sie uns einfach an doku@c4b.de und helfen Sie mit, diese Dokumentation noch besser zu machen.
Vielen Dank für Ihre Unterstützung!