Connessione di 3CX ad AWS RDS PostgreSQL e Grafana

Introduzione

Questa guida illustra i passaggi per collegare 3CX a un database AWS RDS PostgreSQL e utilizzare Grafana per connettersi e visualizzare i dati con funzionalità di dashboard e reporting.

Passo 1: Creare un database PostgreSQL

  1. Installare PostgreSQL
  • Windows: Scaricare il programma di installazione da https://www.postgresql.org/download/windows/ e seguire la procedura guidata.
  • Linux (Debian):
  •  sudo apt update && sudo apt install -y postgresql Verify cluster: pg_lsclusters. Create if needed: sudo pg_createcluster <major-version> main --start.
    Ricordare la password del superutente postgres e i dettagli di installazione (porta 5432 predefinita).
  1. Creare utente e database PostgreSQL
  • Windows: Aprire psql.
  • Quindi eseguire 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>

Sostituisci your_user/username, your_password e your_db/dbname come necessario.

  1. Consenti le connessioni remote
  • Modifica postgresql.conf:
  • Windows: In genere si trova in C:\Program Files\PostgreSQL\<version>\data\postgresql.conf. Set listen_addresses = '*'.
  • Linux (Debian): In genere si trova in /etc/postgresql/<version>/main/postgresql.conf. Set listen_addresses = '*'.
  • Modifica pg_hba.conf:
  • Windows: In genere si trova in C:\Program Files\PostgreSQL\<version>\data\pg_hba.conf.
    Aggiungere:     host    your_db         your_user        <allowed_ip>/<cidr>         scram-sha-256
  • Linux (Debian): /etc/postgresql/<version>/main/pg_hba.conf.
    Aggiungere:     host    <dbname>        <username>       <allowed_ip>/<cidr>         scram-sha-256

Sostituire <allowed_ip>/<cidr> per limitare l'accesso se necessario, ad es. 0.0.0.0/0 for any IP.)

  1.  Riavviare il servizio PostgreSQL:
  • Windows: net stop postgresql-x64-<version> e poi net start postgresql-x64-<version> (as administrator).
  • Linux (Debian): sudo systemctl restart postgresql
  1. Concedere i privilegi sul database
  • Windows & Linux: Aprire psql (Windows) o sudo -u postgres psql (Linux) ed eseguire SQL :
    GRANT ALL PRIVILEGES ON DATABASE your_db TO your_user;

Utilizzare il database e i nomi utente configurati.

In alternativa: Configurazione rapida tramite script

Tieni presente che questi script potrebbero non essere aggiornati regolarmente e il loro utilizzo è a tuo rischio e pericolo. Fai attenzione quando esegui script con privilegi amministrativi.

Passo 2: Configurare il Data Connector su 3CX

  1. Su 3CX, navigare in Admin Console > Integrazioni > Connettore dati
  2. Selezionare “Database PostgreSQL” e inserire quanto segue:
  • Host: L'endpoint RDS copiato al punto 1.
  • Convalida SSL: Indica se il centralinio deve tentare di verificare il certificato SSL remoto.
  • Visualizzato Solo se è selezionata l'opzione “Convalida SSL”. Carica il certificato CA.
  • Porta: La porta del database (predefinita: 5432).
  • Database: Il nome del database creato in RDS.
  • Username: Il nome utente principale configurato in RDS.
  • Password: La password principale.
  • Tipi di dati: Scegli quali dati desideri trasferire.
  • Frequenza: Impostare la frequenza di trasferimento dei dati dal PBX all'istanza RDS..
  1. Salvare la configurazione e cliccare sul pulsante “Test” del centralino per verificare la connessione al database RDS e confermare la ricezione di un messaggio di successo. Se il test fallisce, ricontrollare l'endpoint, la porta, il nome del database, il nome utente e la password. Inoltre, verificare le regole del gruppo di sicurezza in AWS.

Nota bene: Per utilizzare 3CX Data Connector è necessario disporre di una licenza 16SC+

Passo 3: Collegare Grafana all'istanza AWS RDS PostgreSQL

  1. Accedere alla propria istanza di Grafana (ad esempio, grafana.com o Grafana self-hosted).
  2. Accedere al menu di configurazione di Grafana (icona dell'ingranaggio), cliccare su “Data Sources” e su “Add data source”.
  3. Cercare e selezionare “PostgreSQL”.

  1. Configurare il data source alla voce “Connessione”, inserendo i seguenti dettagli:
  • Host: Inserire l'endpoint RDS e la porta nel formato: your-rds-endpoint.amazonaws.com:5432
  • Database: Il nome del database.
  • User: Il nome utente principale.
  • Password: La password principale.

  1. Cliccare su “Salva e prova” e verificare che venga visualizzato il messaggio “Data source in esecuzione”. Se si verificano errori, ricontrollare i dettagli della connessione, le regole del gruppo di sicurezza e la configurazione SSL.

Per saperne di più

Ultimo aggiornamento

Questo documento è stato aggiornato il 12 giugno 2026

https://www.3cx.it/doc/configurazione-aws-postgresql/