Conexão do 3CX a um MySQL Autônomo e Grafana

Introdução

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

Pré-requisitos

  • Um servidor MySQL em execução.
  • Acesso administrativo ao seu servidor MySQL.
  • Acesso ao Admin Console do 3CX.
  • Uma licença 3CX 16SC+ (necessária para a funcionalidade do Data Connector).
  • Conhecimento básico de administração do MySQL e SQL.

Etapa 1: Prepare seu MySQL

  1. Configure seu Banco de Dados MySQL

Depois de instalar o Banco de Dados MySQL, faça as seguintes alterações na configuração:

Habilite local_infile na configuração do MySQL. Certifique-se de ativar o Parâmetro Global local_infile, que é crucial para que a 3CX transfira dados em massa com eficiência. Para fazer isso, edite o arquivo de configuração do MySQL e adicione ou modifique o parâmetro local_infile na seção [mysqld]:

[mysqld]

local_infile=1

  1. Permitir Conexões Remotas com o Banco de Dados

Por padrão, o MySQL permitirá conexões a partir do host local. Você precisará permitir conexões remotas para que o PABX possa se conectar ao banco de dados. Para fazer isso, edite o arquivo de configuração do MySQL e adicione ou modifique o parâmetro bind-address:

bind-address = 0.0.0.0

O local do arquivo de configuração do MySQL varia de acordo com o sistema operacional:

  • Linux: Os locais comuns incluem  /etc/mysql/my.cnf,  /etc/my.cnf, ou  /etc/mysql/mysql.conf.d/mysqld.cnf.
  • Windows: Normalmente, em C:\ProgramData\MySQL\MySQL Server X.Y\my.ini.

  1. Reinicie seu Banco de Dados MySQL para Aplicar as Alterações Acima

Após a edição, reinicie o serviço MySQL para que as alterações tenham efeito:

  • Linux: sudo systemctl restart mysql
  • Windows: Reinicie o serviço MySQL no Gerenciador de Serviços.

  1. Criar um Usuário e um Banco de Dados MySQL Dedicados

Faça login no MySQL como usuário raiz ou administrativo:        

mysql -u root -p

Digite sua senha raiz, se solicitado.

Crie o Banco de Dados

Escolha um nome descritivo para seu banco de dados CDR (e.g., 3cx_cdr_db).


CREATE DATABASE 3cx_cdr_db;


Crie Usuário

Escolha uma senha forte para seu novo usuário CRIAR USUÁRIO 'cdrdb'@'%' IDENTIFICADO POR '4zYThcp#KWB2aRmI2t5!P';

CREATE USER 'our_3cx_user'@'host' IDENTIFIED BY 'your_3cx_user_password';

Substitua “your_3cx_user” e “your_3cx_user_password” com suas credenciais desejadas.

Substitua 'host' com o endereço IP do seu servidor 3CX se quiser permitir conexões com o banco de dados apenas pelo PABX, ou substitua ‘host’ com ‘%’ se você quiser permitir o acesso de qualquer lugar

Exemplos:

CREATE USER 'dbuser'@'192.168.10.1' IDENTIFIED BY 'myPass'; – to allow access only an IP

CREATE USER 'dbuser'@'192.168.10.1' IDENTIFIED BY 'myPass'; – to allow access from any IP

Conceder Permissões

Por fim, execute os seguintes comandos para definir as permissões adequadas do usuário para o banco de dados

GRANT INSERT, SELECT, CREATE, ALTER, DROP, INDEX, LOCK TABLES ON 3cx_cdr_db.* TO 'your_3cx_user'@'host';

FLUSH PRIVILEGES;

Novamente aqui, substitua 3cx_cdr_db, ‘your_3cx_user’ e ‘host’ de acordo com os valores fornecidos acima

  1. Configure o Firewall (Se Aplicável)

Certifique-se de que o firewall do servidor MySQL permita conexões de entrada na porta MySQL (padrão: 3306) a partir do Endereço IP do Sistema Telefônico 3CX.

  • Linux (e.g., ufw):
    sudo ufw allow from <3CX_PBX_IP_Address> to any port 3306
    sudo ufw reload (permitir de <3CX_PBX_IP_Address> para qualquer porta 3306
    sudo ufw reload)
  • Windows Firewall: Crie uma regra de entrada para permitir conexões TCP na porta 3306 a partir do endereço IP do seu PABX 3CX.

Etapa 2: Configure o Conector de Dados no 3CX

  1. No 3CX, navegue até o Admin Console > Integrações > Conector de Dados
  2. Selecione "MySQL" e digite o seguinte:
  • Host: O Endereço IP ou FQDN (se disponível) do Host em que você instalou o MySQL.
  • Port: A porta do banco de dados (padrão: 3306).
  • 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 MySQL.
  1. Salve a configuração e clique no botão “Test” (Testar) em seu PABX para verificar a conexão com o banco de dados MySQL 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 no host ou na rede do MySQL permitem conexões do IP do PABX.

Configure o Conector de Dados no 3CX

Etapa 3: Conecte o Grafana à instância do MySQL

  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. Procure e selecione “MySQL”.

Conecte o Grafana à instância do MySQLAdicione fonte de dados MySQL

  1. 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 Banco de Dados Mysql no formato: IP/FQDN:3306
  • 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

Configure a fonte de dados em <b>“Connection”</b> (Conexão) inserindo esses detalhes

  1. Clique em “Save & test” (Salvar e testar) e verifique se você recebe a mensagem “Data Connection OK” (Conexão de Dados OK). Se você encontrar erros, verifique novamente os detalhes da conexão e a configuração SSL. Além disso, verifique se os firewalls no host ou na rede do MySQL permitem conexões de IPs do Grafana.

Mensagem informando que a Conexão com o Banco de Dados foi um sucesso.

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