Collegare 3CX a un database Microsoft SQL e Grafana

Introduzione

Questa guida è destinata ai sistemi che eseguono V20 Update 7 e fornisce una procedura concisa per collegare il sistema telefonico 3CX a un database Microsoft SQL da utilizzare con Grafana per la visualizzazione dei dati e la creazione di report.

Prerequisiti

  • Un server Microsoft SQL in esecuzione. On Premise o su Azure.
  • Accesso amministrativo al server Microsoft SQL.
  • Accesso alla console di amministrazione 3CX.
  • Una licenza 3CX 16SC+ (richiesta per la funzionalità Data Connector)

Passo 1: Creare il database SQL su Azure o on-Premise

Creazione di un database SQL su Azure

  1. Accedere al portale Azure all'indirizzo https://portal.azure.com/
  2. Cercare e selezionare SQL Server, quindi cliccare su Crea
  3. Selezionare o creare un nuovo gruppo di risorse
  4. Impostare un nome server univoco e selezionare una posizione vicina al proprio PBX
  5. Selezionare Usa autenticazione SQL e imposta il tuo login amministratore e una password complessa
  6. Annotare queste credenziali perché ti serviranno in seguito per configurare il tuo Data Connector nella console di amministrazione 3CX.
  7. Cliccare su Rivedi + Crea e poi su Crea

  1. Andare su Server SQL, apri il server che hai appena creato e annota il nome del server perché ti servirà in seguito per configurare il tuo Data Connector nella console di amministrazione 3CX.
  2. Cliccare su Crea database

  1. Impostare un nome univoco per il database
  2. Selezionare le specifiche e le dimensioni del database in base alle tue esigenze nelle sezioni Compute e Storage
  3. Cliccare su Rivedi + Crea e poi su Crea

  1. Una volta creato il database, andare su Database SQL e aprire il database appena creato
  2. Cliccare su Imposta firewall server

  1. Impostare l'accesso alla rete pubblica su “Reti selezionate” e cliccare su “Aggiungi una regola firewall”
  2. Aggiungere l'indirizzo IP pubblico del tuo PBX che accederà a questo database e cliccare su Salva.

Creazione di un database SQL locale

  1. Scaricare Microsoft SQL Server locale ed eseguire il programma di installazione da qui: https://www.microsoft.com/en-us/sql-server/sql-server-downloads
  2. Una volta completata l'installazione, procedere al download e all'installazione di SQL Server Management Studio
  3. Seguire la procedura guidata per installare e avviare SQL Server Management Studio (SSMS)

  1. Per impostazione predefinita, Microsoft SQL Server potrebbe non ascoltare alcuna porta o ascoltare su porte dinamiche. Per utilizzare una porta specifica (ad esempio, 1433 predefinita), andare al menu Start di Windows, cercare e aprire SQLServerManager16.msc
  2. Nel pannello di sinistra, andare su Configurazione di rete di SQL Server → Protocolli per SQLEXPRESS
  3. Cliccare con il pulsante destro del mouse su TCP/IP e fare clic su Abilita
  4. Sempre in Protocolli per SQLEXPRESS:

