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
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 |
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.
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 :
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.
tip
Assurez-vous que ' Activer 2FA' est invalide.
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
É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
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.
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/
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}
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 #
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
Désinstaller #
Exécutez le script avec supprimer comme paramètre
sudo ./install.sh supprimer
Cela vous demandera si vous souhaitez retirer le connecteur
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
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.
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 :
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.