Implementazione delle grafiche 3CX Grafana dal Marketplace

Introduzione

Le grafiche 3CX Grafana sono disponibili sul Grafana Marketplace e consentono di implementare in modo semplice e veloce dashboard 3CX predefinite. Questa guida è valida per la versione 20 di 3CX, aggiornamento 7 (SP7) e successive.

La funzione Data Connectors richiede una licenza 16SC o superiore.

Prerequisiti

Prima di implementare il plugin 3CX Grafana, assicurarsi che siano configurati i seguenti elementi:

  • Un connettore dati funzionante (vedere le guide per):
  • Opzioni di trasferimento dati abilitate per le metriche che si intende visualizzare in Grafana (ad esempio, cronologia delle chiamate (CDR), metriche di sistema, ecc.

Passo 1: Registrazione a Grafana

  • Visita Grafana e registrati per un nuovo account (è supportato qualsiasi livello, incluso il piano gratuito).
  • Se si crea un nuovo account, configurare Grafana Stack: questo sarà l'URL di base dove saranno ospitati i dashboard.

Passo 2: Aggiungere la fonte dati 3CX

In questo esempio, useremo MySQL. Per altri database, fare riferimento alla documentazione relativa al connettore dati.

  • Da Grafana Home espandi Connessioni e scegli Aggiungi nuova connessione.

  • Seleziona “Origine dati MySQL” (o il tipo di connettore scelto).

  • Scegli “Aggiungi nuova fonte dati”

  • Assegna un nome e aggiungi tutti i dettagli rilevanti per la tua connessione al database, quindi scegli “Salva e testa” per confermare.
  • È necessario utilizzare un utente del database con solo autorizzazione SELECT per le tabelle 3CX.

È possibile limitare ulteriormente l'accesso al database utilizzando gli IP dell'elenco di autorizzazioni forniti da Grafana qui.

Passo 3: configurazione del plugin

  • Accedi al Plugin Marketplace da Grafana Home->Amministrazione->Plugin e dati->Plugin.

  • Nella pagina Plugin 3CX, clicca su “Installa”.

  • Al termine dell'installazione (da pochi secondi a un paio di minuti), viene visualizzato il pulsante Abilita. Potrebbe essere necessario aggiornare la pagina.
  • Una volta visualizzato, cliccalo.

  • La pagina verrà aggiornata e una nuova opzione 3CX (e Configurazione) apparirà sotto “Altre app”.
  • Vai su Configurazione e scegli l'origine dati creata in precedenza. Se viene scelta un'origine dati compatibile, apparirà un segno di spunta verde e sarà disponibile l'opzione “Pubblica dashboard”.
  • Cliccaci per continuare.

Passo 4: Visualizzare le dashboard

  • La pagina dovrebbe aggiornarsi automaticamente e aprire l'elenco delle dashboard sotto l'app 3CX.

  • Le dashboard saranno ora disponibili anche in una cartella 3CX sotto la sezione principale Dashboard.

  • Cliccando su uno qualsiasi di essi, i dati disponibili verranno immediatamente caricati e visualizzati.

Passo 5: Implementazioni multisistema

Se desideri monitorare più istanze 3CX all'interno dello stesso Grafana Stack (dominio) o personalizzare i modelli forniti, puoi crearne delle copie utilizzando la funzione Esporta. Si trova nella parte superiore di ogni vista Dashboard.

È quindi possibile importarli dal pannello principale delle Dashboard. Verrà richiesto di scegliere un nuovo identificatore univoco per questa Dashboard all'interno dello Stack, nonché il database (dello stesso tipo dell'implementazione originale) a cui connettersi.

Passo 6: Avvisi

Grafana consente di impostare trigger di avviso per tutte le metriche monitorate. A titolo di esempio, ecco come aggiungere un avviso per un utilizzo elevato della CPU.

  • All'interno della Dashboard “Salute e prestazioni”, selezionare “Nuova regola di avviso”, che si trova nel menu “+”.

  • Assegnare un nome all'avviso e definire i parametri di base che saranno monitorati.

  • Prosegui con i passaggi successivi configurando vari meta-parametri per l'avviso, come cartelle e tag, nonché i destinatari e il testo dell'avviso e l'URL del runbook.

Per saperne di più

Ultimo aggiornamento

Questo documento è stato aggiornato il 3 febbraio 2026.

https://www.3cx.it/doc/configurazione-report-grafana/