3CX Ligação

3CX Ligação #

Esta conexão fornece um serviço de coleta de dados para o 3CX plataforma de comunicações. Ele fornece modelagem de dados de chamada para permitir o uso de análise de chamadas (Dashboards/Wallboards) em Self-Hosted 3CX instalações.

Esta página descreve como instalar o 3CX Serviço de coletor remoto em um 3CX PBX

Requerimentos #

Os seguintes requisitos devem ser atendidos para implantar ~.Dimensions.~ em A 3CX instalação.

  • Auto-hospedado 3CX rodando 18.0 ou posterior1 no Linux
  • Conta de usuário de administrador dedicado no 3CX sistema

Information Circle info

Completo 3CX Informações de suporte da versão de lançamento aqui.

O ~.Dimensions.~ 3CX coletor será executado no 3CX máquina host para coletar dados e passá-los para o principal ~.Dimensions.~ solução na nuvem para armazenamento e análise. O coletor usa recursos mínimos da CPU, mas tem um impacto nos requisitos de memória para o 3CX anfitrião.

A tabela abaixo fornece um guia para o uso de memória do coletor.

Chamadas Simultâneas Uso esperado de memória
4 - 32 ~ 350 MB
48 - 64 ~ 600 MB
96 - 128 ~ 750 MB
192 - 256 ~ 900 MB
512 - 1024 ~ 1024 MB

Document note

Os requisitos de memória são afetados pelo número de dispositivos, usuários e taxa de chamadas. Esteja preparado para implantar mais memória, se necessário.


  1. Verifique se as suas versões são suportadas aqui antes da atualização. ↩︎

Instalação #

Passo 1 - 3CX Configuração da conta de usuário #

Por favor, crie um » Proprietário do sistema' conta (com uma senha complexa) para ~.Dimensions.~ no 3CX Exemplo:

image.png

Esta conta é usada pelo ~.Dimensions.~ Software coletor para consultar informações de configuração e licença do 3CX que é necessário para modelar corretamente o tráfego de chamadas.

Color Wand tip

Certifique-se de que » Ativar 2FA' está desativado.

Color Wand tip

As Credenciais de Utilizador para esta conta serão necessárias no Passo 2.

Passo 2 - ~.Dimensions.~ Criação de Conta de Cliente #

No ~.Dimensions.~ portal do revendedor, crie um novo PBX conexão, entrando no 3CX Chave de licença e o nome de usuário/ext e senha da etapa anterior

image.png

Passo 3 - ~.Dimensions.~ 3CX Instalação do coletor #

Agora que o ~.Dimensions.~ A conta do cliente foi criada, o coletor de dimensões pode ser instalado no 3CX instância. Uma vez instalado, ele se conectará automaticamente de volta ao ~.Dimensions.~ Conta de cliente usando as informações da chave de licença e começará a modelar a chamada e a atividade do usuário.

  • SSH no 3CX instância.

  • Verifique se você está começando na pasta inicial dos usuários

cd $home
  • Faça o download do script do instalador no site do cliente para essa região (na, uk, eu ou au)
wget -O install.sh https://clients. {região}.myreports.cloud/3cx/install.sh

Information Circle info

Substitua {region} por na (América do Norte), pt (Reino Unido), UE (União Europeia) ou AU (Austrália/Nova Zelândia), dependendo da sua região.

Hand Left warning

O -O flag substitui qualquer script existente nessa pasta

  • Tornar o script executável
chmod +x ./install.sh
  • Execute o script fornecendo o número da versão que você deseja instalar, por exemplo.
sudo ./install.sh mais recente

Isso deve mostrar que o caminho de instalação não foi encontrado e executar uma instalação limpa para /opt/RemoteCollector.ThreeCx/

image.png

O coletor agora deve ser instalado e deve começar a passar as informações da chamada e do usuário de volta para o servidor para habilitar os recursos de análise.

Etapa 4 - Personalizações #

Se você estiver usando uma porta não padrão no seu 3CX sistema, você precisará atualizar um local » settings.json' arquivo com os detalhes corretos para o ~.Dimensions.~ 3CX Coletor para se conectar ao 3CX com sucesso.

Modifique o seguinte ficheiro:

/opt/RemoteCollector.ThreeCx/settings.json

Altere os dois parâmetros a seguir:

 "AutoDetectHost": falso,
 "ThreeHostPort": {CUSTOMVALUE}

Information Circle info

O » settings.json' O arquivo é criado pelo coletor depois de instalado.

Um exemplo do » settings.json' ficheiro:

{
  "PersistedSettings": {
    "TenantId": "",
    "LicenseKey": "",
    "InstrumentationConnectionString": "",
    "EnableAutoUpdate": verdadeiro,
    "AutoUpdateTime": "02:00:00",
    "AutoDetectHost": falso,
    "ThreeHostProtocol": "https",
    "ThreeHost": "127.0.0.1",
    "ThreeHostDisableSslValidation": verdadeiro,
    "ThreeHostPort": 1234
}

Atualizar #

Automaticamente #

Do PBX Configuração do coletor dentro de ~.Dimensions.~ pressione o botão Atualização botão.

Manualmente #

Execute o script com o novo número de versão e ele atualizará automaticamente o software:

sudo ./install.sh 1.87.2

A mensagem deve mostrar que uma instalação foi encontrada e que está sendo atualizada

image.png

Desinstalar #

Execute o script com remover como parâmetro

sudo ./install.sh remover

Isso solicitará se você quiser remover o conector

image.png

Imprensa Y Para continuar, isso removerá o serviço, todos os arquivos e logs.

Instalando uma versão específica #

Se instruído pelo suporte, pode ser necessário instalar uma versão específica do coletor (para suportar um 3CX ou testar um patch, por exemplo).

Para instalar uma versão específica, insira a versão específica em vez de Mais recente:

sudo ./install.sh 1.87.1
Hand Left warning
Só o faça se for instruído pelo apoio.

Controlando o serviço #

Pare o serviço

systemctl parar RemoteCollector.ThreeCx.service

Iniciar o serviço

systemctl iniciar RemoteCollector.ThreeCx.service

Obter o estado do serviço

status systemctl RemoteCollector.ThreeCx.service

Ver registos de serviço

Ver registos

journalctl -xeu RemoteCollector.ThreeCx.service

Siga os logs ao vivo:

journalctl -xefu RemoteCollector.ThreeCx.service

Registos #

Por padrão, os logs são instalados em

/opt/RemoteCollector.ThreeCx/logs

Eles são compactados em uma pasta de arquivo em uma base diária.

image.png

Os logs podem ser recuperados do cliente usando o botão push logs no botão Editar PBX no portal do revendedor:

image.png

Ver Instalado 3CX Versão #

Para visualizar a versão instalada do 3CX quando conectado via SSH:

política apt-cache 3cxpbx

Isso retornará a versão instalada e a versão mais recente disponível.

image.png