Bereitstellung von 3CX Grafana-Visualisierungen aus dem Grafana Marketplace

Einführung

Die 3CX Grafana-Visualisierungen sind im Grafana Marketplace verfügbar und ermöglichen die schnelle und einfache Bereitstellung vorgefertigter 3CX-Dashboards. Diese Anleitung gilt für 3CX Version 20, Update 7 (SP7) und höher.

Die Funktion „Datenkonnektoren“ erfordert eine Lizenz ab Version 16SC.

Voraussetzungen

Vor der Bereitstellung des 3CX Grafana-Plugins stellen Sie bitte sicher, dass Folgendes konfiguriert ist:

  • Ein funktionierender Datenkonnektor (siehe Anleitungen für):
  • Datenübertragungsoptionen für die Metriken aktiviert, die Sie in Grafana visualisieren möchten (z. B. Anrufliste (CDR), Systemmetriken usw.).

Datenübertragungsoptionen

Schritt 1: Registrieren Sie sich für Grafana

  • Besuchen Sie Grafana und registrieren Sie sich für ein neues Konto (alle Tarife, einschließlich des kostenlosen Tarifs, werden unterstützt).
  • Richten Sie bei der Kontoerstellung Ihren Grafana Stack ein – dies ist die Basis-URL, unter der Ihre Dashboards gehostet werden.

Schritt 2: Fügen Sie Ihre 3CX-Datenquelle hinzu

In diesem Beispiel verwenden wir MySQL. Informationen zu anderen Datenbanken finden Sie in der entsprechenden Dokumentation des Datenkonnektors.

  • In Grafana klicken Sie auf „Startseite“, erweitern den Menüpunkt „Verbindungen“ und wählen „Neue Verbindung hinzufügen“.

Startseite > Verbindugen

  • Wählen Sie „MySQL-Datenquelle“ (oder den von Ihnen gewählten Konnektortyp).

MySQL-Datenquelle

  • Wählen Sie „Neue Datenquelle hinzufügen“.

Neue Datenquelle hinzufügen

  • Geben Sie alle relevanten Details für Ihre Datenbankverbindung ein und klicken Sie anschließend auf „Speichern & Testen“, um die Einstellungen zu bestätigen.
  • Sie sollten einen Datenbankbenutzer verwenden, der ausschließlich über SELECT-Berechtigungen für die 3CX-Tabellen verfügt.

Datenbankbenutzer

Möglicherweise möchten Sie den Zugriff auf Ihre Datenbank weiter einschränken, indem Sie die von Grafana hier bereitgestellten IP-Adressen auf der Zulassungsliste verwenden.

Schritt 3: Plugin einrichten

  • Navigieren Sie über Grafana Home->Administration->Plugins und Daten->Plugins zum Plugin Marketplace.

Plugin Marketplace

  • Klicken Sie auf der 3CX-Plugin-Seite auf Installieren.

3CX-Plugin-Seite

  • Nach Abschluss der Installation (einige Sekunden bis wenige Minuten) erscheint die Schaltfläche „Aktivieren“. Gegebenenfalls muss die Seite neu geladen werden.
  • Sobald die Schaltfläche sichtbar ist, klicken Sie darauf.

Aktivieren

  • Die Seite wird aktualisiert und unter „Weitere Apps“ erscheint die neue Option „3CX (& Konfiguration)“.
  • Gehen Sie zu „Konfiguration“ und wählen Sie die zuvor erstellte Datenquelle aus. Bei Auswahl einer kompatiblen Datenquelle erscheint ein grünes Häkchen und die Option „Dashboards veröffentlichen“ wird verfügbar.
  • Klicken Sie darauf, um fortzufahren.

3CX Plugin Konfiguration

Schritt 4: Dashboards ansehen

  • Die Seite sollte sich automatisch aktualisieren und die Dashboard-Liste unter der 3CX-App öffnen.

Dashboardliste

  • Die Dashboards sind nun auch in einem 3CX-Ordner im Hauptbereich „Dashboards“ verfügbar.

Dashboards

  • Durch Anklicken eines beliebigen Eintrags werden die verfügbaren Daten sofort geladen und angezeigt.

Dashboard Daten

Schritt 5: Bereitstellung auf mehreren Systemen und Anpassung

Wenn Sie mehrere 3CX-Instanzen innerhalb desselben Grafana-Stacks (Domäne) überwachen oder die bereitgestellten Vorlagen anpassen möchten, können Sie Kopien davon mithilfe der Exportfunktion erstellen. Diese finden Sie oben in jeder Dashboard-Ansicht.

Anschließend können Sie die Kopien im Hauptbereich „Dashboards“ importieren. Sie werden aufgefordert, eine neue eindeutige Kennung für dieses Dashboard innerhalb Ihres Stacks sowie die zu verbindende Datenbank (vom gleichen Typ wie die ursprüngliche Bereitstellung) auszuwählen.

Schritt 6: Alarmierung

Grafana ermöglicht es Ihnen, Alarmauslöser für alle erfassten Metriken festzulegen. Hier ist ein Beispiel, wie Sie einen Alarm für hohe CPU-Auslastung hinzufügen.

  • Im Dashboard „Gesundheit und Leistung“ wählen Sie „Neue Alarmregel“ im Menü „+“.

Neue Alarmregel

  • Geben Sie Ihrer Alarmmeldung einen Namen und definieren Sie die grundlegenden Parameter, die überwacht werden sollen.

Parameter

  • Fahren Sie mit den nächsten Schritten fort, indem Sie verschiedene Metaparameter für die Benachrichtigung konfigurieren, wie z. B. Ordner und Tags sowie die Benachrichtigungsempfänger und den Benachrichtigungstext und die Runbook-URL.

Benachrichtigungen

Siehe auch

Letztes Update

Dieses Dokument wurde zuletzt am 4. August 2026 aktualisiert.

https://www.3cx.de/docs/grafana-pbx-reports/