Łączenie 3CX z bazą danych Microsoft SQL i Grafana

Wprowadzenie

Ten przewodnik jest przeznaczony dla systemów działających na wersji V20 Update 7 i opisuje zwięzły proces łączenia systemu telefonicznego 3CX z bazą danych Microsoft SQL w celu wizualizacji danych i raportowania za pomocą narzędzia Grafana.

Wymagania wstępne

  • Działający serwer Microsoft SQL Server (lokalny lub w Azure).
  • Dostęp administracyjny do serwera Microsoft SQL Server.
  • Dostęp do Konsoli Administracyjnej 3CX.
  • Licencja 3CX 16SC lub wyższa (wymagana dla funkcjonalności konektora danych).

Krok 1: Utworzenie bazy danych SQL w chmurze Azure lub lokalnie (on-premise)

Tworzenie bazy danych SQL w Azure

  1. Zaloguj się do swojego Portalu Azure: https://portal.azure.com/
  2. Wyszukaj i przejdź do „SQL Servers”, a następnie kliknij „Create” (Utwórz).
  3. Wybierz lub utwórz nową grupę zasobów („resource group”).
  4. Ustaw unikalną nazwę serwera („Server Name”) i wybierz lokalizację w pobliżu Twojej centrali PBX.
  5. Wybierz opcję „Use SQL Authentication” i ustaw login administratora oraz silne hasło.
  6. Zanotuj te dane, będą potrzebne później do konfiguracji konektora danych w 3CX.
  7. Kliknij „Review + Create”, a następnie „Create”.

  1. Przejdź do „SQL Servers”, otwórz nowo utworzony serwer i zanotuj jego nazwę („Server Name”), ponieważ będzie to potrzebne później do skonfigurowania Data Connector w konsoli administracyjnej 3CX.
  2. Kliknij „Create Database” (Utwórz bazę danych).

  1. Ustaw unikalną nazwę bazy danych.
  2. Wybierz parametry i rozmiar bazy danych w sekcjach „Compute” oraz „Storage” zgodnie z potrzebami.
  3. Kliknij „Review + Create”, a następnie „Create”.

  1. Gdy baza zostanie utworzona, przejdź do „SQL Databases” i otwórz powyższą bazę danych, którą właśnie utworzyłeś.
  2. Kliknij „Set Server Firewall” (Ustaw firewall serwera).

  1. Zmień „Public network access” na „Selected Networks” i kliknij „Add a firewall rule” (Dodaj regułę firewalla).
  2. Dodaj publiczny adres IP swojej centrali PBX, która będzie łączyć się z bazą, i kliknij „Save” (Zapisz).

Tworzenie lokalnej bazy danych SQL

  1. Pobierz lokalną wersję Microsoft SQL Server i uruchom instalator stąd:

https://www.microsoft.com/en-us/sql-server/sql-server-downloads

  1. Po zakończeniu instalacji pobierz i zainstaluj SQL Server Management Studio (SSMS).
  2. Postępuj zgodnie z instrukcjami kreatora, aby zainstalować i uruchomić SSMS.

  1. Domyślnie serwer może nie nasłuchiwać na żadnych portach. Aby ustawić konkretny port (np. domyślny 1433), przejdź do Menu Start w systemie Windows, wyszukaj i otwórz „SQLServerManager16.msc”.
  2. W lewym panelu przejdź do „SQL Server Network Configuration” → „Protocols for SQLEXPRESS”.
  3. Kliknij prawym przyciskiem myszy na „TCP/IP” i wybierz „Enable” (Włącz).
  4. W tej samej sekcji Protocols for SQLEXPRESS:

