Aller au contenu principal

Guide des opérations

📖 Retour à la documentation principale

Ce document couvre les fonctionnalités de surveillance et de gestion opérationnelles disponibles dans le panneau de contrôle.

Documentation connexe​

Documentation de base​

Outils de surveillance et de test​

Traitement des appels et services​

Interfaces d'intégration​

Opérations​

Cette section couvre les fonctionnalités de surveillance et de gestion opérationnelles disponibles dans le panneau de contrôle OmniTAS.

Table des matières​

Vue des abonnés​

La vue des abonnés fournit une surveillance en temps réel des enregistrements des abonnés IMS stockés dans la base de données d'enregistrement SIP Sofia.

Accès : Naviguez vers /subscribers dans le panneau de contrôle

Fonctionnalités​

  • Liste des enregistrements : Voir tous les enregistrements d'abonnés actifs
  • Détails de l'enregistrement : Cliquez sur n'importe quel enregistrement pour voir les détails complets, y compris :
    • Utilisateur SIP et domaine
    • URI de contact
    • État de l'enregistrement et expiration
    • Informations réseau (IP, port, nom d'hôte)
    • Détails d'authentification
    • Localisation de la tour cellulaire (lorsqu'elle est disponible via P-Access-Network-Info)
      • MCC/MNC, Type de radio, TAC/LAC, ID de cellule
      • Coordonnées géographiques et portée de couverture
      • Vue de carte interactive alimentée par les données OpenStreetMap et OpenCellID

Vue des abonnés

Détails de l'enregistrement

Source de données​

Les données d'enregistrement sont interrogées directement à partir de la base de données d'enregistrement Sofia, fournissant une visibilité en temps réel sur l'état de connexion des abonnés. Les emplacements des tours cellulaires sont résolus à l'aide de la base de données OpenCellID lorsque les abonnés fournissent des en-têtes P-Access-Network-Info dans leurs messages SIP REGISTER.

Cas d'utilisation​

  • Surveiller les enregistrements d'abonnés actifs
  • Vérifier l'état de connexion des abonnés
  • Dépanner les problèmes d'enregistrement
  • Auditer la connectivité des abonnés

Enregistrements de détails d'appels (CDR)​

La vue CDR fournit un accès aux enregistrements de détails d'appels stockés par TAS à des fins de facturation, de dépannage et d'analyse.

Accès : Naviguez vers /cdr dans le panneau de contrôle

Vue CDR

Fonctionnalités​

  • Vue paginée : Parcourez les enregistrements d'appels (100 par page avec contrôles Précédent/Suivant)
  • Recherche avancée : Recherche puissante avec prise en charge de la correspondance exacte, inverse/exclure et plusieurs termes
  • Sélection de colonnes : Personnalisez les champs à afficher
    • Cliquez sur le bouton "Colonnes" pour ouvrir la fenêtre de sélection des colonnes
    • Sélectionnez/désélectionnez des colonnes individuelles
    • Actions rapides Sélectionner tout / Désélectionner tout
    • La sélection persiste entre les sessions (enregistrée dans le stockage local du navigateur)
    • Affiche le compteur "X / Y colonnes"
  • Colonnes triables : Cliquez sur n'importe quel en-tête de colonne pour trier (ascendant/descendant)
    • Indicateurs visuels (▲ ascendant, ▼ descendant)
    • Colonne triée mise en surbrillance en bleu
    • Réinitialise à la page 1 lorsque le tri change
  • Options de filtre multiples :
    • Recherche textuelle : Recherchez dans tous les champs avec des opérateurs avancés
    • Filtre de plage de dates : Filtrer par date et heure de début/fin (sélecteur de date)
    • Filtre spécifique à un champ : Filtrer par valeur exacte de champ (cause de raccrochage, ID de l'appelant, destination, contexte)
    • Affichage des filtres actifs : Les puces visuelles montrent les filtres actuellement actifs
    • Tout effacer : Suppression en un clic de tous les filtres actifs
  • Informations détaillées : Cliquez sur n'importe quelle ligne CDR pour développer et voir tous les champs :
    • Parties de l'appel (nom/numéro de l'appelant, numéro de destination)
    • Horodatages (début, réponse, fin)
    • Durée et secondes facturées
    • Cause de raccrochage (codée par couleur : vert=normal, jaune=annulé, rouge=erreur)
    • UUIDs d'appel (A-leg et B-leg)
    • Contexte et code de compte
    • Tous les champs de base de données disponibles par ordre alphabétique
  • Causes de raccrochage codées par couleur :
    • 🟢 Vert : NORMAL_CLEARING
    • 🟡 Jaune : Appels annulés
    • 🔴 Rouge : Conditions d'erreur
  • Nombre total : Affichage en temps réel du nombre total d'enregistrements correspondants
  • Mise en page réactive : Les filtres se replient correctement sur les écrans plus petits

Comment utiliser​

  1. Affichage de base :

    • La page se charge avec les 100 derniers enregistrements CDR (triés par start_stamp descendant)
    • Le nombre total d'enregistrements est affiché en haut à droite
    • Utilisez les boutons Précédent / Suivant pour naviguer entre les pages
    • Cliquez sur n'importe quelle ligne pour développer et voir tous les champs

  2. Personnaliser les colonnes :

    • Cliquez sur le bouton "Colonnes" en haut à droite
    • La fenêtre modale affiche tous les champs disponibles
    • Cochez/décochez les champs pour afficher/masquer les colonnes
    • Utilisez "Sélectionner tout" ou "Désélectionner tout" pour une sélection rapide
    • Les paramètres sont automatiquement enregistrés dans le navigateur
    • Fermez la fenêtre modale pour appliquer les modifications

  3. Trier les données :

    • Cliquez sur n'importe quel en-tête de colonne pour trier par ce champ
    • Premier clic : Descendant (▼)
    • Deuxième clic : Ascendant (▲)
    • Troisième clic : Retour à descendant
    • Colonne triée mise en surbrillance en bleu

  4. Rechercher des enregistrements :

    • Entrez la requête de recherche dans la boîte "Rechercher"
    • Prend en charge les opérateurs avancés (voir la syntaxe de recherche ci-dessous)
    • Recherche dans plusieurs champs : caller_id_number, destination_number, uuid, caller_id_name, hangup_cause
    • Cliquez sur "Appliquer" pour exécuter la recherche

  5. Filtrer par plage de dates :

    • Utilisez les sélecteurs de date "Date de début" et "Date de fin"
    • Les deux dates sont requises pour le filtrage par date
    • Prend en charge la sélection de date et d'heure
    • Cliquez sur "Appliquer" pour filtrer

  6. Filtrer par champ spécifique :

    • Sélectionnez un champ dans le menu déroulant "Sélectionner le champ à filtrer" :
      • Cause de raccrochage
      • ID de l'appelant
      • Destination
      • Contexte
    • Entrez la valeur exacte dans "Entrer la valeur de filtre"
    • Cliquez sur "Appliquer" pour filtrer

  7. Combiner des filtres :

    • Tous les filtres peuvent être utilisés simultanément :
      • Recherche textuelle + Plage de dates + Filtre de champ fonctionnent tous ensemble
    • Les filtres actifs sont affichés sous forme de puces en dessous du formulaire de filtre
    • Cliquez sur "Tout effacer" pour supprimer tous les filtres en une seule fois

  8. Voir les détails :

    • Cliquez sur n'importe quelle ligne CDR pour développer
    • Affiche tous les champs de la base de données dans une mise en page en grille
    • Les champs sont affichés par ordre alphabétique
    • Cause de raccrochage codée par couleur pour une identification rapide
    • Cliquez à nouveau sur la ligne pour réduire

Syntaxe de recherche avancée​

La boîte de recherche prend en charge une syntaxe de requête puissante pour un filtrage précis des enregistrements à travers plusieurs champs simultanément.

Comment fonctionne la recherche :

Le moteur de recherche vérifie tous les champs recherchables dans chaque enregistrement CDR. Un enregistrement est inclus dans les résultats lorsqu'il correspond à vos critères de recherche dans n'importe lequel de ces champs :

  • caller_id_number
  • destination_number
  • uuid
  • caller_id_name
  • hangup_cause

Opérateurs de recherche (peuvent être combinés) :

  1. Recherche contenant (par défaut) :

    • Syntaxe : terme (sans guillemets)
    • Correspond à : Enregistrements où n'importe quel champ contient le terme n'importe où
    • SQL : Utilise LIKE '%terme%' à travers tous les champs recherchables joints par OR
    • Exemple : 61480 correspond à "61480123456", "55561480999", etc.

  2. Correspondance exacte :

    • Syntaxe : "terme" (avec guillemets doubles)
    • Correspond à : Enregistrements où n'importe quel champ est exactement égal au terme
    • SQL : Utilise = 'terme' à travers tous les champs recherchables joints par OR
    • Exemple : "911" correspond uniquement à "911", pas à "9115" ou "1911"

  3. Inverse/Exclure :

    • Syntaxe : !terme (préfixe point d'exclamation, sans guillemets)
    • Correspond à : Enregistrements où aucun champ ne contient le terme
    • SQL : Utilise NOT LIKE '%terme%' à travers tous les champs recherchables joints par AND
    • Exemple : !NORMAL exclut tout enregistrement contenant "NORMAL" dans n'importe quel champ

  4. Inverse exacte/Exclure :

    • Syntaxe : !"terme" (point d'exclamation + guillemets doubles)
    • Correspond à : Enregistrements où aucun champ n'est exactement égal au terme
    • SQL : Utilise != 'terme' à travers tous les champs recherchables joints par AND
    • Exemple : !"NORMAL_CLEARING" exclut les enregistrements où n'importe quel champ est exactement "NORMAL_CLEARING"

  5. Plusieurs termes avec AND :

    • Syntaxe : terme1 AND terme2 (AND insensible à la casse)
    • Correspond à : Enregistrements correspondant à tous les termes (chaque terme peut correspondre à différents champs)
    • Chaque terme est traité avec son propre opérateur (guillemets, !, etc.)
    • Les termes sont combinés avec AND dans SQL
    • Exemple : "911" AND "12345" trouve des enregistrements avec "911" dans un champ ET "12345" dans un autre

Logique d'exécution de recherche :

Pour chaque enregistrement CDR :
  Pour recherche normale (pas de !) :
    - Vérifiez si N'IMPORTE quel champ contient/égale le terme → Inclure si VRAI
    - SQL : champ1 LIKE '%terme%' OR champ2 LIKE '%terme%' OR ...

  Pour recherche inverse (!) :
    - Vérifiez si TOUS les champs ne contiennent/égales pas le terme → Inclure si VRAI
    - SQL : champ1 NOT LIKE '%terme%' AND champ2 NOT LIKE '%terme%' AND ...

  Pour recherches AND :
    - Chaque terme est évalué séparément
    - Toutes les conditions de terme doivent être VRAIES → Inclure si VRAI
    - SQL : (conditions_terme1) AND (conditions_terme2) AND ...

Exemples de recherche complexes :

RequêteComment ça fonctionneRésultat
61480Recherche contenant à travers tous les champsTous les enregistrements avec "61480" n'importe où (appelant, destination, UUID, etc.)
"911"Correspondance exacte à travers tous les champsEnregistrements où n'importe quel champ est exactement "911"
!NORMAL_CLEARINGRecherche inverse contenantExclut les enregistrements avec "NORMAL_CLEARING" dans N'IMPORTE quel champ (appels échoués)
!"NORMAL_CLEARING"Inverse exacteExclut les enregistrements où n'importe quel champ est exactement "NORMAL_CLEARING"
"911" AND "12345"Exact "911" ET exact "12345"Enregistrements avec les deux valeurs (par exemple, appelant="12345", destination="911")
!NORMAL AND 61480Inverse contenant "NORMAL" ET contenant "61480"Appels non normaux impliquant "61480"
!"ANSWER" AND !NORMALInverse exacte "ANSWER" ET inverse contenant "NORMAL"Exclure les appels répondus et tout ce qui contient "NORMAL"
61480 AND !NORMAL_CLEARINGContient "61480" ET inverse contenant "NORMAL_CLEARING"Appels échoués impliquant "61480"

Cas d'utilisation pratiques :

  • Trouver un numéro spécifique : 61480123456 - La recherche contenant trouve des correspondances partielles
  • Trouver des appels d'urgence exacts : "911" - Seulement des appels à exactement "911"
  • Tous les appels échoués : !NORMAL_CLEARING - Exclure les appels réussis
  • Appels échoués d'un appelant spécifique : "61480123456" AND !NORMAL - Combiner un appelant exact avec inverse
  • Exclure les numéros de test : !test AND !demo - Recherches inverses multiples
  • Débogage complexe : 61480 AND !"ANSWER" AND !CANCEL - Contient un terme, exclure exact et partiels autres

Source de données​

Les données CDR sont interrogées directement à partir de la base de données SQLite CDR de TAS.

Le schéma peut varier entre les déploiements en fonction des exigences spécifiques.

Options d'exportation CDR​

Important : Les enregistrements CDR peuvent être exportés dans divers formats pour prendre en charge l'intégration avec des systèmes de facturation, des plateformes d'analyse et des outils de reporting.

Le schéma de base de données CDR et les formats d'exportation sont spécifiques au déploiement. Lors de la configuration de votre système, veuillez demander les formats de sortie CDR spécifiques dont vous avez besoin à votre ingénieur d'intégration. Les formats d'exportation courants incluent :

  • CSV (valeurs séparées par des virgules)
  • JSON (pour l'intégration API)
  • XML
  • Accès direct à la base de données
  • Exportations au format personnalisé

Votre ingénieur d'intégration peut configurer des mécanismes d'exportation CDR adaptés à vos exigences opérationnelles et de facturation.

Cas d'utilisation​

  • Dépannage des appels : Rechercher des appels spécifiques par numéro ou UUID pour déboguer des problèmes
  • Rapprochement de facturation : Filtrer par plage de dates pour correspondre aux périodes de facturation
  • Analyse de qualité : Filtrer par cause de raccrochage pour identifier des modèles de problème
  • Audit des appels d'urgence : Rechercher "911" pour vérifier la gestion des appels d'urgence
  • Support client : Rechercher des appels clients spécifiques par ID d'appelant ou destination
  • Analyse de modèle : Trier par durée ou horodatages pour identifier des anomalies
  • Conformité et archivage : Filtres de plage de dates pour les rapports réglementaires
  • Analyse des appels échoués : Utiliser !NORMAL_CLEARING pour trouver tous les appels échoués
  • Rapports basés sur le contexte : Filtrer par contexte pour analyser des flux d'appels spécifiques

Configuration​

Colonnes visibles par défaut​

Vous pouvez configurer quels champs CDR sont affichés par défaut dans le LiveView en définissant cdrs_field_list dans votre config/runtime.exs :

config :tas,
  cdrs_field_list: [
    "caller_id_number",
    "destination_number",
    "start_stamp",
    "duration",
    "hangup_cause"
  ]

Comportement :

  • Si cdrs_field_list n'est pas défini : Tous les champs CDR disponibles sont affichés par défaut
  • Si cdrs_field_list est défini : Seuls les champs spécifiés sont affichés par défaut, mais tous les autres champs restent disponibles dans le sélecteur de colonnes
  • Si un champ de la liste n'existe pas dans les données CDR, il sera automatiquement ignoré
  • Les noms de champs peuvent être spécifiés sous forme de chaînes ou d'atomes
  • Les utilisateurs peuvent manuellement sélectionner des colonnes supplémentaires à partir du sélecteur de colonnes à tout moment

Cas d'utilisation :

  • Définir une vue par défaut claire avec seulement les champs essentiels visibles
  • Réduire la surcharge d'informations pour les nouveaux utilisateurs
  • Standardiser la mise en page des colonnes initiales pour tous les utilisateurs
  • Garder les champs avancés cachés par défaut mais toujours accessibles

Exemple de configuration :

# Afficher uniquement les informations d'appel essentielles par défaut
cdrs_field_list: [
  "start_stamp",
  "caller_id_number",
  "destination_number",
  "duration",
  "billsec",
  "hangup_cause"
]

Remarque : Cette configuration définit les colonnes visibles par défaut. Tous les champs CDR restent disponibles dans le sélecteur "Colonnes" - les utilisateurs peuvent manuellement afficher/masquer tout champ dont ils ont besoin.

Dépannage​

Aucun résultat trouvé​
  1. Vérifiez les fautes de frappe dans les termes de recherche
  2. Essayez de supprimer les guillemets pour une recherche plus large
  3. Vérifiez que le terme existe dans les champs recherchables
  4. Vérifiez que la plage de dates n'est pas trop restrictive
Trop de résultats​
  1. Ajoutez plus de termes AND pour affiner
  2. Utilisez la correspondance exacte avec des guillemets
  3. Appliquez des filtres de plage de dates
  4. Utilisez des filtres spécifiques à un champ
Résultats inattendus​
  1. Rappelez-vous que la recherche s'applique à TOUS les champs recherchables
  2. Vérifiez si le terme apparaît dans un champ inattendu (comme UUID)
  3. Utilisez la correspondance exacte pour éviter les correspondances partielles
  4. Vérifiez la logique inverse (AND vs OR)

Conseils​

  • Sélection de colonnes : Masquez les colonnes inutilisées pour vous concentrer sur les données pertinentes et améliorer les performances
  • Combiner des filtres : Utilisez recherche + plage de dates + filtre de champ ensemble pour des requêtes pr��cises
  • Performances de la plage de dates : Des plages de dates étroites renvoient des résultats plus rapidement pour de grandes bases de données
  • Trier pour analyse : Trier par durée pour trouver des appels longs/courts, ou par horodatage pour voir des modèles d'appels
  • Puces de filtre actives : Utilisez des puces visuelles pour vérifier quels filtres sont actuellement actifs
  • Paramètres persistants : Les sélections de colonnes sont enregistrées par navigateur, utiles pour différentes tâches d'analyse
  • Codage couleur : Scannez rapidement les causes de raccrochage - le vert est bon, le rouge nécessite une enquête
  • Détails extensibles : Cliquez sur les lignes pour voir tous les champs sans encombrer la vue principale
  • Opérateurs de recherche : Maîtrisez la syntaxe de recherche pour un filtrage puissant :
    • Utilisez des guillemets pour des correspondances exactes : "911"
    • Utilisez ! pour exclure : !NORMAL_CLEARING
    • Combinez avec AND : "61480" AND !NORMAL
  • Pagination : Rappelez-vous que les filtres persistent à travers les pages - utilisez la pagination pour examiner de grands ensembles de résultats

Surveillance des appels actifs​

La vue des appels actifs montre des informations en temps réel sur les appels en cours à travers le système.

Accès : Naviguez vers /calls dans le panneau de contrôle

Fonctionnalités​

  • État en temps réel : Vue en direct des sessions d'appels actifs
  • Détails de l'appel : Voir les variables de canal et les informations d'état de l'appel
  • Suivi UUID : Surveillez les identifiants d'appel A-leg et B-leg

Serveur de conférence IMS​

Le serveur de conférence IMS fournit des capacités de conférence multi-parties conformes aux normes IMS 3GPP (RFC 4579, RFC 4575, TS 24.147).

Accès : Naviguez vers /conference dans le panneau de contrôle

Documentation : Voir le Guide de l'utilisateur du serveur de conférence IMS pour une documentation détaillée

Fonctionnalités​

  • Surveillance en temps réel : Vue en direct des conférences actives et des participants
  • Tableau de bord des statistiques de conférence :
    • Nombre de conférences actives
    • Nombre total de participants dans toutes les conférences
    • Nombre de conférences vidéo
    • Nombre de conférences verrouillées
    • Détails de configuration du serveur (domaine, MNC/MCC, max participants)
  • Liste des conférences : Voir toutes les conférences actives avec :
    • ID de conférence et URI SIP
    • Nombre actuel de participants
    • Identité du créateur de la conférence
  • Détails de la conférence : Cliquez sur n'importe quelle conférence pour développer et voir :
    • Informations complètes sur la conférence (état, statut vidéo, statut verrouillé, statut d'enregistrement)
    • Liste complète des participants avec rôles et états
    • Statut vidéo des participants
  • Actions de contrôle de conférence :
    • Verrouiller/Déverrouiller les conférences pour contrôler l'accès
    • Activer/Désactiver la vidéo pour les conférences
    • Mises à jour de statut en temps réel avec retour d'action
  • Actualisation automatique : Actualisation automatique configurable (par défaut : 5 secondes) pour une surveillance en temps réel

Gestion de la console OmniTAS​

Toutes les opérations de conférence sont également disponibles via la console OmniTAS en utilisant la commande ims_conference :

ims_conference list                    # Lister toutes les conférences actives
ims_conference info <conf_id>          # Afficher les détails de la conférence
ims_conference stats                   # Afficher les statistiques du serveur
ims_conference lock <conf_id>          # Verrouiller une conférence
ims_conference unlock <conf_id>        # Déverrouiller une conférence
ims_conference video <conf_id> on|off  # Contrôler la vidéo
ims_conference record <conf_id> start|stop  # Contrôler l'enregistrement
ims_conference add <conf_id> <sip_uri>     # Ajouter un participant
ims_conference remove <conf_id> <uuid>     # Retirer un participant
ims_conference destroy <conf_id>       # Terminer la conférence

Cas d'utilisation​

  • Surveillance opérationnelle : Visibilité en temps réel sur les conférences actives et l'utilisation des ressources
  • Gestion de la capacité : Surveiller le nombre de participants et l'utilisation de la vidéo pour gérer la bande passante
  • Dépannage : Diagnostiquer les problèmes d'accès aux conférences, problèmes de connexion des participants
  • Contrôle de conférence : Verrouiller les conférences pour la confidentialité, gérer la vidéo pour contrôler la bande passante
  • Conformité : Surveiller et enregistrer les conférences pour la conformité réglementaire

Conformité 3GPP​

Le serveur de conférence met en œuvre des spécifications clés de conférence IMS 3GPP :

  • TS 24.147 : Conférence utilisant le sous-système de réseau central IM
  • RFC 4579 : Contrôle d'appel SIP - Conférence pour agents utilisateurs
  • RFC 4575 : Paquet d'événements SIP pour l'état de la conférence
  • RFC 5239 : Cadre pour la conférence centralisée

État de la passerelle​

Surveillez l'état et la santé des passerelles/tron��ons SIP connectés au TAS.

Accès : Naviguez vers /gw dans le panneau de contrôle

Fonctionnalités​

  • État d'enregistrement : Voir l'état d'enregistrement de la passerelle
  • Statistiques d'appels : Suivre les appels entrants/sortants et les échecs
  • Surveillance de ping : Temps de ping SIP OPTIONS et accessibilité
  • Détails de la passerelle : Informations complètes de configuration et d'état

Métriques surveillées​

  • État d'enregistrement SIP
  • Temps de ping (temps de réponse moyen SIP OPTIONS)
  • Temps de fonctionnement (secondes depuis le redémarrage du profil)
  • Appels entrants / Appels sortants
  • Appels échoués entrants / Appels échoués sortants
  • Dernier temps de ping et fréquence

État des pairs Diameter​

Surveillez la connectivité des pairs Diameter pour les interfaces Sh et Ro.

Accès : Naviguez vers /diameter dans le panneau de contrôle

Fonctionnalités​

  • État des pairs : État de connexion pour chaque pair configuré
  • Support d'application : Voir les applications Diameter prises en charge (Sh, Ro)
  • État de surveillance : Surveillance du watchdog Diameter

Visualiseur de journaux système​

Visualiseur de journaux unifié en temps réel pour les journaux TAS Backend (Elixir) et TAS Call Processing (FreeSWITCH).

Accès : Naviguez vers /logs dans le panneau de contrôle

Vue des journaux

Fonctionnalités​

  • Flux de journaux unifié : Voir les journaux à partir de TAS Backend et Call Processing dans une seule interface
  • Mises à jour en temps réel : Diffusion en direct des messages de journal au fur et à mesure qu'ils se produisent (actualisation automatique toutes les 1 seconde)
  • Niveaux de journal codés par couleur :
    • 🟣 Console - Messages de console (violet/magenta)
    • 🔴 Alerte/Critique - Problèmes urgents nécessitant une attention immédiate (rouge)
    • 🟠 Erreur - Conditions d'erreur (rouge clair)
    • 🟡 Avertissement - Messages d'avertissement (jaune)
    • 🔵 Avis - Messages d'information notables (cyan)
    • 🔵 Info - Messages d'information généraux (bleu)
    • ⚪ Débogage - Journalisation de débogage/verbeuse (gris)
  • Badges de source :
    • 🔵 TAS Backend - Journaux de l'application Elixir (badge bleu)
    • 🟣 TAS Call Processing - Journaux FreeSWITCH (badge violet)
  • Indicateurs de bord gauche : Bord gauche codé par couleur correspondant au niveau de journal pour un balayage visuel rapide
  • Filtres multiples :
    • Filtre de source : Toutes les sources / TAS Backend / TAS Call Processing
    • Filtre de niveau : Tous / Console / Alerte / Critique / Erreur / Avertissement / Avis / Info / Débogage
    • Recherche textuelle : Recherche de mots-clés en temps réel à travers les messages de journal
  • Pause/Reprise : Geler la diffusion de journaux pour analyser des entrées spécifiques sans perdre le contexte
  • Effacer les journaux : Supprimer toutes les entrées de journal actuelles de l'affichage
  • Compteur de journaux : Affiche les journaux filtrés par rapport aux journaux totaux (par exemple, "Affichage de 150 sur 500 journaux")
  • Comportement de tail : Maintient les 500 dernières entrées de journal pour des performances
  • Affichage des métadonnées : Nom de fichier et numéro de ligne pour les références de code source (lorsqu'elles sont disponibles)
  • Vue défilable : Conteneur à hauteur fixe avec défilement automatique pour les derniers journaux

Comment utiliser​

  1. Affichage de base :

    • La page se charge avec les 500 derniers enregistrements de journaux des deux sources
    • Les journaux apparaissent en temps réel au fur et à mesure qu'ils sont générés
    • Les journaux les plus récents apparaissent en haut
    • Actualisation automatique toutes les 1 seconde

  2. Filtrer par source :

    • Sélectionnez dans le menu déroulant "Source" :
      • Toutes les sources - Afficher les journaux de TAS Backend et de Call Processing
      • TAS Backend - Seulement les journaux de l'application Elixir
      • TAS Call Processing - Seulement les journaux FreeSWITCH/dialplan
    • Le filtre s'applique immédiatement

  3. Filtrer par niveau de journal :

    • Sélectionnez dans le menu déroulant "Niveau" :
      • Tous - Afficher tous les niveaux de journal
      • Console à Débogage - Afficher uniquement ce niveau spécifique
    • Utile pour se concentrer sur les erreurs ou déboguer des problèmes spécifiques

  4. Rechercher des mots-clés :

    • Tapez dans la boîte "Rechercher des journaux..."
    • Recherche insensible à la casse à travers les messages de journal
    • Filtre en temps réel au fur et à mesure que vous tapez
    • Combine avec des filtres de source et de niveau

  5. Pause/Reprise du flux :

    • Cliquez sur le bouton "Pause" (orange) pour geler les mises à jour de journaux
    • L'indicateur "PAUSÉ" apparaît dans l'en-tête
    • Examinez des entrées de journal spécifiques sans que de nouveaux journaux n'interrompent
    • Cliquez sur le bouton "Reprendre" (vert) pour redémarrer la diffusion en direct

  6. Effacer les journaux :

    • Cliquez sur le bouton "Effacer" (rouge) pour supprimer tous les journaux affichés
    • Efface les journaux de TAS Backend et de Call Processing
    • De nouveaux journaux apparaîtront au fur et à mesure qu'ils sont générés

  7. Lire les entrées de journal :

    • Horodatage : Affiche l'heure au format HH:MM:SS.milliseconds
    • Badge de source : Indique TAS Backend (bleu) ou Call Processing (violet)
    • Niveau de journal : Niveau codé par couleur entre crochets [ERREUR], [INFO], etc.
    • Fichier/Ligne : Emplacement du code source (lorsqu'il est disponible)
    • Message : Le contenu réel du message de journal

Niveaux de journal expliqués​

NiveauCouleurQuand utiliséExemple
ConsoleVioletMessages spécifiques à la consoleSortie de console FreeSWITCH haute priorité
AlerteRougeAction immédiate requiseÉchec d'un composant système
CritiqueRougeConditions critiquesConnexion à la base de données perdue
ErreurRouge clairConditions d'erreurÉchec du traitement de l'appel, configuration invalide
AvertissementJauneConditions d'avertissementFonction obsolète utilisée, tentative de réessai
AvisCyanÉvénements normaux notablesConfiguration rechargée, service démarré
InfoBleuMessages d'informationAppel connecté, requête Diameter envoyée
DébogageGrisMessages de niveau débogageEntrée/sortie de fonction, valeurs de variables

Cas d'utilisation​

  • Dépannage en temps réel : Surveillez les journaux pendant un appel actif pour déboguer des problèmes
  • Investigation d'erreurs : Filtrer par niveaux d'erreur/critique pour trouver des problèmes
  • Analyse du flux d'appels : Rechercher Call-ID ou numéro de téléphone pour tracer le chemin d'appel
  • Surveillance des performances : Surveillez les avertissements et les erreurs pendant les tests de charge
  • Débogage d'intégration : Filtrer TAS Backend pour voir les messages Diameter/Sh/Ro
  • Débogage du plan de numérotation : Filtrer TAS Call Processing pour voir le routage des appels FreeSWITCH
  • Surveillance de la santé du système : Gardez les journaux ouverts pour surveiller les anomalies
  • Développement et test : Utilisez le niveau de débogage pour voir le comportement détaillé de l'application

Conseils​

  • Combiner des filtres : Utilisez Source + Niveau + Recherche ensemble pour un filtrage précis
    • Exemple : Source="TAS Backend" + Niveau="Erreur" + Recherche="Diameter" → Trouver les erreurs Diameter
  • Pause avant de rechercher : Mettez le flux en pause avant de taper la requête de recherche pour éviter que les journaux ne défilent
  • Utiliser le débogage avec prudence : Le niveau de débogage est verbeux - filtrez par source spécifique pour réduire le bruit
  • Scan par couleur : Balayez rapidement les bords gauche - les bords rouges indiquent des problèmes
  • Badges de source : Badges bleus (Backend) pour la logique d'application, Badges violets (Call Processing) pour les appels
  • Précision des horodatages : Les horodatages en millisecondes aident à corréler les événements à travers les systèmes
  • Références de fichiers : Cliquez/notez les références de fichier:ligne pour sauter au code source
  • Effacer régulièrement : Effacez les journaux lors du changement de contexte d'investigation pour plus de clarté
  • Rechercher des UUID : Recherchez Call-ID/UUID pour suivre un appel spécifique à travers tout le système
  • Recherche d'urgence : Recherchez "911" ou "urgence" pour trouver rapidement la gestion des appels d'urgence

Détails techniques​

  • Limite de journal : Maximum de 500 journaux affichés (les plus anciens sont supprimés lorsque la limite est atteinte)
  • Taux de rafraîchissement : Actualisation automatique toutes les 1000 ms (1 seconde)
  • Recherche : Correspondance de sous-chaîne insensible à la casse sur le champ message uniquement
  • Filtrage vide : Filtre automatiquement les messages de journal vides/placeholder
  • Détection de source : Journaux étiquetés avec :elixir ou :freeswitch source
  • Tri : Journaux triés par horodatage descendant (le plus récent en premier)
  • PubSub : Journaux Elixir livrés via Phoenix PubSub pour des mises à jour en temps réel
  • Journaux FreeSWITCH : Collectés via l'interface de socket d'événements (ESI) écouteur de journaux

Base de données des tours cellulaires​

Gérez et interrogez la base de données de localisation des tours cellulaires OpenCellID pour les services d'urgence et les fonctionnalités basées sur la localisation.

Accès : Naviguez vers /cell_towers dans le panneau de contrôle

Base de données des tours cellulaires

Fonctionnalités​

  • Statistiques de base de données : Voir le nombre total d'enregistrements, la couverture par pays/réseau
  • Recherche et requête :
    • Recherche par MCC (Code de pays mobile)
    • Recherche par MNC (Code de réseau mobile)
    • Recherche par type de radio (GSM, UMTS, LTE)
    • Recherche par chaîne de localisation
  • Gestion de la base de données :
    • Importer des données de tours cellulaires
    • Télécharger à nouveau le dernier ensemble de données à partir d'OpenCellID
    • Voir l'état et la progression de l'importation
  • Résolution de localisation : Résoudre les ID de cellules en coordonnées géographiques

Cas d'utilisation​

  • Détermination de la localisation des appels d'urgence
  • Suivi de la localisation des abonnés (avec consentement)
  • Analyse de la couverture réseau
  • Dépannage des problèmes de localisation en itinérance
  • Maintenance de la base de données des tours cellulaires

Source de données​

Les données des tours cellulaires proviennent d'OpenCellID (https://opencellid.org/), un projet communautaire collaboratif visant à créer une base de données gratuite des emplacements des tours cellulaires dans le monde entier.

Simulateur d'appels​

Outil de simulation d'appels interactif pour tester la logique du plan de numérotation sans passer de véritables appels.

Accès : Naviguez vers /simulator dans le panneau de contrôle

Documentation détaillée : Voir le Guide HLR et Simulateur d'appels

Fonctionnalités​

  • Simuler des types d'appels : Tester des appels MO, MT et d'urgence
  • Paramètres configurables :
    • Numéros source et destination
    • Adresse IP source (pour simuler SBC/CSCF)
    • Forcer une disposition d'appel spécifique
    • Ignorer l'autorisation OCS pour des tests plus rapides
  • Résultats complets :
    • Sortie complète des variables du plan de numérotation
    • Résultats de recherche Sh/HLR
    • Résultat d'autorisation OCS
    • Résultats de requête SS7 MAP (si applicable)
    • XML de plan de numérotation généré
  • Traitement étape par étape : Voir chaque étape du traitement de l'appel

Cas d'utilisation​

  • Tester les modifications du plan de numérotation avant le déploiement
  • Vérifier la provisionnement des abonnés
  • Déboguer les problèmes de routage des appels
  • Former le personnel sur le flux d'appels
  • Valider l'intégration OCS/HLR
  • Tester la gestion des appels d'urgence

Tests HLR/MAP​

Tester les opérations SS7 MAP, y compris les requêtes Send Routing Info (SRI) et Provide Roaming Number (PRN).

Accès : Naviguez vers /hlr dans le panneau de contrôle

Documentation détaillée : Voir le Guide HLR et Simulateur d'appels

Fonctionnalités​

  • Requête SRI : Tester Send Routing Info pour le routage des appels
  • Requête PRN : Tester Provide Roaming Number pour les abonnés en itinérance
  • Résultats réels : Requêtes réelles au passerelle MAP configurée
  • Affichage des réponses : Voir MSRN, adresse MSC et statut de transfert
  • Gestion des erreurs : Affichage clair des erreurs MAP et des délais d'attente

Cas d'utilisation​

  • Vérifier la connectivité HLR
  • Tester l'allocation de numéros en itinérance
  • Déboguer le routage des appels vers les abonnés en itinérance
  • Valider la configuration de la passerelle MAP
  • Dépanner les problèmes de renvoi d'appels

Tests OCS​

Tester les opérations de Credit-Control-Request (CCR) Diameter Ro (Online Charging) directement contre votre OCS.

Accès : Naviguez vers /ocs_test dans le panneau de contrôle

Vue de test OCS

Fonctionnalités​

  • Types de CCR flexibles : Envoyer des requêtes INITIAL, UPDATE, TERMINATION ou EVENT
  • Simulation de session : Réutiliser le même Call ID pour simuler un cycle de vie de session complet
  • Sélection du type d'événement : Tester à la fois le chargement SMS (basé sur l'événement) et l'appel (basé sur la session)
  • Contrôle de direction : Tester à la fois les scénarios sortants (MO) et entrants (MT)
  • Paramètres optionnels : Spécifier Destination-Host et Username pour des tests avancés
  • Résultats en temps réel : Voir les réponses CCA (Credit-Control-Answer) complètes

Comment utiliser​

  1. Entrer les paramètres de test :

    • MSISDN appelé : Le numéro de destination (par exemple, 61400123456)
    • MSISDN appelant : Le numéro d'origine (par exemple, 61400987654)
    • Type d'événement : Choisissez sms ou call
      • SMS par défaut à EVENT_REQUEST (type 4)
      • Appel par défaut à INITIAL_REQUEST (type 1)
    • Direction : out pour MO ou in pour MT

  2. Configurer le type de CCR :

    • Request-Type : Sélectionnez le type de CCR :
      • 1 — INITIAL_REQUEST - Démarrer une nouvelle session
      • 2 — UPDATE_REQUEST - Réautorisation en cours de session
      • 3 — TERMINATION_REQUEST - Terminer la session et signaler l'utilisation
      • 4 — EVENT_REQUEST - Événement unique (SMS, événement immédiat)
    • Request-Number : Commence à 1, incrémentez pour chaque requête dans la même session

  3. Tests de session :

    • Call ID : Identifiant unique généré automatiquement pour la corrélation
    • Cliquez sur "Nouvel ID" pour générer un nouvel Call ID pour un nouveau test
    • Gardez le même Call ID pour simuler une session complète :
      • Première requête : INITIAL_REQUEST (type 1, numéro 1)
      • En milieu de session : UPDATE_REQUEST (type 2, numéro 2, 3, 4...)
      • Dernière requête : TERMINATION_REQUEST (type 3, numéro N+1)

  4. Options avancées :

    • Destination-Host : Cibler un nœud OCS spécifique (optionnel)
    • Username : Remplacer l'identifiant de l'abonné (optionnel)

  5. Exécuter et examiner :

    • Cliquez sur "Exécuter CCR" pour envoyer la requête
    • Voir la réponse CCA complète avec tous les AVP
    • Vérifiez le code de résultat, les unités accordées et le temps de validité
    • L'horodatage de la dernière exécution est affiché dans le coin supérieur droit

Cas d'utilisation​

  • Tests de connectivité OCS : Vérifier la connexion Diameter Ro et l'authentification
  • Logique de contrôle de crédit : Tester les scénarios d'allocation, de consommation et d'épuisement de crédit
  • Tests de flux de session : Simuler le cycle de vie complet d'un appel (INITIAL → UPDATE → TERMINATION)
  • Validation de tarification : Vérifier les taux de facturation corrects pour différentes plages de numéros
  • Tests de basculement : Tester la redondance OCS en ciblant un Destination-Host spécifique
  • Débogage d'intégration : Dépanner les problèmes d'intégration OCS avec inspection détaillée des AVP
  • Préparation aux tests de charge : Valider le comportement de l'OCS avant les tests de charge
  • Contournement des numéros d'urgence : Vérifier que les numéros d'urgence contournent correctement la facturation

Conseils​

  • Utilisez le même Call ID avec des Request-Numbers incrémentés pour tester la continuité de session
  • Surveillez les journaux OCS simultanément pour corréler les requêtes de test
  • Testez les requêtes UPDATE pour vérifier la logique de réautorisation en cours de session
  • Vérifiez que les requêtes TERMINATION ferment correctement les sessions et empêchent les fuites
  • Testez l'épuisement de crédit en envoyant des requêtes UPDATE après avoir consommé des unités accordées

Tests de l'interface Sh​

Tester les opérations User-Data-Request (UDR) Diameter Sh pour récupérer des données de profil d'abonné depuis le HSS.

Accès : Naviguez vers /sh_test dans le panneau de contrôle

Vue de test Sh

Fonctionnalités​

  • Références de données multiples : Interroger plus de 20 types de données d'abonné différents
  • Requêtes HSS réelles : Requêtes Diameter Sh en direct vers votre HSS configuré
  • Affichage complet des réponses : Voir les données XML complètes de l'abonné et les AVP
  • Suivi de session : Affiche le nom d'hôte HSS, le domaine et l'ID de session
  • Gestion des erreurs : Affichage clair des codes de résultat Diameter et des conditions d'erreur

Comment utiliser​

  1. Entrer l'identité publique :

    • Identité publique : L'identité publique IMS de l'abonné
    • Format : sip:61400123456@ims.mncXXX.mccXXX.3gppnetwork.org
    • Peut également utiliser le format tel:+61400123456

  2. Sélectionner la référence de données : Choisissez le type de données d'abonné à récupérer :

    • RepositoryData (0) : Profil complet de l'abonné
    • IMSPublicIdentity (10) : Liste des identités publiques
    • IMSUserState (11) : État d'enregistrement
    • S-CSCFName (12) : S-CSCF assigné
    • InitialFilterCriteria (13) : iFC déclencheurs pour les serveurs d'application
    • LocationInformation (14) : Localisation actuelle
    • ChargingInformation (16) : Adresses P-Charging
    • MSISDN (17) : Numéro de téléphone
    • IMSI (32) : Identité d'abonné mobile internationale
    • IMSPrivateUserIdentity (33) : Identité d'utilisateur privée
    • Et bien d'autres...

  3. Exécuter et examiner :

    • Cliquez sur "Fetch SH Data" pour envoyer la requête UDR
    • Voir la réponse complète User-Data-Answer (UDA)
    • Vérifiez le XML de profil d'abonné, les données de service et les règles iFC
    • Les métadonnées de session montrent quel HSS a répondu

Cas d'utilisation​

  • Vérification des abonnés : Confirmer que l'abonné est provisionné dans le HSS
  • Débogage iFC : Examiner les critères de filtre initiaux et les points de déclenchement
  • Dépannage d'enregistrement : Vérifier l'état de l'utilisateur et l'assignation S-CSCF
  • Configuration de facturation : Vérifier les adresses de fonction de facturation P
  • Tests de connectivité HSS : Valider la connexion Diameter Sh
  • Validation de profil : Assurer que le profil de service correct est assigné
  • Tests d'intégration : Tester l'intégration HSS après des modifications de provisionnement
  • Analyse d'itinérance : Vérifier les informations de localisation et le réseau de service

Conseils​

  • Utilisez IMSPublicIdentity (10) pour voir tous les alias d'un abonné
  • Utilisez RepositoryData (0) pour obtenir le profil complet de l'abonné en une seule requête
  • Vérifiez IMSUserState (11) pour vérifier si un abonné est enregistré
  • InitialFilterCriteria (13) montre quels serveurs d'application seront déclenchés
  • L'ID de session peut être utilisé pour corréler les requêtes dans les journaux HSS
  • Les réponses d'erreur incluent des codes de résultat Diameter (par exemple, 5001 = Utilisateur inconnu)

Tests de traduction de numéros​

Tester les règles et le formatage de traduction de numéros sans passer de véritables appels.

Accès : Naviguez vers /translate dans le panneau de contrôle

Vue de traduction de numéros

Fonctionnalités​

  • Traduction en temps réel : Traduction automatique au fur et à mesure que vous tapez
  • Support de code de pays : Tester différents contextes de code de pays
  • Conscient de la disposition : Appliquer différentes règles en fonction de la disposition de l'appel
  • Résultats en direct : Retour immédiat avec le numéro traduit
  • Informations de débogage : Voir les valeurs de retour brutes pour le dépannage

Comment utiliser​

  1. Configurer les paramètres :

    • Code de pays : Le contexte de numérotation (par exemple, AU, US, NZ)
      • Par défaut au code de pays configuré dans config/runtime.exs
      • Accepte les formats : AU, :AU, au
    • Numéro de téléphone : Le numéro à traduire
      • Exemples : +61400111222, 0400111222, 61400111222
    • Disposition : (Optionnel) Contexte d'appel pour des règles conditionnelles
      • Exemples : originate, route, emergency

  2. Tester la traduction :

    • Entrez des valeurs dans le formulaire
    • La traduction s'exécute automatiquement au fur et à mesure que vous tapez
    • Ou cliquez sur "Traduire" pour déclencher manuellement
    • Voir immédiatement le résultat traduit

  3. Examiner les résultats :

    • Traduit : Affiche le numéro de sortie formaté
    • Erreur : Affiche les erreurs de validation ou les échecs de traduction
    • Valeur de retour brute (débogage) : Affiche le tuple Elixir complet pour le débogage

Cas d'utilisation​

  • Développement de plan de numérotation : Tester les règles de formatage des numéros avant le déploiement
  • Validation de format : Vérifier que la conversion E.164 fonctionne correctement
  • Tests de code de pays : Assurer une gestion correcte des préfixes internationaux
  • Détection de numéros d'urgence : Vérifier que les numéros d'urgence sont correctement identifiés
  • Gestion des codes courts : Tester les codes de service spéciaux (messagerie vocale, etc.)
  • Préparation des tronçons : Formater correctement les numéros pour les exigences de tronçon SIP
  • Logique de disposition : Tester différentes règles pour les scénarios MO vs MT
  • Débogage des problèmes de traduction : Dépanner pourquoi des numéros spécifiques échouent au routage

Conseils​

  • Testez à la fois le format local (0400111222) et le format international (+61400111222)
  • Vérifiez que les numéros d'urgence (000, 112) sont détectés correctement
  • Utilisez le champ de disposition pour tester différentes scénarios d'appel (MO, MT, urgence)
  • Vérifiez que les codes courts et les numéros internes sont traités de manière appropriée
  • La sortie de débogage montre la valeur de retour brute - utile pour enquêter sur les problèmes
  • Testez les cas limites comme les zéros initiaux, les préfixes internationaux et les caractères spéciaux

Gestion de la messagerie vocale​

Gérez et écoutez les messages vocaux stockés dans le système.

Accès : Naviguez vers /voicemail dans le panneau de contrôle

Vue de messagerie vocale

Fonctionnalités​

  • Liste complète des messages vocaux : Voir tous les messages vocaux à travers toutes les boîtes aux lettres
  • Lecture dans le navigateur : Écoutez les enregistrements de messagerie vocale directement dans l'interface web
  • Détails des messages : Voir le nom d'utilisateur, UUID, horodatages, chemins de fichiers et métadonnées
  • Fonctionnalité de suppression : Supprimer des messages vocaux individuels
  • Actualisation automatique : Bouton d'actualisation pour recharger les dernières données de messagerie vocale
  • Colonnes dynamiques : Affiche automatiquement tous les champs de base de données disponibles

Comment utiliser​

  1. Voir la liste des messages vocaux :

    • La page se charge automatiquement avec tous les enregistrements de messagerie vocale
    • Le tableau affiche tous les champs de la base de données de messagerie vocale
    • Les horodatages sont automatiquement formatés à partir des valeurs epoch
    • Les chemins de fichiers sont raccourcis pour une meilleure lisibilité

  2. Écouter les messages :

    • Cliquez sur le bouton "▶ Jouer" à côté de n'importe quel message vocal
    • Le lecteur audio apparaît avec des contrôles (lecture, pause, recherche, volume)
    • Prend en charge les formats WAV, MP3 et OGG
    • Cliquez sur "Arrêter" pour fermer le lecteur audio

  3. Supprimer des messages :

    • Cliquez sur le bouton "Supprimer" pour retirer un message vocal
    • Une invite de confirmation empêche la suppression accidentelle
    • La page se rafraîchit automatiquement après une suppression réussie

  4. Actualiser les données :

    • Cliquez sur le bouton "Actualiser" en haut à droite pour recharger la liste des messages vocaux
    • Utile après que de nouveaux messages vocaux aient été laissés

Détails des messages affichés​

Le tableau affiche dynamiquement tous les champs disponibles, typiquement y compris :

  • Nom d'utilisateur : Propriétaire de la boîte aux lettres
  • UUID : Identifiant unique du message
  • Créé Epoch : Quand le message a été laissé (formaté automatiquement en date/heure lisible)
  • Lu Epoch : Quand le message a été consulté (si applicable)
  • Chemin de fichier : Emplacement du fichier audio
  • Métadonnées supplémentaires de la base de données de messagerie vocale

Cas d'utilisation​

  • Support des abonnés : Écoutez les messages vocaux pour le dépannage
  • Tester la livraison de messagerie vocale : Vérifiez que les messages vocaux sont stockés correctement
  • Gestion des messages : Nettoyez les anciens messages vocaux ou de test
  • Dépannage des problèmes d'enregistrement : Vérifiez les chemins de fichiers et assurez-vous que les fichiers audio existent
  • Maintenance de la boîte aux lettres : Surveillez le stockage et l'utilisation de la messagerie vocale
  • Assurance qualité : Examinez les messages enregistrés pour la qualité audio

Conseils​

  • Les chemins de fichiers sont automatiquement raccourcis pour montrer uniquement la partie pertinente
  • Les horodatages epoch sont automatiquement convertis en format lisible par l'homme
  • Une base de données de messagerie vocale vide affiche "Aucun enregistrement vocal trouvé"
  • La lecture audio utilise l'élément audio HTML5 - pris en charge dans tous les navigateurs modernes
  • La confirmation de suppression empêche la suppression accidentelle de messages importants

Gestion des invites TTS​

Gérez les invites audio générées par Text-to-Speech (TTS) utilisées dans tout le système.

Accès : Naviguez vers /prompts dans le panneau de contrôle

Vue des invites

Fonctionnalités​

  • Affichage des paramètres d'invite : Voir la voix TTS actuelle, le format de réponse et les instructions
  • État d'enregistrement : Voir quelles invites existent et lesquelles manquent
  • Détails des fichiers : Voir la taille du fichier, l'heure de modification et le chemin pour chaque invite
  • Lecture dans le navigateur : Écoutez les invites directement dans l'interface web
  • Générer les manquantes : Créer automatiquement tous les fichiers d'invite manquants
  • Réenregistrer individuellement : Régénérer une invite spécifique avec des paramètres mis à jour
  • Réenregistrer tout : Régénérer toutes les invites (utile après avoir changé de voix ou de paramètres)

Comment utiliser​

  1. Examiner les paramètres d'invite :

    • Voix : Voix TTS utilisée (par exemple, alloy, nova, shimmer)
    • Format de réponse : Format audio (par exemple, wav, mp3, opus)
    • Instructions : Instructions spéciales passées au moteur TTS

  2. Vérifier l'état d'enregistrement :

    • Texte : Le texte de l'invite à prononcer
    • Chemin relatif : Où le fichier audio est stocké
    • Existe : Vert "Oui" si le fichier existe, Jaune "Non" s'il manque
    • Taille : Taille du fichier en octets/KiB/MiB
    • Modifié : Horodatage de la dernière modification

  3. Générer des invites :

    • Générer les manquantes : Crée uniquement les invites qui n'existent pas encore
      • Utile pour la configuration initiale ou après l'ajout de nouvelles invites
    • Réenregistrer tout : Régénère toutes les invites, peu importe leur existence
      • Utile après avoir changé de voix, de format ou d'instructions
      • À utiliser avec prudence car cela régénère tout

  4. Gérer les invites individuelles :

    • ▶ Jouer : Écoutez l'invite (uniquement activé si le fichier existe)
    • 🔄 Réenregistrer : Régénérer juste cette invite
      • Utile si une invite sonne incorrectement
      • Utilise la voix et les paramètres actuels

  5. Écouter les invites :

    • Cliquez sur "▶ Jouer" pour entendre l'invite
    • Le lecteur audio apparaît en bas avec des contrôles complets
    • Cliquez sur "Arrêter" pour fermer le lecteur

Configuration des invites​

Les invites sont configurées dans votre configuration d'application :

config :tas, :prompts,
  voice: "nova",
  response_format: "wav",
  instructions: "Parlez clairement et professionnellement.",
  recordings: [
    %{path: "/sounds/en/us/callie/voicemail/vm-enter_id.wav",
      text: "Veuillez entrer votre ID de boîte aux lettres suivi de la touche dièse"},
    # ... plus d'invites
  ]

Cas d'utilisation​

  • Configuration initiale : Générer toutes les invites après l'installation du système
  • Changements de voix : Réenregistrer toutes les invites avec une voix TTS différente
  • Amélioration de la qualité : Corriger les invites individuelles qui ne sonnent pas bien
  • Mises à jour de format : Régénérer des invites dans un format audio différent (wav → mp3)
  • Mises à jour de texte : Réenregistrer après avoir changé le texte de l'invite dans la configuration
  • Tester TTS : Prévisualiser comment les invites sonneront avant le déploiement
  • Dépannage de la lecture : Vérifier que les fichiers d'invite existent et sont accessibles
  • Gestion de l'espace de stockage : Vérifier les tailles de fichiers et gérer l'utilisation du disque

Conseils​

  • Utilisez "Générer les manquantes" pour la configuration initiale - cela n'écrasera pas les invites existantes
  • Utilisez "Réenregistrer tout" après avoir changé de voix ou de format dans la configuration
  • "Réenregistrer" individuel est utile pour itérer sur des invites spécifiques
  • Écoutez les invites avant le déploiement pour assurer la qualité
  • Les formats de réponse plus grands (wav) ont une meilleure qualité mais utilisent plus d'espace disque
  • Le champ d'instructions peut guider le moteur TTS pour le ton et le rythme
  • La réenregistrement peut prendre du temps si vous avez de nombreuses invites - soyez patient
  • Les invites sont stockées dans le répertoire des sons FreeSWITCH pour un accès facile

Modèles XML de plan de numérotation​

Voir et inspecter les modèles XML de plan de numérotation FreeSWITCH utilisés pour le routage des appels.

Accès : Naviguez vers /routing dans le panneau de contrôle

Modèles de plan de numérotation

Fonctionnalités​

  • Liste des modèles : Voir tous les modèles XML à partir du répertoire priv/templates/
  • Détails des fichiers : Voir le nom de fichier et l'horodatage de dernière modification pour chaque modèle
  • Mise en surbrillance de la syntaxe : Affichage XML codé par couleur pour une lecture facile
    • Les balises en teal
    • Les attributs en bleu clair
    • Les valeurs en orange/tan
    • Les commentaires en vert
  • Vue extensible : Cliquez sur n'importe quel modèle pour voir son contenu XML complet
  • Vue en lecture seule : Inspection sécurisée sans risque de modification accidentelle
  • Contenu défilable : Les grands modèles défilent dans un conteneur à hauteur fixe (max 600px)

Comment utiliser​

  1. Voir la liste des modèles :

    • La page se charge avec tous les fichiers .xml du répertoire des modèles
    • Triés par ordre alphabétique par nom de fichier
    • Affiche l'horodatage de modification pour chaque fichier

  2. Inspecter le modèle :

    • Cliquez sur n'importe quelle ligne pour développer et voir le contenu XML
    • Le modèle s'affiche avec une mise en surbrillance de la syntaxe
    • Cliquez à nouveau pour réduire

  3. Lire le contenu XML :

    • Balises (teal) : Noms des éléments XML comme <extension>, <condition>
    • Attributs (bleu clair) : Noms d'attributs comme name=, field=
    • Valeurs (orange) : Valeurs d'attributs comme "public", "destination_number"
    • Commentaires (vert) : Commentaires XML <!-- ... -->

Cas d'utilisation​

  • Réviser la logique du plan de numérotation : Inspecter les règles de routage et les modèles de flux d'appels
  • Dépanner le routage des appels : Comprendre quels modèles sont utilisés pour différents types d'appels
  • Vérifier la syntaxe des modèles : Vérifier la structure XML avant le déploiement
  • Formation et documentation : Partager le contenu des modèles avec les membres de l'équipe
  • Audit des modifications : Comparer les horodatages de modification pour suivre les mises à jour
  • Développement de modèles : Référencer les modèles existants lors de la création de nouveaux

Conseils​

  • Les modèles sont chargés à partir de priv/templates/ dans l'application TAS
  • Seuls les fichiers .xml sont affichés
  • Les modèles sont en lecture seule via l'interface web
  • Les horodatages de modification aident à identifier les changements récents
  • Utilisez cette vue pour vérifier que les modèles correspondent à vos attentes de plan de numérotation
  • La mise en surbrillance de la syntaxe rend le XML complexe plus facile à analyser visuellement
  • Combinez avec la vue /logs pour corréler le comportement de routage avec les modèles

Détails techniques​

  • Emplacement : Modèles stockés dans le répertoire priv/templates/
  • Format : Format XML de plan de numérotation FreeSWITCH
  • Extension de fichier : Seuls les fichiers .xml sont listés
  • Tri : Ordre alphabétique par nom de fichier
  • Mise en surbrillance de la syntaxe : Colorisation côté client utilisant des motifs regex
  • Hauteur d'affichage maximale : 600px avec défilement pour les fichiers volumineux

Exécuteur de commandes ESL​

Exécutez des commandes de FreeSWITCH Event Socket Layer (ESL) directement depuis l'interface web.

Accès : Naviguez vers /command dans le panneau de contrôle

Exécuteur de commandes ESL

Fonctionnalités​

  • Exécution de commandes : Exécutez n'importe quelle commande API ESL/FreeSWITCH
  • Sortie en direct : Voir les résultats des commandes en temps réel
  • Historique des commandes : Liste déroulante des commandes récentes (dernières 10 commandes)
  • Prêt pour l'auto-complétion : Entrée en monospace pour une saisie précise des commandes
  • Gestion des erreurs : Affichage clair des erreurs et exceptions de commande
  • Pas d'auto-exécution : La sélection de l'historique remplit l'entrée mais nécessite un clic explicite sur "Exécuter"

Comment utiliser​

  1. Entrer la commande :

    • Tapez la commande ESL dans la boîte d'entrée
    • Exemples :
      • status - Afficher l'état de FreeSWITCH
      • show channels - Lister les appels actifs
      • uuid_dump <uuid> - Dump toutes les variables pour un appel
      • sofia status - Afficher l'état du profil SIP
      • reloadxml - Recharger le plan de numérotation XML
      • version - Afficher la version de FreeSWITCH

  2. Exécuter la commande :

    • Cliquez sur le bouton "Exécuter" pour exécuter
    • Le bouton affiche "En cours d'exécution…" pendant l'exécution
    • Ne peut pas exécuter plusieurs commandes simultanément

  3. Voir la sortie :

    • Les résultats apparaissent dans la section "Sortie" ci-dessous
    • Les commandes réussies affichent la réponse brute
    • Les erreurs sont préfixées par "ERREUR :"
    • La sortie est défilable avec une hauteur maximale de 600px
    • Police monospace pour des données alignées

  4. Utiliser l'historique des commandes :

    • Les commandes récentes apparaissent dans la liste déroulante après la première exécution
    • Sélectionnez dans le menu déroulant "Récent :" pour remplir le champ d'entrée
    • L'historique maintient les 10 dernières commandes uniques
    • La commande la plus récente en haut
    • La sélection de l'historique ne s'exécute PAS automatiquement (fonction de sécurité)

Commandes courantes​

CommandeDescriptionSortie d'exemple
statusÉtat du système et temps de fonctionnementInformations sur le fonctionnement de FreeSWITCH
show channelsLister tous les appels actifsListe des canaux ou "0 total"
show callsRésumé des appels actifsRésumé du nombre d'appels
uuid_dump <uuid>Toutes les variables pour un appelDump complet des variables
uuid_kill <uuid>Raccrocher un appel spécifique"+OK" ou erreur
sofia statusÉtat du profil SIPListe des profils et états
sofia status profile <name>Détails spécifiques au profilNombre d'enregistrements, etc.
reloadxmlRecharger le plan de numérotation XMLConfirmation "+OK"
versionInformations sur la version de FreeSWITCHChaîne de version
global_getvar <var>Obtenir une variable globaleValeur de la variable
api helpLister les commandes disponiblesRéférence de commande

Cas d'utilisation​

  • Débogage des appels : Obtenez des informations détaillées sur un appel actif avec uuid_dump
  • État du système : Vérifiez la santé de FreeSWITCH avec status et show calls
  • Dépannage SIP : Inspectez les profils SIP avec sofia status
  • Rechargement du plan de numérotation : Appliquez des modifications de configuration avec reloadxml
  • Actions d'urgence : Tuez des appels bloqués avec uuid_kill
  • Inspection des variables : Vérifiez les variables globales ou de canal

Dépannage​

Abonnés non affichés​

  • Vérifiez qu'OmniTAS est en cours d'exécution
  • Vérifiez que le profil Sofia est actif : sofia status profile internal
  • Vérifiez que le chemin de la base de données dans la configuration correspond à l'emplacement réel de la base de données

Enregistrements CDR non apparaissant​

  • Confirmez que le module CDR d'OmniTAS est chargé
  • Vérifiez que la base de données CDR existe au chemin configuré
  • Vérifiez la configuration du module CDR dans OmniTAS

Considérations de performance​

  • Les grandes bases de données CDR (>1M enregistrements) peuvent nécessiter un indexage supplémentaire pour des performances optimales
  • Envisagez d'archiver régulièrement les anciens enregistrements CDR
  • Les requêtes d'enregistrement des abonnés sont généralement rapides car la base de données d'enregistrement est petite

Configuration​

Contrôle d'accès​

Le panneau de contrôle doit être déployé derrière des contrôles d'accès appropriés (pare-feu, VPN, authentification) car il fournit une visibilité sur l'activité des abonnés et les enregistrements d'appels.

Dernière mise à jour le