3CX, Microsoft SQL Veritabanı ve Grafana Bağlantısı

Giriş

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

Ön Koşullar

  • Çalışan bir Microsoft SQL Server. Şirket içi veya Azure üzerinde
  • Microsoft SQL Server yönetici erişimi
  • 3CX Yönetici Konsoluna Erişim
  • 3CX 16SC+ lisansı (Data Connectors işlevselliği için gereklidir)

Adım 1: Azure veya Şirket İçinde SQL Veritabanınızı Oluşturun

Azure SQL Veritabanı Oluşturma

  1. Azure Portalınıza buradan Giriş Yapın https://portal.azure.com/
  2. SQL Sunucuları arayın ve gidin,Oluştur’a tıklayın
  3. Yeni bir kaynak grubu seçin veya oluşturun
  4. Benzersiz bir Sunucu Adı belirleyin ve santralinize yakın bir konum seçin
  5. SQL Kimlik Doğrulamasını Kullan seçeneğini seçin ve yönetici oturum açma bilgilerinizi ve güçlü bir parola belirleyin
  6. Bu kimlik bilgilerini not edin, çünkü daha sonra 3CX Yönetici Konsolunda Data Connectors için bunlara ihtiyacınız olacak
  7. İncele + Oluştur ve ardından Oluştur’a tıklayın

  1. SQL Sunucularına gidin, az önce oluşturduğunuz yukarıdaki sunucuyu açın ve Sunucu Adını not edin; çünkü daha sonra 3CX Yönetici Konsolunda Data Connectors yapılandırması için buna ihtiyacınız olacak.
  2. Veritabanı Oluştur’a tıklayın.

  1. Benzersiz bir veritabanı adı belirleyin
  2. Hesaplama ve Depolama Bölümlerinde veritabanının özelliklerini ve boyutunu gerektiği gibi seçin
  3. İncele + Oluştur ve ardından Oluştur’a tıklayın

  1. Veritabanı oluşturulduktan sonra, SQL Veritabanlarına gidin ve az önce oluşturduğunuz yukarıdaki veritabanını açın.
  2. Sunucu Güvenlik Duvarını Ayarla’ya tıklayın.

  1. Genel ağ erişimini “Seçili Ağlar" olarak değiştirin ve “Bir güvenlik duvarı kuralı ekle”ye tıklayın.
  2. Bu veritabanına erişecek olan santralinizin Genel IP adresini ekleyin ve Kaydet butonuna tıklayın.

