Conexión de 3CX a un PostgreSQL Independiente y Grafana

Introducción

Esta guía provee un proceso conciso para conectar su sistema telefónico 3CX a una base de datos PostgreSQL independiente para uso con Grafana para visualización de datos y reportes.

Paso 1: Crear un PostgreSQL

1. Instalar PostgreSQL:

• Windows: Descargue el instalador desde https://www.postgresql.org/download/windows/ y siga los pasos del asistente.
• Linux (Debian): 
  sudo apt update && sudo apt install -y postgresql
  Verifique el cluster:
  pg_lsclusters
  . Crearlos si es necesario:
  sudo pg_createcluster <major-version> main --start
  .
  Recuerde la contraseña de superusuario de postgres y los datos de instalación (puerto 5432 por defecto).
  

2. Crear el Usuario y la Base de Datos de PostgreSQL:

• Windows: Abra
  psql
  .

• Luego ejecute SQL :
          
  CREATE ROLE your_user WITH LOGIN PASSWORD 'your_password';
  
          
  CREATE DATABASE your_db OWNER your_user;

• Linux (Debian):

Sustituya su_usuario/nombre_usuario, su_contraseña y su_db/nombre_db según sea necesario.

3. Permitir Conexiones Remotas:

• Edite
  postgresql.conf
  :

• Windows: Generalmente en
  C:\Program Files\PostgreSQL\<version>\data\postgresql.conf. Set listen_addresses = '*'
  .
• Linux (Debian): Generalmente en
  /etc/postgresql/<version>/main/postgresql.conf. Set listen_addresses = '*'
  .

• Edite
  pg_hba.conf
  :

• Windows: Generalmente en
  C:\Program Files\PostgreSQL\<version>\data\pg_hba.conf
  .
  Agregue:
  host your_db your_user <allowed_ip>/<cidr> md5
• Linux (Debian): 
  /etc/postgresql/<version>/main/pg_hba.conf
  .
  Agregue:
  host <dbname> <username> <allowed_ip>/<cidr> md5

Sustituya <allowed_ip>/<cidr> para restringir el acceso si es necesario, por ejemplo: 0.0.0.0/0 para cualquier IP.

4.  Reiniciar el Servicio PostgreSQL:

• Windows:
  net stop postgresql-x64-<version>
   luego
  net start postgresql-x64-<version>
   (como administrador).
• Linux (Debian): 
  sudo systemctl restart postgresql
  .
  

5. Conceder Privilegios a la Base de Datos:

• Windows y Linux: Abra
  psql
   (Windows) o
  sudo -u postgres psql
   (Linux) y ejecute SQL :
  CONCEDA TODOS LOS PRIVILEGIOS SOBRE LA BASE DE DATOS
  su_db
  A
  su_usuario
  ;

Utilice la base de datos y los nombres de usuario que haya configurado.

Como alternativa: Configuración Rápida mediante script.

• Linux: Como
  root[7code], ejecute: sudo bash -c "$(wget -qO- https://downloads-global.3cx.com/downloads/misc/postgresql/linuxwizard.zip)"
  y siga las instrucciones del asistente.
• Windows: Instale PostgreSQL (consulte los pasos de instalación de Windows), abra PowerShell como Administrador y ejecute:
  https://downloads-global.3cx.com/downloads/misc/postgresql/windowswizard.zip
   y siga las instrucciones del asistente.

Tenga en cuenta que es posible que estos scripts no se mantengan de forma activa y que su uso queda bajo su propia responsabilidad. Tenga cuidado al ejecutar scripts con privilegios administrativos.

Paso 2: Configurar el Conector de Datos en 3CX

1. En 3CX, navegue a Consola de Administración > Integraciones > Conector de Datos.
2. Seleccione "Base de Datos PostgreSQL" e ingrese lo siguiente:

• Host: La dirección IP o FQDN (si está disponible) del Host en el que instaló PostgreSQL.
• Validación SSL: Si el PBX debe intentar verificar el certificado SSL remoto.

• Certificado CA: Se muestra solo si se selecciona Validación SSL. Suba el certificado CA.

• Puerto: El puerto de la base de datos (por defecto: 5432).
• Nombre de la Base de Datos: El nombre de la base de datos que creó en RDS.
• Nombre de Usuario: El nombre de usuario maestro que configuró en RDS.
• Contraseña: La contraseña maestra.
• Tipo de Datos: Elija los datos que desea transferir.
• Frecuencia: Establezca la frecuencia de transferencia de datos desde el PBX a su PostgreSQL.

3. Guarde la configuración y haga clic en el botón “Probar” de su PBX para verificar la conexión con la base de datos PostgreSQL y confirmar que recibe un mensaje de éxito. Si la prueba falla, vuelva a comprobar el host, el puerto, el nombre de la base de datos, el nombre de usuario y la contraseña. También, verifique que cualquier cortafuegos en el host PostgreSQL o red permite conexiones desde la IP de su PBX.

Tenga en cuenta: Para poder usar el Conector de Datos 3CX, debe tener una licencia 16SC+.

Paso 3: Conectar Grafana a la Instancia PostgreSQL

1. Inicie sesión en su instancia de Grafana (por ejemplo: grafana.com o su Grafana auto-hospedado).
2. Vaya al menú de configuración de Grafana (icono de engranaje), haga clic en “Fuentes de Datos” y luego haga clic en “Añadir fuente de datos”.
3. Busque y seleccione "PostgreSQL".

4. Configure la fuente de datos debajo de "Conexión",ingrese los siguientes detalles:

• Host: Ingrese la IP o FQDN y el puerto de su PostgreSQL en el formato: IP/FQDN:5432.
• Base de Datos: El nombre de la base de datos que creó en el Paso 1.
• Usuario: El nombre de usuario del nuevo usuario creado en el Paso 1.
• Contraseña: La contraseña que configuró para su nuevo usuario.

5. Haga clic en “Guardar y probar” y compruebe que recibe el mensaje “La fuente de datos funciona”. Si se producen errores, vuelva a comprobar los detalles de la conexión y la configuración SSL. Además, verifique que cualquier firewall en el host PostgreSQL o red, permite conexiones desde las IPs de Grafana.

Ver También

• Conexión de 3CX a Google BigQuery y Grafana.
• Conexión de 3CX a AWS RDS PostgreSQL y Grafana.

Última Actualización

Este documento se actualizó por última vez el 2 de Junio de 2026

https://www.3cx.es/docs/configuracion-postgresql/