Fare doppio clic su TCP/IP e andare alla scheda Indirizzi IP

  1. Scorrere fino in fondo e cercare la sezione IPAll
  2. Impostare Porta TCP = 1433 e lasciare vuoto il campo Porte dinamiche TCP, quindi fare clic su OK
  3. Tornare in SQL Server Configuration Manager Nel pannello di sinistra, vai su Servizi SQL Server
  4. Cliccare con il pulsante destro del mouse sulla tua istanza (ad es. MSSQLSERVER) e fai clic su Riavvia

  1. Aprire SQL Server Management Studio che hai installato sopra
  2. Puoi connetterti su localhost come amministratore al nuovo SQL Server utilizzando l'autenticazione Windows come mostrato di seguito

  1. Una volta connesso a SSMS, cliccare con il pulsante destro del mouse su Database > Nuovo database
  2. Assegnare un nome univoco al database e fai clic su OK

  1. Per abilitare l'autenticazione SQL Server affinché il PBX possa connettersi al database, cliccare con il pulsante destro del mouse sul tuo SQL Server nel pannello di sinistra e fai clic su Proprietà
  2. Andare su Sicurezza, selezionare l'opzione “Modalità di autenticazione SQL Server e Windows” e fai clic su OK
  3. Riavviare nuovamente SQL Server da SQL Server Manager come mostrato sopra o tramite Task Manager

  1. Per creare un utente per il PBX per connettersi a questo database, fare clic con il pulsante destro del mouse su Login > Nuovo accesso
  2. Impostare il nome utente in Nome loin
  3. Selezionare Autenticazione SQL e impostare una password complessa
  4. Deselezionare Applica criteri password se non si desiderano regole di complessità
  5. Database predefinito: selezionare il nuovo database creato sopra (ad es. cdr_db)

  1. Sempre nella stessa finestra “Login” Cliccare su Mappatura utenti a sinistra
  2. Selezionare il nuovo database (ad es. cdr_db)
  3. In “Appartenenza al ruolo del database”, selezionare le opzioni per

db_datareader, db_datawriter, db_ddladmin

  1. Cliccare OK

Passo 2: Configurare il connettore dati su 3CX

  1. Accedere alla console di amministrazione 3CX > Integrazioni > Connettore dati.
  2. Selezionare “Microsoft SQL Server” e inserire quanto segue:
  • Host: L'indirizzo IP o FQDN (se disponibile) dell'host su cui è stato installato Microsoft SQL Server. Oppure il nome del server fornito da Azure.
  • Porta: La porta del database (impostazione predefinita: 1433).
  • Nome database: Il nome del database creato nel passaggio 1.
  • Nome utente: Il nome utente del nuovo utente creato nel passaggio 1.
  • Password: La password configurata per il nuovo utente
  • Tipi di dati: Scegli quali dati desideri trasferire.
  • Frequenza: Impostare la frequenza di trasferimento dei dati dal PBX al database SQL di Azure.
  1. Salvare la configurazione e cliccare sul pulsante “Test” sul tuo PBX per verificare la connessione al database Microsoft SQL e confermare che ricevi un messaggio di successo. Se il test fallisce, ricontrolla l'host, la porta, il nome del database, il nome utente e la password. Inoltre, verifica che eventuali firewall consentano le connessioni dall'IP del tuo centralino telefonico.

Passo 3: Connetti Grafana al database Microsoft SQL

  1. Accedere alla tua istanza Grafana (ad esempio, grafana.com o il tuo Grafana self-hosted).
  2. Andare al menu di configurazione di Grafana (icona a forma di ingranaggio), fai clic su “Origini dati” e poi su “Aggiungi origine dati”.
  3. Cercare e selezionare “Microsoft SQL Server”

  1. Configurare l'origine dati in “Connessione” e inserisci i seguenti dettagli:
  • Host: Inserisci l'IP o l'FQDN e la porta del tuo Microsoft SQL Server nel formato: IP/FQDN:1433
  • Database: Il nome del database che hai creato al passo 1.
  • Utente: Il nome utente del nuovo utente creato al passo 1.
  • Password: La password configurata per il nuovo utente.
  • Tipo di autenticazione: Autenticazione SQL Server.

  1. Cliccare su “Salva e verifica” e verificare che venga visualizzato il messaggio “Connessione al database OK”. Se si verificano errori, ricontrollare i dettagli della connessione e la configurazione SSL. Verificare inoltre che eventuali firewall sull'host o sulla rete Microsoft SQL consentano le connessioni dagli IP Grafana.

Ultimo aggiornamento
Questo documento è stato aggiornato il 12 giugno 2026.
https://www.3cx.it/doc/server-microsoft-sql/