Şirket İçi SQL Veritabanı Oluşturma

  1. Şirket içi Microsoft SQL Server'ı indirin ve yükleyiciyi buradan çalıştırın: https://www.microsoft.com/en-us/sql-server/sql-server-downloads
  2. Kurulum başarılı olduktan sonra, SQL Server Management Studio programını indirip yükleyin.
  3. SQL Server Management Studio (SSMS) yüklemek ve başlatmak için sihirbazı izleyin.

  1. Varsayılan olarak, Microsoft SQL Server hiçbir portu dinlemiyor veya dinamik portları dinliyor olabilir. Belirli bir portu (örneğin, varsayılan 1433) kullanmak için Windows Başlat Menüsüne gidin, SQLServerManager16.msc ifadesini arayın ve açın.
  2. Sol panelde SQL Server Network Configuration → SQLEXPRESS protokollerine gidin
  3. TCP/IP’ye sağ tıklayın ve Etinleştir’e tıklayın
  4. SQLEXPRESS Protocols bölümündeyseniz
    TCP/IP’ye çift tıklayın ve IP Addresses sekmesine gidin
  5. Aşağı kaydırın ve IPAll bölümünü arayın
  6. TCP Port = 1433 ayarlayın ve TCP Dynamic Ports alanını boş bırakın ve OK tıklayın
  7. SQL Server Configuration Manager bölümüne geri dönün. Sol panelde SQL Server Services bölümüne gidin
  8. Örneğinize (örn.MSSQLSERVER) sağ tıklayın Restart düğmesine tıklayın

  1. Yukarıda yüklediğiniz SQL Server Management Studio'yu açın
  2. Aşağıda gösterildiği gibi, Windows Kimlik Doğrulaması kullanarak yeni SQL Server'a yönetici olarak localhost üzerinden bağlanabilirsiniz

  1. SSMS'ye bağlandıktan sonra Veritabanları > Yeni Veritabanı’na sağ tıklayın
  2. Veritabanına benzersiz bir ad verin ve TAMAM düğmesine tıklayın

  1. Santralin veritabanına bağlanabilmesi için SQL Server Kimlik Doğrulamasını etkinleştirmek üzere sol paneldeki SQL Server'ınıza sağ tıklayın ve Özellikler bölümüne gidin
  2. Güvenlik bölümüne gidin, “SQL Server ve Windows Kimlik Doğrulama modu” seçeneğini belirleyin ve TAMAM düğmesine tıklayın
  3. Bir kez daha SQL Server'ınızı yukarıda gösterildiği gibi SQL Server Yöneticisi'nden veya görev yöneticisi aracılığıyla yeniden başlatın

  1. Santral için bu Veritabanına bağlanması için bir kullanıcı oluşturmak üzere, Oturum Açma Bilgileri > Yeni Oturum Açma’ya sağ tıklayın
  2. Oturum Açma Adı’nda kullanıcı adınızı girin
  3. SQL Kimlik Doğrulaması seçin ve güçlü bir parola belirleyin
  4. Karmaşıklık kurallarını istemiyorsanız Parola ilkesini uygula seçeneğinin işaretini kaldırın
  5. Varsayılan veritabanı: Yukarıda oluşturduğunuz yeni veritabanını seçin (örneğin cdr_db)

  1. Aynı "Login" penceresindeyken soldaki User Mapping’e tıklayın
  2. Yeni veritabanınızı seçin (örneğin cdr_db)
  3. "Database role membership" bölümünde, aşağıdaki seçenekleri işaretleyin:

db_datareader, db_datawriter, db_ddladmin

  1. OK düğmesine tıklayın

Adım 2: 3CX Data Connectors Yapılandırma

  1. 3CX Yönetici Konsolu > Entegrasyonlar > Data Connectors bölümüne gidin
  2. "Microsoft SQL Server" seçin ve aşağıdakileri girin:
  • Host: Microsoft SQL Server yüklediğiniz Ana Bilgisayarın IP Adresi veya FQDN adı (varsa). Veya Azure tarafından verilen Sunucu Adı
  • Port: Veritabanı portu (varsayılan: 1433).
  • 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: Santralden Azure SQL Veritabanına veri aktarım sıklığını ayarlayın.
  1. Yapılandırmayı kaydedin ve Microsoft SQL veritabanına bağlantıyı doğrulamak ve bir başarı mesajı aldığınızı onaylamak için santralinizde "Test" düğmesine tıklayın. Test başarısız olursa, ana bilgisayarı, portu, veritabanı adını, kullanıcı adını ve parolayı tekrar kontrol edin. Ayrıca, tüm güvenlik duvarlarının santralinizden bağlantılara izin verip vermediğini doğrulayın.

Adım 3: Grafana’yı Microsoft SQL Veritabanına Bağlama

  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ı" ve ardından "Veri kaynağı ekle" düğmesine tıklayın.
  3. "Microsoft SQL Server" ifadesini arayın ve seçin.

  1. "Bağlantı" altında veri kaynağını yapılandırın, aşağıdaki bilgileri girin:
  • Host: Microsoft SQL Server IP veya FQDN adı ve portu şu biçimde girin: IP/FQDN:1433
  • 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
  • Authentication Type: SQL Server Kimlik Doğrulaması

  1. "Save & Test"e tıklayın ve "Database Connection OK" 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ı tekrar kontrol edin. Ayrıca, Microsoft SQL ana bilgisayarı 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/microsoft-sql-server-yapilandirma/