Verbinden von 3CX mit einer Microsoft SQL-Datenbank und Grafana

Einführung

Dieses Handbuch ist für Systeme mit V20 Update 7 gedacht und bietet einen kompakten Prozess zum Verbinden Ihres 3CX-Telefonsystems mit einer Microsoft SQL-Datenbank zur Verwendung mit Grafana zur Datenvisualisierung und Berichterstellung.

Voraussetzungen

• Ein laufender Microsoft SQL Server. Vor Ort oder auf Azure
• Administratorzugriff auf Ihren Microsoft SQL Server
• Zugriff auf die 3CX-Administrationskonsole
• Eine 3CX 16SC+-Lizenz (erforderlich für die Data Connector-Funktionalität)

Schritt 1: Erstellen der SQL-Datenbank auf Azure oder lokal

Erstellen einer SQL-Datenbank in Azure

1. Melden Sie sich hier bei Ihrem Azure-Portal an https://portal.azure.com/
2. Suchen Sie nach SQL-Servern, navigieren Sie zu ihnen und klicken Sie auf „Erstellen“.
3. Wählen oder erstellen Sie eine neue Ressourcengruppe.
4. Legen Sie einen eindeutigen Servernamen fest und wählen Sie einen Standort in der Nähe Ihrer Telefonanlage.
5. Wählen Sie „SQL-Authentifizierung verwenden“ und legen Sie Ihren Administrator-Login und ein sicheres Passwort fest.
6. Notieren Sie sich diese Anmeldedaten, da Sie sie später für die Konfiguration Ihres Datenkonnektors in der 3CX-Admin-Konsole benötigen.
7. Klicken Sie auf „Überprüfen + Erstellen“ und dann auf „Erstellen“.

8. Navigieren Sie zu SQL Servers, öffnen Sie den oben erstellten Server und notieren Sie sich den Servernamen, da Sie ihn später benötigen, um Ihren Datenkonnektor in der 3CX-Admin-Konsole zu konfigurieren.
9. Klicken Sie auf „Datenbank erstellen“.

10. Legen Sie einen eindeutigen Datenbanknamen fest.
11. Wählen Sie die Spezifikationen und die Größe der Datenbank nach Bedarf in den Abschnitten „Compute und Speicher“ aus.
12. Klicken Sie auf „Überprüfen + Erstellen“ und dann auf „Erstellen“.

13. Sobald die Datenbank erstellt ist, navigieren Sie zu SQL-Datenbanken und öffnen Sie die oben erstellte Datenbank.
14. Klicken Sie auf „Server-Firewall festlegen“.

15. Wechseln Sie zu „Öffentlicher Netzwerkzugriff“ und klicken Sie auf „Firewallregel hinzufügen“.
16. Fügen Sie die öffentliche IP-Adresse Ihrer Telefonanlage hinzu, die auf diese Datenbank zugreift, und klicken Sie auf „Speichern“.

Erstellen einer lokalen SQL-Datenbank

1. Laden Sie den lokalen Microsoft SQL Server herunter und führen Sie das Installationsprogramm von hier aus: https://www.microsoft.com/de-de/sql-server/sql-server-downloads
2. Laden Sie nach erfolgreicher Installation SQL Server Management Studio herunter und installieren Sie es.
3. Folgen Sie dem Assistenten, um SQL Server Management Studio (SSMS) zu installieren und zu starten.

4. Standardmäßig überwacht Microsoft SQL Server möglicherweise keine Ports oder dynamische Ports. Um einen bestimmten Port (z. B. Standardport 1433) zu verwenden, öffnen Sie SQLServerManager16.msc im Windows-Startmenü.
5. Gehen Sie im linken Bereich zu SQL Server-Netzwerkkonfiguration → Protokolle für SQLEXPRESS.
6. Klicken Sie mit der rechten Maustaste auf TCP/IP und klicken Sie auf „Aktivieren“.
7. Im Kontextmenü von Protokolle für SQLEXPRESS:

Doppelklicken Sie auf TCP/IP und öffnen Sie die Registerkarte „IP-Adressen“.

8. Scrollen Sie nach unten und suchen Sie den Abschnitt „IPAll“.
9. Setzen Sie TCP-Port = 1433, lassen Sie die Option „Dynamische TCP-Ports“ leer und klicken Sie auf „OK“.
10. Zurück im SQL Server-Konfigurationsmanager: Gehen Sie im linken Bereich zu „SQL Server-Dienste“.
11. Klicken Sie mit der rechten Maustaste auf Ihre Instanz (z. B. MSSQLSERVER) und klicken Sie auf „Neu starten“.

12. Öffnen Sie das oben installierte SQL Server Management Studio.
13. Sie können sich als Administrator auf dem lokalen Host mit der Windows-Authentifizierung mit dem neuen SQL Server verbinden, wie unten gezeigt.

