Collegare 3CX a Google BigQuery e Grafana

Introduzione

Questa guida illustra i passaggi per collegare 3CX a un database Google BigQuery e utilizzare Grafana per visualizzare i dati con funzionalità di dashboard e reporting.

Passo 1: Configurare Google Workspace per abilitare Google BigQuery

  1. Andare alla console amministrativa 3CX > Integrazioni > Google e selezionare “Configura”.

  1. Apparirà la seguente schermata, dove sarà necessario abilitare “Integrazione con Google BigQuery per l'esportazione dei dati” e connettersi. Verrà chiesto di inserire le tue credenziali di accesso a Google e una volta fatto, segui le istruzioni per tornare indietro che ti riporteranno alla configurazione del 3CX Google Workspace.

Passo 2: Configurare il Data Connector su 3CX

  1. Dal 3CX, navigare in Admin Console > Integrazioni > Connettore dati
  2. Selezionare “Google BigQuery”.
  3. Scegliere quale tipo di data trasferire
  4. Impostare la frequenza di trasferimento dei dati dal PBX a Google BigQuery.
  5. Salvare la configurazione e cliccare sul pulsante “Test” sul centralino per verificare la connessione al database di Google Big Query e confermare la ricezione di un messaggio di successo. Se il test fallisce, esaminare il messaggio di errore lanciato e accedere alla console di Google BigQuery per assicurarsi che l'istanza sia stata creata correttamente e che non vi siano messaggi di errore da parte di Google.

Nota bene: è necessario avere una licenza 16SC+ per usare 3CX

Passo 3: Abilitare le API di Google per Grafana

  1. Le seguenti API di Google devono essere abilitate affinché il plugin funzioni:

  1. Nella Google Console, navigare in API & Servizi > Credenziali, cliccare su "Crea Credenziali" e selezionare “Account di servizio”.

  1. Assegnare un nome univoco all'account di servizio e cliccare su Crea e continua.

  1. Aggiungere i ruoli BigQuery Data Viewer e BigQuery Job User e cliccare su Fine.

  1. In Credenziali, sotto Account di servizio, cliccare sull'account di servizio Grafana appena creato.

  1. Passare alla scheda Chiavi e cliccare su Aggiungi chiave, selezionare il tipo di chiave JSON e cliccare su Crea. La chiave verrà creata e salvata sul PC, che verrà poi utilizzata in Grafana per autenticarsi a Google BigQuery.

Passo 4: Collegare Grafana a Google BigQuery

  1. Dalla console di Grafana, andare su Amministrazione > Plugin, cercare e cliccare sul plugin Google BigQuery.

  1. Cliccare su Installa il plugin.

  1. Creare un data source BigQuery e autenticarsi  
  • Accedere alla propria istanza di Grafana (ad esempio, Grafana.com o Grafana self-hosted).
  • Accedere al menu di configurazione di Grafana (icona dell'ingranaggio), cliccare su "Data Sources" e su "Add data source".
  • Cercare e selezionare “Google BigQuery”.

  1. Nella configurazione di Google BigQuery, alla voce Autenticazione selezionare Google JWT FIle in Tipo di autenticazione, cliccare su Carica token JWT e selezionare la chiave dell'account di servizio Google scaricata al punto precedente.

  1. Cliccare su “Salva e prova” e verificare che venga visualizzato il messaggio “L'origine dati funziona”.

Per saperne di più

Ultimo aggiornamento

Questo documento è stato aggiornato il 4 giugno 2026

https://www.3cx.it/doc/configurazione-google-bigquery/