3CX'i Bağımsız Bir PostgreSQL ve Grafana’ya Bağlama

Giriş

Bu kılavuz, veri görselleştirme ve raporlama için Grafana ile birlikte kullanılmak üzere 3CX telefon sisteminizi bağımsız bir PostgreSQL veritabanına bağlamak için kısa bir süreç sağlar.

Adım 1: Bir PostgreSQL Oluşturun

  1. PostgreSQL'i yükleyin
  • Windows: Yükleyiciyi https://www.postgresql.org/download/windows/ adresinden indirin ve sihirbazı takip edin.
  • Linux (Debian): sudo apt update && sudo apt install -y postgresql Kümeyi Doğrulayın: pg_lsclusters. Gerekirse oluşturun: sudo pg_createcluster <major-version> main --start.
    postgres süper kullanıcı parolasını ve kurulum detaylarını hatırlayın (varsayılan port 5432).
  1. PostgreSQL Kullanıcısı ve Veritabanı Oluştur
  • Windows: psql açın.
  • Daha sonra SQL'i çalıştırın:
            CREATE ROLE     your_user WITH LOGIN PASSWORD
    'your_password';
            CREATE DATABASE your_db OWNER your_user;
  • Linux (Debian):

sudo -u postgres createuser <username> -P
        sudo -u postgres createdb <dbname> -O <username>

Gerektiğinde your_user/username, your_password, ve your_db/dbname değiştirin.

  1. Uzaktan Bağlantılara İzin Ver
  • postgresql.conf dosyasını düzenleyin:
  • Windows: Genellikle C:\Program Files\PostgreSQL\<version>\data\postgresql.conf. Set listen_addresses = '*'.
  • Linux (Debian): Genellikle /etc/postgresql/<version>/main/postgresql.conf. Set listen_addresses = '*'.
  • pg_hba.conf dosyasını düzenleyin:
  • Windows: Genellikle C:\Program Files\PostgreSQL\<version>\data\pg_hba.conf.
    Add:     host    your_db         your_user        <allowed_ip>/<cidr>         scram-sha-256
  • Linux (Debian): /etc/postgresql/<version>/main/pg_hba.conf.
    Add:     host    <dbname>        <username>       <allowed_ip>/<cidr>         scram-sha-256

Gerektiğinde erişimi kısıtlamak için <allowed_ip>/<cidr> ifadesini değiştirin (örneğin, herhangi bir ip için 0.0.0.0/0).

  1. PostgreSQL Servisini Yeniden Başlatın:
  • Windows: net stop postgresql-x64-<version> then net start postgresql-x64-<version> (yönetici olarak).
  • Linux (Debian): sudo systemctl restart postgresql
  1. Veritabanı Ayrıcalıklarını Ver
  • Windows ve Linux: psql’i (Windows) veya sudo -u postgres psql’i (Linux) açın ve SQL'i çalıştırın:
    your_db VERİTABANINDAKİ TÜM AYRICALIKLARI your_user’a VER    ;

Yapılandırdığınız veritabanını ve kullanıcı adlarını kullanın.

Alternatif olarak: Komut dosyası aracılığıyla Hızlı Yapılandırma

Lütfen bu scriptlerin aktif olarak sürdürülmeyeceğini ve kullanımının sizin sorumluluğunuzda olduğunu unutmayın. Scriptleri yönetici ayrıcalıklarıyla çalıştırırken dikkatli olun.

Adım 2: 3CX'te Data Connectors Yapılandırın

  1. 3CX'te Yönetici Konsolu > Entegrasyonlar > Data Connectors
  2. "PostgreSQL Veritabanı" seçin ve aşağıdakileri girin:
  • Host: PostgreSQL'i kurduğunuz Host’un IP Adresi veya FQDN'si (varsa).
  • Port: Veritabanı portu (varsayılan: 5432).
  • Database Name: 1. Adımda oluşturduğunuz veritabanının adı.
  • Username: 1. Adımda oluşturduğunuz yeni kullanıcının kullanıcı adı.
  • Password: Yeni kullanıcınız için yapılandırdığınız parola
  • Frequency: PBX'ten PostgreSQL'e veri aktarımının sıklığını ayarlayın.
  1. Yapılandırmayı kaydedin ve PostgreSQL veritabanına bağlantıyı doğrulamak ve bir başarı mesajı aldığınızı onaylamak için PBX’inizdeki “Test” düğmesine tıklayın. Test başarısız olursa, host’u, portu, veritabanı adını, kullanıcı adını ve parolayı iki kez kontrol edin. Ayrıca, PostgreSQL hostu veya ağındaki tüm güvenlik duvarlarının PBX IP'nizden bağlantılara izin verdiğini doğrulayın.

Click TEST button to verify the connection on your PBX

Lütfen dikkat: 3CX Data Connector'u kullanmak için 16SC+ lisansınız olması gerekir.

Adım 3: Grafana'yı PostgreSQL Örneğine Bağlayın

  1. Grafana örneğinize giriş yapın (örneğin grafana.com veya kendi barındırdığınız Grafana).
  2. Grafana yapılandırma menüsüne gidin (dişli simgesi) ve "Veri Kaynakları"na ve "Veri kaynağı ekle"ye tıklayın.
  3. "PostgreSQL"i arayın ve seçin.

  1. "Bağlantı" altında veri kaynağını yapılandırın, aşağıdaki bilgileri girin:
  • Host: PostgreSQL'inizin IP veya FQDN'sini ve portunu şu biçimde girin: IP/FQDN:5432
  • Database: 1. Adımda oluşturduğunuz veritabanının adı.
  • User: 1. Adımda oluşturduğunuz yeni kullanıcının kullanıcı adı
  • Password: Yeni kullanıcınız için yapılandırdığınız parola

  1. "Kaydet ve test et"e tıklayın ve "Veri kaynağı çalışıyor" mesajını aldığınızı doğrulayın. Hatalarla karşılaşırsanız, bağlantı ayrıntılarını ve SSL yapılandırmasını iki kez kontrol edin. Ayrıca, PostgreSQL ana makinesindeki veya ağındaki tüm güvenlik duvarlarının Grafana IP'lerinden gelen bağlantılara izin verdiğini doğrulayın.

Ayrıca Bakınız

Son Güncelleme

Bu belge son olarak 15 Mayıs 2025'te güncellendi

https://www.3cx.com/docs/postgresql-configuration/