Conexão do 3CX a um Banco de Dados Microsoft SQL e Grafana

Introdução

Este guia é para sistemas que executam o V20 Update 7 e fornece um processo conciso para conectar seu sistema telefônico 3CX a um banco de dados Microsoft SQL para uso com o Grafana para visualização de dados e geração de relatórios.

Pré-requisitos

• Um Microsoft SQL Server em execução. No local ou no Azure
• Acesso administrativo ao seu Microsoft SQL Server
• Acesso ao 3CX Admin Console
• Uma licença do 3CX 16SC+ (necessária para a funcionalidade do Data Connector)

Etapa 1: Crie seu Banco de Dados SQL no Azure ou No Local

Criação de um Banco de Dados SQL no Azure

1. Faça login em seu Portal do Azure Aqui https://portal.azure.com/
2. Pesquise e navegue até SQL Servers e clique em Create (Criar)
3. Selecione ou crie um novo grupo de recursos
4. Defina um Nome de Servidor exclusivo e selecione um local próximo ao PABX
5. Selecione Use SQL Authentication (Usar Autenticação SQL) e defina seu login de administrador e uma senha forte
6. Anote essas credenciais, pois você precisará delas mais tarde para configurar o Data Connector no Admin Console do 3CX
7. Clique em Review + Create (Revisar + Criar) e então em Create (Criar)

8. Navegue até SQL Servers (Servidores SQL), abra o servidor acima que você acabou de criar e anote o Server Name (Nome do Servidor), pois você precisará dele mais tarde para configurar o Data Connector (Conector de Dados) no 3CX Admin Console.
9. Clique em Create Database (Criar Banco de Dados)

10. Defina um nome de banco de dados exclusivo
11. Selecione as especificações e o tamanho do banco de dados conforme necessário nas seções de Compute and Storage (Computação e Armazenamento)
12. Clique em Review + Create e, em seguida, em Create

13. Depois que o Banco de Dados for criado, navegue até SQL Databases (Bancos de Dados SQL) e abra o banco de dados que você acabou de criar.
14. Clique em Set Server Firewall (Definir Firewal do Servidor)

15. Mude o Acesso à Rede Pública para “Selected Networks” (Redes Selecionadas) e clique em “Add a firewall rule” (Adicionar uma regra de firewall)
16. Adicione o endereço IP público do PABX que acessará esse banco de dados e clique em Save (Salvar).

Criação de um Banco de Dados SQL no local

1. Faça o download do Microsoft SQL Server local e execute o instalador a partir daqui: https://www.microsoft.com/pt-br/sql-server/sql-server-downloads
2. Quando a instalação for bem-sucedida, prossiga com o download e instale o SQL Server Management Studio
3. Siga o assistente para instalar e iniciar o SQL Server Management Studio (SSMS)

4. Por padrão, o Microsoft SQL Server pode não estar escutando nenhuma porta ou estar escutando em portas dinâmicas. Para usar uma porta específica (por exemplo, 1433 padrão), vá para o menu Iniciar do Windows, pesquise e abra o SQLServerManager16.msc
5. No painel esquerdo, vá para SQL Server Network Configuration → Protocols for SQLEXPRESS (Configuração de Rede do SQL Server → Protocolos para SQLEXPRESS)
6. Clique com o botão direito do mouse em TCP/IP e Clique em Enable (Ativar)
7. Ainda em Protocols for SQLEXPRESS:
   Clique duas vezes em TCP/IP e vá até a guia Endereços IP
8. Role até a parte inferior e procure a seção IPAll
9. Defin a Porta TCP = 1433 e deixar as portas Dinâmicas TCP vazias e clique em OK
10. Volte para SQL Server Configuration Manager (Gerenciador de Configuração do Servidor SQL). No painel esquerdo, vá para Serviços do Servidor SQL
11. Clique com o botão direito do mouse em sua instância (por exemplo, MSSQLSERVER) e clique em Restart (Reiniciar)

