Conectando o 3CX ao Google BigQuery e ao Grafana

Introdução

Este guia descreve as etapas para conectar o 3CX a um banco de dados do Google BigQuery e usar o Grafana para visualizar seus dados com recursos de painéis e relatórios.

Etapa 1: Configurar o Google Workspace para Habilitar o Google BigQuery

1. Navegue até o Console do Admin 3CX > Integrações > Google e selecione “Configurar”

2. A tela a seguir será exibida, onde você precisará ativar “Integrar com o Google BigQuery para Exportação de Dados” e se conectar. Você será solicitado a inserir suas credenciais de login do Google e, quando estiver pronto, siga as instruções para voltar, o que o levará de volta à configuração do 3CX Google Workspace.

Etapa 2: Configurar o Conector de Dados no 3CX

1. No 3CX, navegue até o Console do Admin > Integrações > Conector de Dados
2. Selecione "Google BigQuery"
3. Defina a frequência da transferência de dados do PABX para o Google BigQuery
4. Salve a configuração e clique no botão “Testar” em seu PABX para verificar a conexão com o banco de dados do Google Big Query e confirmar o recebimento de uma mensagem de sucesso. Se o teste falhar, revise a mensagem de erro lançada e faça login no console do Google Big Query para garantir que a instância foi criada corretamente e que não há mensagens de erro no lado do Google.

Etapa 3: Habilitar as APIs do Google para o Grafana

1. As seguintes APIs do Google precisam ser ativadas para que o plug-in funcione:

• BigQuery API
• Cloud Resource Manager API

2. No Console do Google, navegue até API & Services > Credentials, clique em Create Credentials e selecione Service Account.

3. Dê um nome exclusivo para sua conta de serviço e clique em Create e Continue.

4. Adicione as funções BigQuery Data Viewer e BigQuery Job User e clique em Done (Concluído).

5. De volta às Credenciais, em Contas de Serviço, clique na conta de serviço Grafana recém-criada.

6. Navegue até a Guia Keys (Chaves) e clique em Add Key (Adicionar Chave), selecione o tipo de chave JSON e clique em create (Criar). A chave será criada e salva em seu computador, que será usada posteriormente no Grafana para autenticação no Google BigQuery.

Etapa 4: Conectar o Grafana ao Google BigQuery

1. No console do Grafana, navegue até Administração > Plug-ins, procure e clique no Plug-in do Google BigQuery.

2. Clique para instalar o plug-in.

3. Crie uma fonte de dados do BigQuery e autentique

• Faça login na sua instância do Grafana (por exemplo, Grafana.com ou seu Grafana auto-hospedado).
• Acesse o menu de configuração do Grafana (ícone de engrenagem), clique em “Data Sources” (Fontes de Dados) e clique em “Add data source” (Adicionar fonte de dados).
• Pesquise e selecione "Google BigQuery".

4. Em Google BigQuery Configuration, em Authentication, selecione Google JWT FIle em Authentication type, clique em Upload JWT token e selecione a chave da conta de serviço do Google que você baixou na etapa anterior.

5. Clique em "Save & test" e verifique se você recebe uma mensagem "Data source is working" (A fonte de dados está funcionando).

Veja Também

• Conexão do 3CX ao AWS RDS PostgreSQL & Grafana

Última Atualização

Este documento foi atualizado pela última vez em 17 de abril de 2025

https://www.3cx.com.br/docs/configuracao-google-bigquery/