Kliknij dwukrotnie „TCP/IP” i przejdź do zakładki „IP Addresses”.

  1. Przewiń na sam dół do sekcji „IPAll”.
  2. Ustaw „TCP Port” = 1433, a pole „TCP Dynamic Ports” pozostaw puste. Kliknij OK.
  3. W „SQL Server Configuration Manager” przejdź do „SQL Server Services” w lewym panelu.
  4. Kliknij prawym przyciskiem myszy na swoją instancję (np. MSSQLSERVER) i wybierz „Restart”.

  1. Otwórz SQL Server Management Studio (SSMS).
  2. Możesz połączyć się z lokalnym serwerem jako administrator, korzystając z „Windows Authentication”.

  1. Po połączeniu kliknij prawym przyciskiem myszy na „Databases” > „New Database”.
  2. Nadaj bazie unikalną nazwę i kliknij OK.

  1. Aby włączyć uwierzytelnianie SQL Server (wymagane dla PBX), kliknij prawym przyciskiem myszy na swój serwer w lewym panelu i wybierz „Properties” (Właściwości).
  2. Przejdź do zakładki „Security”, wybierz opcję „SQL Server and Windows Authentication mode” i kliknij OK.
  3. Ponownie zrestartuj serwer SQL (przez SQL Server Manager lub menedżera zadań).

  1. Aby utworzyć użytkownika dla centrali PBX, kliknij prawym przyciskiem myszy na „Logins” > „New Login”.
  2. Ustaw nazwę użytkownika w polu „Login Name”.
  3. Wybierz „SQL Authentication” i ustaw silne hasło.
  4. Odznacz „Enforce password policy”, jeśli nie chcesz stosować reguł złożoności.
  5. W polu „Default database” wybierz nowo utworzoną bazę danych (np. cdr_db).

  1. W tym samym oknie („Login”) kliknij „User Mapping” po lewej stronie.
  2. Wybierz nową bazę danych (np. cdr_db).
  3. W sekcji „Database role membership” zaznacz opcje:

db_datareader, db_datawriter,db_ddladmin

  1. Kliknij OK.

Krok 2: Konfiguracja konektora danych (Data Connector) w 3CX

  1. W Konsoli Administracyjnej 3CX przejdź do „Integrations” (Integracje) > „Data Connector”.
  2. Wybierz „Microsoft SQL Server” i wprowadź:
  • Host: Adres IP lub FQDN (jeśli jest dostępny) hosta, na którym zainstalowano Microsoft SQL Server, lub nazwa serwera podana przez Azure.
  • Port: Port bazy danych (domyślnie: 1433).
  • Database Name: Nazwa bazy danych utworzonej w kroku 1.
  • Username: Nazwa użytkownika dla nowego użytkownika utworzonego w kroku 1.
  • Password: Hasło skonfigurowane dla nowego użytkownika.
  • Data Types: Wybierz, jakie dane mają zostać przesłane.
  • Frequency: Ustaw częstotliwość transferu danych z centrali PBX do bazy danych Azure SQL.
  1. Zapisz konfigurację i kliknij przycisk „Test”, w centrali PBX, aby sprawdzić połączenie z bazą danych Microsoft SQL i upewnić się, że pojawi się komunikat o pomyślnym zakończeniu. Jeśli test się nie powiedzie, sprawdź jeszcze raz adres hosta, port, nazwę bazy danych, nazwę użytkownika i hasło. Sprawdź również, czy zapory sieciowe zezwalają na połączenia z adresu IP centrali PBX.

Krok 3: Połączenie Grafana z bazą danych Microsoft SQL

  1. Zaloguj się do swojej instancji Grafana (np. grafana.com lub własna hostowana instancja Grafana).
  2. Przejdź do menu konfiguracji Grafana (ikona koła zębatego), kliknij „Data Sources” (Źródła danych) i kliknij „Add data source” (Dodaj źródło danych).
  3. Wyszukaj i wybierz „Microsoft SQL Server”.

  1. Skonfiguruj źródło danych w sekcji „Connection” (Połączenie), wprowadzając następujące szczegóły:
  • Host: Wprowadź adres IP lub FQDN oraz port swojego serwera Microsoft SQL Server w formacie: IP/FQDN:1433.
  • Database: Nazwa bazy danych utworzonej w kroku 1.
  • User: Nazwa użytkownika dla nowego użytkownika utworzonego w kroku 1.
  • Password: Hasło skonfigurowane dla nowego użytkownika.
  • Authentication Type: SQL Server Authentication.

  1. Kliknij „Save & test” i zweryfikuj, czy otrzymałeś komunikat „Database Connection OK” (Połączenie z bazą danych OK). Jeśli napotkasz błędy, sprawdź ponownie szczegóły połączenia oraz konfigurację SSL. Upewnij się również, czy jakiekolwiek zapory sieciowe (firewalle) na hoście Microsoft SQL lub w sieci zezwalają na połączenia z adresów IP Grafana.



Ostatnia aktualizacja
Ten dokument został ostatnio zaktualizowany 2 czerwca 2026 r.
https://www.3cx.pl/docs/konfiguracja-serwera-microsoft-sql/