3CX Connexion

3CX Connexion #

Cette connexion fournit un service de collecte de données pour le 3CX plate-forme de communication. Il fournit une modélisation des données d'appel pour permettre l'utilisation de l'analyse des appels (tableaux de bord/tableaux de bord) sur les sites auto-hébergés 3CX installations.

Cette page explique comment installer le 3CX Service de collecteur à distance sur un 3CX PBX

Exigences #

Les exigences suivantes doivent être respectées pour pouvoir être déployés ~.Dimensions.~ sur un 3CX installation.

  • Auto-hébergé 3CX Exécution de la version 18.0 ou ultérieure1 sur Linux
  • Compte d'utilisateur d'administrateur dédié sur le 3CX système

Information Circle info

Complet 3CX Informations sur le support de la version de publication ici.

Le ~.Dimensions.~ 3CX collector fonctionnera sur le 3CX machine hôte pour collecter des données et les transmettre à la machine principale ~.Dimensions.~ solution infonuagique pour le stockage et l'analyse. Le collecteur utilise un minimum de ressources CPU, mais a un impact sur les besoins en mémoire pour le 3CX animateur.

Le tableau ci-dessous fournit un guide sur l'utilisation de la mémoire du collecteur.

Appels simultanés Utilisation prévue de la mémoire
4 - 32 ~ 350 Mo
48 - 64 ~ 600 Mo
96 - 128 ~ 750 Mo
192 - 256 ~ 900 Mo
512 - 1024 ~ 1024 Mo

Document note

Les besoins en mémoire sont affectés par le nombre d'appareils, les utilisateurs et le débit d'appels. Veuillez être prêt à déployer plus de mémoire si nécessaire.


  1. Vérifiez que vos versions sont prises en charge ici avant la mise à niveau. ↩︎

Installation #

Étape 1 - 3CX Configuration du compte d'utilisateur #

Veuillez créer un ' Propriétaire du système' (avec un mot de passe complexe) pour ~.Dimensions.~ sur le 3CX Exemple :

image.png

Ce compte est utilisé par le ~.Dimensions.~ Logiciel collecteur pour interroger les informations de configuration et de licence du 3CX c'est nécessaire pour modéliser correctement le trafic d'appels.

Color Wand tip

Assurez-vous que ' Activer 2FA' est invalide.

Color Wand tip

Les identifiants d'utilisateur de ce compte seront nécessaires à l'étape 2.

Étape 2 - ~.Dimensions.~ Création d'un compte client #

Dans le ~.Dimensions.~ revendeur, créez un nouveau PBX connexion, en entrant dans le 3CX Clé de licence et le nom d'utilisateur/ext et le mot de passe de l'étape précédente

image.png

Étape 3 - ~.Dimensions.~ 3CX Installation du collecteur #

Maintenant que le ~.Dimensions.~ Le compte client a été créé, le collecteur Dimensions peut être installé sur le compte du client 3CX exemple. Une fois installé, il se reconnectera automatiquement au ~.Dimensions.~ Le client utilise les informations de la clé de licence et commencera à modéliser l'activité des appels et des utilisateurs.

  • SSH dans le 3CX exemple.

  • Assurez-vous de commencer dans le dossier d'accueil de l'utilisateur

CD $home
  • Téléchargez le script d'installation à partir du site Web du client pour cette région (na, uk, eu ou au)
wget -O install.sh https://clients. {région}.myreports.cloud/3cx/install.sh

Information Circle info

Remplacez {region} par na (Amérique du Nord), etc; c1> fr</c1> (Royaume-Uni), etc; c2> eu</c2> (Union européenne) ou au (Australie/Nouvelle-Zélande), selon votre région.

Hand Left warning

Le -O remplace tout script existant dans ce dossier

  • Rendre le script exécutable
chmod +x ./install.sh
  • Exécutez le script fournissant le numéro de version que vous souhaitez installer, p. ex.
sudo ./install.sh dernier

Cela devrait montrer que le chemin d'installation n'a pas été trouvé et effectuer une installation propre à /opt/RemoteCollector.ThreeCx/

image.png

Le collecteur devrait maintenant être installé et devrait commencer à transmettre les informations d'appel et d'utilisateur au serveur pour activer les fonctions d'analyse.

Étape 4 - Personnalisations #

Si vous utilisez un port non standard sur votre 3CX système, vous devrez mettre à jour un système local ' settings.json' avec les détails exacts afin que le ~.Dimensions.~ 3CX Collector pour se connecter au 3CX système avec succès.

Modifiez le fichier suivant :

/opt/RemoteCollector.ThreeCx/settings.json

Modifiez les deux paramètres suivants :

 « AutoDetectHost » : false,
 « ThreeHostPort » : {CUSTOMVALUE}

Information Circle info

Le ' settings.json' est créé par le collecteur après son installation.

Un exemple de la version complète ' settings.json' Dossier :

{
  « PersistedSettings » : {
    « TenantId » : «  »,
    « LicenseKey » : «  »,
    « InstrumentationConnectionString » : «  »,
    « EnableAutoUpdate » : true,
    « AutoUpdateTime » : « 02:00:00 »,
    « AutoDetectHost » : false,
    « ThreeHostProtocol » : « https »,
    « ThreeHost » : « 127.0.0.1 »,
    « ThreeHostDisableSslValidation » : true,
    « ThreeHostPort » : 1234
}

Mise à niveau #

Automatiquement #

Du PBX Configuration du collecteur dans ~.Dimensions.~ Appuyez sur le bouton Mise à niveau bouton.

Manuellement #

Exécutez le script avec le nouveau numéro de version et il mettra automatiquement à jour le logiciel :

sudo ./install.sh 1.87.2

Le message devrait indiquer qu'une installation a été trouvée et qu'elle est en cours de mise à jour

image.png

Désinstaller #

Exécutez le script avec supprimer comme paramètre

sudo ./install.sh supprimer

Cela vous demandera si vous souhaitez retirer le connecteur

image.png

Presse Y Pour continuer, cela supprimera le service, tous les fichiers et journaux.

Installation d'une version spécifique #

Si le support vous le demande, vous devrez peut-être installer une version spécifique du collecteur (pour prendre en charge un ancien 3CX ou tester un correctif par exemple).

Pour installer une version spécifique, entrez la version spécifique plutôt que plus récent :

sudo ./install.sh 1.87.1
Hand Left warning
Ne le faites que si le soutien vous le demande.

Contrôle du service #

Arrêter le service

systemctl stop RemoteCollector.ThreeCx.service

Démarrer le service

systemctl start RemoteCollector.ThreeCx.service

Obtenez l'état du service

systemctl status RemoteCollector.ThreeCx.service

Voir les registres de service

Voir les journaux

journalctl -xeu RemoteCollector.ThreeCx.service

Suivez les journaux en direct :

journalctl -xefu RemoteCollector.ThreeCx.service

Registres #

Par défaut, les journaux sont installés pour

/opt/RemoteCollector.ThreeCx/logs

Ceux-ci sont compressés quotidiennement dans un dossier d'archives.

image.png

Les journaux peuvent être récupérés du client à l'aide du bouton-poussoir des journaux dans le menu Modifier PBX sur le portail des revendeurs :

image.png

Voir installé 3CX Version #

Pour afficher la version installée de 3CX lorsqu'il est connecté via SSH :

Politique apt-cache 3CXPBX

Cela retournera la version installée et la dernière version disponible.

image.png