12. Abra o SQL Server Management Studio (Estúdio de Gerenciamento do SQL Server) que você instalou acima
13. Você pode se conectar no localhost como administrador ao novo SQL Server usando a autenticação do Windows, conforme mostrado abaixo

14. Depois de conectado ao SSMS, clique com o botão direito do mouse em Databases > New Database
15. Dê um nome exclusivo ao banco de dados e clique em OK

16. Para habilitar a Autenticação do SQL Server para que o PABX possa se conectar ao banco de dados, clique com o botão direito do mouse no SQL Server no painel esquerdo e clique em Properties (Propriedades)
17. Navegue até Security (Segurança), selecione a opção “SQL Server and Windows Authentication mode” (Modo de Autenticação do SQL Server e do Windows) e clique em OK
18. Mais uma vez, reinicie o SQL Server a partir do SQL Server Manager, conforme mostrado acima, ou por meio do gerenciador de tarefas

19. Para criar um usuário para que o PABX se conecte a esse Banco de Dados, clique com o botão direito do mouse em Logins > New Login
20. Defina seu nome de usuário em Login Name
21. Selecione SQL Authentication e defina uma senha forte
22. Desmarque Enforce password policy (Aplicar política de senha) se não quiser regras de complexidade
23. Banco de dados padrão: selecione o novo banco de dados criado acima (por exemplo, cdr_db)

24. Ainda na mesma janela "Login", clique em User Mapping (Mapeamento de Usuários) à esquerda
25. Selecione seu novo banco de dados (por exemplo, cdr_db)
26. Em "Database role membership" (Associação de funções do banco de dados), marque as opções para
    
    
    db_datareader, db_datawriter, db_ddladmin
    
    
27. Clique em OK

Etapa 2: Configure o Conector de Dados no 3CX

1. Navegue até o Console de Admin do 3CX > Integrações > Conector de dados
2. Selecione "Microsoft SQL Server" e digite o seguinte:

• Host: O Endereço IP ou FQDN (se disponível) do Host em que você instalou o Microsoft SQL Server. Ou o Nome do Servidor fornecido pelo Azure
• Port: A porta do banco de dados (padrão: 1433).
• Database Name: O nome do banco de dados que você criou na Etapa 1.
• Username: O nome de usuário do novo usuário que você criou na Etapa 1.
• Password: A senha que você configurou para seu novo usuário
• Frequency: Defina a frequência da transferência de dados do PABX para o Banco de Dados SQL do Azure.

3. Salve a configuração e clique no botão “Test” (Testar) em seu PABX para verificar a conexão com o banco de dados Microsoft SQL e confirmar o recebimento de uma mensagem de sucesso. Se o teste falhar, verifique novamente o host, a porta, o nome do banco de dados, o nome de usuário e a senha. Além disso, verifique se os firewalls permitem conexões do IP do PABX.

Etapa 3: Conecte o Grafana ao Banco de Dados Microsoft SQL

1. Faça login na sua instância do Grafana (por exemplo, grafana.com ou seu Grafana auto-hospedado).
2. 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).
3. Pesquise e selecione "Microsoft SQL Server"

4. Configure a fonte de dados em “Connection” (Conexão) e insira os seguintes detalhes:

• Host: Digite o IP ou FQDN e a porta de seu Microsoft SQL Server no formato: IP/FQDN:1433
• Database: O nome do banco de dados que você criou na Etapa 1
• User: O nome de usuário do novo usuário que você criou na Etapa 1
• Password: A senha que você configurou para seu novo usuário
• Authentication Type: Autenticação do SQL Server

5. Clique em “Save & test” e verifique se você recebe a mensagem “Database Connection OK”. Se você encontrar erros, verifique novamente os detalhes da conexão e a configuração SSL. Além disso, verifique se todos os firewalls no host ou na rede do Microsoft SQL permitem conexões de IPs do Grafana.

Última Atualização
Este documento foi atualizado pela última vez em 24 de julho de 2025
https://www.3cx.com.br/docs/configuracao-servidor-microsoft-sql/