3CX'i Bağımsız MySQL ve Grafana'ya Bağlama

Giriş

Bu kılavuz, V20 Update 7 çalıştıran sistemler içindir ve 3CX telefon sisteminizi, veri görselleştirme ve raporlama için Grafana ile birlikte kullanılmak üzere bağımsız bir MySQL veritabanına bağlamak için özlü bir süreç sağlar.

Önkoşullar

  • Çalışan bir MySQL sunucusu.
  • MySQL sunucunuza yönetici erişimi.
  • 3CX Yönetici Konsoluna erişim.
  • 3CX 16SC+ lisansı (Data Connectors işlevi için gereklidir).
  • MySQL yönetimi ve SQL hakkında temel bilgi.

Adım 1: MySQL'inizi Hazırlayın

  1. MySQL Veritabanınızı Yapılandırın

MySQL Veritabanınızı kurduktan sonra, yapılandırmada aşağıdaki değişiklikleri yapın:

MySQL yapılandırmasında local_infile parametresini etkinleştirin. 3CX'in toplu veri aktarımını verimli bir şekilde yapabilmesi için çok önemli olan local_infile Genel Parametresini etkinleştirdiğinizden emin olun. Bunu yapmak için MySQL yapılandırma dosyanızı düzenleyin ve [mysqld] bölümüne local_infile parametresini ekleyin veya değiştirin:

[mysqld]

local_infile=1

  1. Veritabanına Uzak Bağlantılara İzin Verin

MySQL varsayılan olarak localhost bağlantılarına izin verir. PBX'in veritabanına bağlanabilmesi için uzak bağlantılara izin vermeniz gerekir. Bunu yapmak için MySQL yapılandırma dosyanızı düzenleyin ve bind-address parametresini ekleyin veya değiştirin:

bind-address = 0.0.0.0

MySQL yapılandırma dosyasının konumu işletim sistemine göre değişir:

  • Linux: Yaygın konumlar arasında /etc/mysql/my.cnf, /etc/my.cnf veya /etc/mysql/mysql.conf.d/mysqld.cnf bulunur.
  • Windows: Genellikle C:\ProgramData\MySQL\MySQL Server X.Y\my.ini'de.

  1. Yukarıdaki Değişiklikleri Uygulamak İçin MySQL Veritabanınızı Yeniden Başlatın

Düzenlemeden sonra değişikliklerin etkili olması için MySQL servisini yeniden başlatın:

  • Linux: sudo systemctl restart mysql
  • Windows: MySQL servisini Servis Yöneticisi'nden yeniden başlatın.

  1. Özel bir MySQL Kullanıcısı ve Veritabanı Oluşturun

MySQL'e root veya yönetici kullanıcısı olarak giriş yapın:

mysql -u root -p

İstenirse root parolanızı girin.

Veritabanını Oluşturun

CDR veritabanınız için açıklayıcı bir ad seçin (örneğin, 3cx_cdr_db).


CREATE DATABASE 3cx_cdr_db;


Kullanıcıyı Oluştur

Yeni kullanıcınız için güçlü bir parola seçin CREATE USER 'cdrdb'@'%' IDENTIFIED BY '4zYThcp#KWB2aRmI2t5!P';

CREATE USER 'our_3cx_user'@'host' IDENTIFIED BY 'your_3cx_user_password';

“your_3cx_user” Ve “your_user_password” ifadelerini istediğiniz kimlik bilgileriyle değiştirin.

Veritabanına yalnızca PBX üzerinden bağlantılara izin vermek istiyorsanız 'host' ifadesini 3CX Sunucu IP adresiyle, her yerden erişime izin vermek istiyorsanız 'host' ifadesini ‘%’ ile değiştirin.

Örnekler:

CREATE USER 'dbuser'@'192.168.10.1' IDENTIFIED BY 'myPass'; – to allow access only an IP

CREATE USER 'dbuser'@'192.168.10.1' IDENTIFIED BY 'myPass'; – to allow access from any IP

İzin Verin

Son olarak, kullanıcının veritabanına uygun izinlerini ayarlamak için aşağıdaki komutları çalıştırın;

GRANT INSERT, SELECT, CREATE, ALTER, DROP, INDEX, LOCK TABLES ON 3cx_cdr_db.* TO 'your_3cx_user'@'host';

FLUSH PRIVILEGES;

Burada da 3cx_cdr_db, ‘your_3cx_user’ ve ‘host’ değerlerini yukarıda verilen değerlere göre değiştirin

  1. Güvenlik Duvarını Yapılandırın (Varsa)

MySQL sunucunuzun güvenlik duvarının, 3CX Telefon Sisteminizin IP adresinden MySQL portuna (varsayılan: 3306) gelen bağlantılara izin verdiğinden emin olun.

  • Linux(örneğin, ufw):
    sudo ufw allow from <3CX_PBX_IP_Address> to any port 3306
    sudo ufw reload
  • Windows Güvenlik Duvarı: 3CX PBX'inizin IP adresinden 3306 numaralı porttan TCP bağlantılarına izin vermek için bir gelen kuralı oluşturun.

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

  1. 3CX'te Yönetici Konsolu > Entegrasyonlar > Data Connectors bölümüne gidin
  2. "MySQL" seçin ve aşağıdakileri girin:
  • Host: MySQL'i kurduğunuz ana bilgisayarın IP Adresi veya FQDN adı (varsa).
  • Port: Veritabanı portu (varsayılan: 3306).
  • 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 MySQL'e veri aktarım sıklığını ayarlayın.
  1. Yapılandırmayı kaydedin ve MySQL veritabanına bağlantıyı doğrulamak için bir başarı mesajı aldığınızı onaylamak için PBX’inizdeki "Test" düğmesine basın. Test başarısız olursa, ana bilgisayarı, portu, veritabanı adını, kullanıcı adını ve parolayı tekrar kontrol edin. Ayrıca, MySQL ana bilgisayarındaki veya ağındaki tüm güvenlik duvarlarının PBX IP adresinizden bağlantılara izin verdiğini doğrulayın.

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

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

  1. "Bağlantı" altında veri kaynağını yapılandırın, aşağıdaki bilgileri girin:
  • Host: Mysql Veritabanınızın IP veya FQDN adı ve portunu şu biçimde girin: IP/FQDN:3306
  • Database Name: 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. "Save & Test"e tıklayın ve "Data Connection OK" mesajı aldığınızı doğrulayın. Hatalarla karşılaşırsanız, bağlantı ayrıntılarını ve SSL yapılandırmasını tekrar kontrol edin. Ayrıca, MySQL ana bilgisayarındaki veya ağındaki tüm güvenlik duvarlarının Grafana IP adreslerinden gelen bağlantılara izin verdiğini doğrulayın.

Son Güncelleme
Bu belge en son 24 Temmuz 2025 tarihinde güncellenmiştir.
https://www.3cx.com.tr/docs/mysql-yapilandirma/