Conectando o 3CX a um PostgreSQL Standalone e ao Grafana

Introdução

Este guia fornece um processo conciso para conectar seu sistema telefônico 3CX a um banco de dados PostgreSQL Standalone para uso com o Grafana para visualização de dados e geração de relatórios.

Etapa 1: Criar um PostgreSQL

  1. Instalar o PostgreSQL
  • Windows: Faça o download do instalador em https://www.postgresql.org/download/windows/ e siga o assistente.
  • Linux (Debian): sudo apt update && sudo apt install -y postgresql Verificar o cluster: pg_lsclusters. Criar, se necessário: sudo pg_createcluster <major-version> main --start.
    Lembre-se da senha do superusuário do postgres e dos detalhes da instalação (porta 5432 padrão).
  1. Criar Usuário e Banco de Dados PostgreSQL
  • Windows: Open psql.
  • Em seguida, execute o SQL :
                CREATE ROLE your_user WITH LOGIN PASSWORD 'your_password';
            CREATE     DATABASE your_db OWNER your_user;
  • Linux (Debian):

sudo -u postgres createuser <username> -P
        sudo -u postgres createdb <dbname> -O <username>

Substitua seu_usuário/nome_usuário, sua_senha e sua_db/nomedb conforme necessário.

  1. Permitir Conexões Remotas
  • Editar postgresql.conf:
  • Windows: Normalmente, em C:\Program Files\PostgreSQL\<version>\data\postgresql.conf. Set listen_addresses = '*'.
  • Linux (Debian): Normalmente, em /etc/postgresql/<version>/main/postgresql.conf. Set listen_addresses = '*'.
  • Editar pg_hba.conf:
  • Windows: Normalmente, em C:\Program Files\PostgreSQL\<version>\data\pg_hba.conf.
    Add:     host    your_db         your_user        <allowed_ip>/<cidr>         scram-sha-256
  • Linux (Debian): /etc/postgresql/<version>/main/pg_hba.conf.
    Add:     host    <dbname>        <username>       <allowed_ip>/<cidr>         scram-sha-256

Substitua <allowed_ip>/<cidr> para restringir o acesso, se necessário, por exemplo, 0.0.0.0/0 para qualquer IP).

  1.  Reinicie o Serviço PostgreSQL:
  • Windows: net stop postgresql-x64-<version> then net start postgresql-x64-<version> (as administrator).
  • Linux (Debian): sudo systemctl restart postgresql
  1. Conceder Privilégios de Banco de Dados
  • Windows & Linux: Open psql (Windows) or sudo -u postgres psql (Linux) and run SQL :
    GRANT ALL PRIVILEGES ON DATABASE your_db TO your_user;

Use o banco de dados e os nomes de usuário configurados.

Alternativamente: Configuração rápida via script

Observe que esses scripts podem não ser mantidos ativamente e seu uso é de sua própria responsabilidade. Tenha cuidado ao executar scripts com privilégios administrativos.

Etapa 2: Configurar o Conector de Dados no 3CX

  1. No 3CX, navegue até Admin Console > Integrations > Data Connector
  2. Selecione "PostgreSQL Database" e digite o seguinte:
  • Host: O endereço IP ou FQDN (se disponível) do host em que você instalou o PostgreSQL.
  • Port: A porta do banco de dados (padrão: 5432).
  • 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 o novo usuário
  • Frequency: Defina a frequência da transferência de dados do PABX para o PostgreSQL.
  1. Salve a configuração e clique no botão "Test" em seu PABX para verificar a conexão com o banco de dados PostgreSQL e confirmar se você recebeu 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 PostgreSQL permitem conexões do IP do PABX.

Clique no botão TEST para verificar a conexão em seu PABX

Observe: Você deve ter uma licença 16SC+ para usar o Conector de Dados 3CX.

Etapa 3: Conectar o Grafana à Instância do PostgreSQL

  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 "PostgreSQL".

Fonte de Dados PostgreSQL

Adicionar Fonte de Dados PostgreSQL

  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 PostgreSQL no formato: IP/FQDN:5432
  • 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 o novo usuário

Configurando a fonte de dados do seu PostgreSQL

  1. Clique em “Save & test” (Salvar e testar) e verifique se você recebe a mensagem “Data source is working” (A fonte de dados está funcionando). 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 PostgreSQL permitem conexões de IPs do Grafana.

Clique em Save & test e verifique se você recebe a mensagem <b>“Data source is working”</b> (A fonte de dados está funcionando)

Veja Também

Última atualização

Este documento foi atualizado pela última vez em 15 de maio de 2025

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