14. Sobald Sie mit SSMS verbunden sind, klicken Sie mit der rechten Maustaste auf Datenbanken > Neue Datenbank.
15. Geben Sie der Datenbank einen eindeutigen Namen und klicken Sie auf OK.

16. Um die SQL Server-Authentifizierung für die Verbindung der Telefonanlage mit der Datenbank zu aktivieren, klicken Sie mit der rechten Maustaste auf Ihren SQL Server im linken Bereich und klicken Sie auf „Eigenschaften“.
17. Navigieren Sie zu „Sicherheit“, wählen Sie die Option „SQL Server- und Windows-Authentifizierungsmodus“ und klicken Sie auf „OK“.
18. Starten Sie Ihren SQL Server erneut, entweder über den SQL Server Manager wie oben beschrieben oder über den Task-Manager.

19. Um einen Benutzer für die PBX-Anlage zu erstellen, der sich mit dieser Datenbank verbindet, klicken Sie mit der rechten Maustaste auf „Anmeldungen“ > „Neue Anmeldung“.
20. Geben Sie Ihren Benutzernamen unter „Anmeldename“ ein.
21. Wählen Sie „SQL-Authentifizierung“ und legen Sie ein sicheres Passwort fest.
22. Deaktivieren Sie „Passwortrichtlinie erzwingen“, wenn Sie keine Komplexitätsregeln wünschen.
23. Standarddatenbank: Wählen Sie Ihre oben erstellte neue Datenbank (z. B. cdr_db).

24. Klicken Sie im Anmeldefenster links auf „Benutzerzuordnung“.
25. Wählen Sie Ihre neue Datenbank (z. B. cdr_db) aus.
26. Aktivieren Sie unter „Datenbankrollenmitgliedschaft“ die Optionen für

27. OK klicken

Step 2: Konfigurieren Sie den Datenkonnektor auf 3CX

1. Navigieren Sie zur 3CX-Admin-Konsole > Integrationen > Datenkonnektor.
2. Wählen Sie „Microsoft SQL Server“ und geben Sie Folgendes ein:

• Host: Die IP-Adresse oder der FQDN (falls verfügbar) des Hosts, auf dem Sie Microsoft SQL Server installiert haben. Oder der von Azure zugewiesene Servername.
• Port: Der Datenbankport (Standard: 1433).
• Datenbankname: Der Name der Datenbank, die Sie in Schritt 1 erstellt haben.
• Benutzername: Der Benutzername des neuen Benutzers, den Sie in Schritt 1 erstellt haben.
• Passwort: Das Passwort, das Sie für Ihren neuen Benutzer konfiguriert haben.
• Häufigkeit: Legen Sie die Häufigkeit der Datenübertragung von der Telefonanlage zu Ihrer Azure SQL-Datenbank fest.

3. Speichern Sie die Konfiguration und klicken Sie auf Ihrer Telefonanlage auf die Schaltfläche „Testen“, um die Verbindung zur Microsoft SQL-Datenbank zu überprüfen und die Erfolgsmeldung zu bestätigen. Sollte der Test fehlschlagen, überprüfen Sie Host, Port, Datenbanknamen, Benutzernamen und Passwort. Stellen Sie außerdem sicher, dass Firewalls Verbindungen von Ihrer Telefonanlage-IP zulassen.

Schritt 3: Verbinden von Grafana mit der Microsoft SQL-Datenbank

1. Melden Sie sich bei Ihrer Grafana-Instanz an (z. B. grafana.com oder Ihrem selbst gehosteten Grafana).
2. Gehen Sie zum Grafana-Konfigurationsmenü (Zahnradsymbol), klicken Sie auf „Data Sources“ und anschließend auf „Add data source“.
3. Suchen Sie nach „Microsoft SQL Server“ und wählen Sie es aus.

4. Konfigurieren Sie die Datenquelle unter „Connection“ und geben Sie die folgenden Details ein:

• Host: Geben Sie die IP oder den FQDN und den Port Ihres Microsoft SQL Servers im Format ein: IP/FQDN:1433
• Database: Der Name der Datenbank, die Sie in Schritt 1 erstellt haben.
• User: Der Benutzername des neuen Benutzers, den Sie in Schritt 1 erstellt haben
• Password: Das Passwort, das Sie für Ihren neuen Benutzer konfiguriert haben
• Authentication Type: SQL Server Authentication

5. Klicken Sie auf „Save & test“ und überprüfen Sie, ob die Meldung „Database Connection OK“ angezeigt wird. Sollten Fehler auftreten, überprüfen Sie die Verbindungsdetails und die SSL-Konfiguration. Stellen Sie außerdem sicher, dass alle Firewalls auf dem Microsoft SQL-Host oder -Netzwerk Verbindungen von Grafana-IPs zulassen.

Letztes Update
Dieses Dokument wurde zuletzt am 10. Juni 2026 aktualisiert
https://www.3cx.de/docs/microsoft-sql-server-konfiguration/