Łączenie 3CX z samodzielną bazą PostgreSQL i Grafana

Wprowadzenie

Ten przewodnik zawiera opis zwięzłego procesu łączenia systemu telefonicznego 3CX z samodzielną bazą danych PostgreSQL w celu wizualizacji danych i raportowania za pomocą narzędzia Grafana.

Krok 1: Utworzenie bazy danych PostgreSQL

  1. Instalacja PostgreSQL
  • Windows: Pobierz instalator ze strony https://www.postgresql.org/download/windows/ i postępuj zgodnie z instrukcjami kreatora.
  • Linux (Debian): Uruchom: sudo apt update && sudo apt install -y postgresql. Zweryfikuj klaster poleceniem: pg_lsclusters. Jeśli to konieczne, utwórz go: sudo pg_createcluster <major-version> main --start.
    Zapamiętaj hasło superużytkownika postgres oraz szczegóły instalacji (domyślny port 5432).
  1. Tworzenie użytkownika i bazy danych PostgreSQL
  • Windows: Otwórz narzędzie psql.
  • Następnie wykonaj polecenia SQL:
                CREATE ROLE twoj_uzytkownik WITH LOGIN PASSWORD 'twoje_haslo';
            CREATE DATABASE twoja_baza OWNER twoj_uzytkownik;
  • Linux (Debian):

sudo -u postgres createuser <nazwa_uzytkownika> -P
        sudo -u postgres createdb <nazwa_bazy> -O <nazwa_uzytkownika>

Zastąp twoj_uzytkownik, twoje_haslo oraz twoja_baza własnymi danymi.

  1. Zezwalanie na połączenia zdalne
  • Edytuj plik postgresql.conf:
  • Windows: Zazwyczaj w lokalizacji C:\Program Files\PostgreSQL\<version>\data\postgresql.conf. Ustaw listen_addresses = '*'.
  • Linux (Debian): Zazwyczaj w lokalizacji /etc/postgresql/<version>/main/postgresql.conf. Ustaw listen_addresses = '*'.
  • Edytuj plik pg_hba.conf:
  • Windows: Zazwyczaj w lokalizacji C:\Program Files\PostgreSQL\<version>\data\pg_hba.conf.
    Dodaj linię:     host twoja_baza twoj_uzytkownik <dozwolone_ip>/<cidr> scram-sha-256
  • Linux (Debian): W lokalizacji /etc/postgresql/<version>/main/pg_hba.conf.
    Dodaj linię:     host <nazwa_bazy> <nazwa_uzytkownika> <dozwolone_ip>/<cidr> scram-sha-256

Zastąp <dozwolone_ip>/<cidr>, aby ograniczyć dostęp, jeśli to konieczne (np. 0.0.0.0/0 dla dowolnego adresu IP).

  1. Zrestartuj usługę PostgreSQL:
  • Windows: net stop postgresql-x64-<version> a następnie net start postgresql-x64-<version> (jako administrator).
  • Linux (Debian): sudo systemctl restart postgresql
  1. Nadawanie uprawnień do bazy danych
  • Windows i Linux: Otwórz psql (Windows) lub sudo -u postgres psql (Linux) i uruchom polecenie SQL :
    GRANT ALL PRIVILEGES ON DATABASE twoja_baza TO twoj_uzytkownik;

Użyj nazw bazy danych i użytkownika, które skonfigurowałeś wcześniej.

Alternatywa: Szybka konfiguracja za pomocą skryptu

Uwaga: Powyższe skrypty mogą nie być aktywnie utrzymywane, a ich użycie odbywa się na własną odpowiedzialność. Zachowaj ostrożność podczas uruchamiania skryptów z uprawnieniami administracyjnymi.

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

  1. W systemie 3CX przejdź do Konsola administracyjna > „Integrations” (Integracje) > „Data Connector”.
  2. Wybierz „PostgreSQL Database” i wprowadź następujące dane:
  • Host: Adres IP lub nazwa FQDN hosta, na którym zainstalowano PostgreSQL.
  • SSL Validation: Określ, czy centrala PBX powinna weryfikować zdalny certyfikat SSL.
  • CA Certificate: Widoczne tylko po wybraniu walidacji SSL. Prześlij certyfikat CA.
  • Port: Port bazy danych (domyślnie: 5432).
  • Database Name: Nazwa bazy danych utworzonej w Kroku 1.
  • Username: Nazwa użytkownika skonfigurowana w PostgreSQL.
  • Password: Hasło użytkownika.
  • Data Types: Wybierz, jakie dane chcesz przesyłać.
  • Frequency: Ustaw częstotliwość przesyłania danych z centrali PBX do PostgreSQL.
  1. Zapisz konfigurację i kliknij przycisk „Test” w swojej centrali, aby zweryfikować połączenie i potwierdzić otrzymanie komunikatu o sukcesie. Jeśli test się nie powiedzie, sprawdź ponownie hosta, port, nazwę bazy, użytkownika i hasło. Upewnij się także, że wszelkie zapory sieciowe na hoście PostgreSQL zezwalają na połączenia z adresu IP Twojej centrali PBX.

Uwaga: Aby korzystać z 3CX Data Connector, wymagana jest licencja 16SC lub wyższa.

Krok 3: Połączenie Grafana z instancją PostgreSQL

  1. Zaloguj się do swojej instancji Grafana (np. Grafana.com lub własny hosting).
  2. Przejdź do menu konfiguracji Grafana (ikona koła zębatego), kliknij „Data Sources” (Źródła danych), a następnie „Add data source” (Dodaj źródło danych).
  3. Wyszukaj i wybierz „PostgreSQL”.

  1. Skonfiguruj źródło danych w sekcji „Connection” (Połączenie), wprowadzając następujące szczegóły:
  • Host: Wprowadź IP lub FQDN oraz port PostgreSQL w formacie: IP/FQDN:5432
  • Database: Nazwa bazy danych utworzonej w Kroku 1.
  • User: Nazwa użytkownika utworzona w Kroku 1.
  • Password: Hasło skonfigurowane dla tego użytkownika.

  1. Kliknij „Save & test” i sprawdź, czy otrzymałeś komunikat „Data source is working” (Źródło danych działa poprawnie). Jeśli wystąpią błędy, sprawdź ponownie dane połączenia i konfigurację SSL. Upewnij się także, że wszelkie zapory sieciowe zezwalają na połączenia z adresów IP Grafana.

Zobacz również


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