Implantando Visualizações 3CX Grafana A Partir do Grafana Marketplace

Introdução

As visualizações 3CX Grafana estão disponíveis no Grafana Marketplace, permitindo que você implante painéis 3CX pré-construídos de forma rápida e fácil. Este guia se aplica à Versão 3CX 20, Update 7 (SP7) e posteriores.

O recurso Conectores de Dados requer uma licença 16SC ou superior.

Pré-requisitos

Antes de implantar o Plug-in 3CX Grafana, certifique-se de que o seguinte esteja configurado:

  • Um Conector de Dados em funcionamento (consulte os guias para):
  • Opções de Transferência de Dados habilitadas para as métricas que você pretende visualizar no Grafana (por exemplo, histórico de chamadas (CDR), métricas do sistema etc.).

Configurando Conectores de Dados

Passo 1: Cadastre-se no Grafana

  • Visite o Grafana e registre-se para criar uma nova conta (qualquer nível, incluindo o plano gratuito, é aceito).
  • Se estiver criando uma nova conta, configure seu Grafana Stack - essa será a URL base onde seus painéis serão hospedados.

Passo 2: Adicione Sua Fonte de Dados 3CX

Neste exemplo, usaremos o MySQL. Para outros bancos de dados, consulte a documentação relevante do Conector de Dados.

  • Na página “Inicial” do Grafana, expanda “Conexões” e selecione “Adicionar nova conexão”.

Conexões > Adicionar nova conexão

  • Selecione “Fonte de dados MySQL” (ou o tipo de conector escolhido).

Escolha a Fonte de dados MySQL

  • Selecione “Adicionar nova fonte de dados”.

Adicione a nova fonte de dados

  • Insira o nome e todos os detalhes relevantes para sua Conexão com o Banco de Dados antes de selecionar “Salvar e testar” para confirmar.
  • Você deve usar um Usuário de Banco de Dados com permissão apenas para SELECT nas tabelas 3CX.

Configurando Banco de Dados mysql

Você pode restringir ainda mais o acesso ao seu banco de dados usando a Lista de IPs permitidos fornecida pela Grafana aqui.

Passo 3: Configure o Plugin

  • Navegue até o Plugin Marketplace a partir da Página Inicial do Grafana->Administração->Plugins e dados->Plugins

Buscando pelo Plugin 3CX para Grafana no Marketplace

  • Na página do Plugin 3CX, clique em Instalar.

Instalando o Plugin 3CX para Grafana

  • Quando a Instalação estiver concluída (alguns segundos a alguns minutos), o botão Ativar será exibido. Pode ser necessário atualizar a página.
  • Quando estiver visível, clique nele.

Ativando o Plugin 3CX para Grafana

  • A página será atualizada e uma nova opção 3CX (e Configuração) aparecerá em “Mais Apps”.
  • Vá para Configuração e escolha a fonte de dados criada anteriormente. Se uma fonte de dados compatível for escolhida, uma marca verde aparecerá e a opção “Publicar painéis” ficará disponível.
  • Clique nessa opção para continuar.

Configurando Fonte de Dados do Plugin 3CX

Passo 4: Visualize os Painéis

  • A página deve atualizar automaticamente e abrir a lista Painéis no App 3CX.

Lista dos Painéis no App 3CX

  • Os Painéis também estarão disponíveis em uma pasta 3CX na seção principal Painéis.

Os Painéis também estarão disponíveis em uma pasta 3CX na seção principal Painéis.

  • Ao clicar em qualquer um deles, os dados disponíveis serão carregados imediatamente e começarão a ser exibidos.

Ao clicar em qualquer um deles, os dados disponíveis serão carregados imediatamente e começarão a ser exibidos.

Passo 5: Implantações Em Vários Sistemas e Personalização

Se você deseja monitorar várias instâncias do 3CX dentro do mesmo Grafana Stack (domínio) ou fazer personalizações nos modelos fornecidos, você pode fazer cópias deles usando a função Exportar. Ela se encontra na parte superior de cada visualização do Painel.

Em seguida, você poderá importá-los a partir do painel principal Dashboards. Será solicitado que você escolha um novo Identificador Exclusivo para este Painel dentro da sua Pilha, bem como a qual Banco de Dados (do mesmo tipo que a implantação original) se conectar.

Passo 6: Alerta

O Grafana permite definir gatilhos de alerta para todas as métricas rastreadas. Aqui está um exemplo de como adicionar um Alerta para Alto Uso da CPU.

  • No painel “Saúde e desempenho”, selecione “Nova regra de alerta”, localizado no menu “+”.

No painel <b>“Saúde e desempenho”</b>, selecione <b>“Nova regra de alerta”</b>, localizado no menu <b>“+”</b>.

  • Dê um nome ao seu alerta e defina os parâmetros básicos que serão monitorados.

Dê um nome ao seu alerta e defina os parâmetros básicos que serão monitorados.

  • Continue com as próximas etapas, configurando vários metaparametros para o Alerta, como Pastas e Tags, bem como os destinatários e o texto do Alerta e a URL do Runbook.

Continue com as próximas etapas, configurando vários metaparametros

Veja Também

Última atualização

Este documento foi atualizado pela última vez em 15 de janeiro de 2026.

https://www.3cx.com.br/docs/relatorios-pabx-grafana/