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 un enregistrement pour voir tous les détails, 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
    • Emplacement de la tour cellulaire (lorsqu'il 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 l'attachement 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 l'attachement 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 localStorage 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)
    • La colonne triée est 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 par plage de dates : Filtrer par date et heure de début/fin (sélecteur de date)
    • Filtre spécifique au champ : Filtrer par valeur exacte du 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 d'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)
    • UUID des appels (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
  • 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
    • La colonne triée est mise en surbrillance en bleu

  4. Rechercher des enregistrements :

    • Entrez la requête de recherche dans la boîte "Rechercher"
    • Prend en charge des 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 les 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
    • La cause de raccrochage est 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%' dans tous les champs recherchables joints par OR
    • Exemple : 61480 correspond à "61480123456", "55561480999", etc.

  2. Correspondance exacte :

    • Syntaxe : "terme" (avec des guillemets doubles)
    • Correspond à : Enregistrements où n'importe quel champ est exactement égal au terme
    • SQL : Utilise = 'terme' dans 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%' dans 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' dans tous les champs recherchables joints par AND
    • Exemple : !"NORMAL_CLEARING" exclut les enregistrements où n'importe quel champ est exactement "NORMAL_CLEARING"

  5. Termes multiples 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 : field1 LIKE '%terme%' OR field2 LIKE '%terme%' OR ...

  Pour recherche inverse (!) :
    - Vérifiez si TOUS les champs ne contiennent/égale pas le terme → Inclure si VRAI
    - SQL : field1 NOT LIKE '%terme%' AND field2 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 dans tous les champsTous les enregistrements avec "61480" n'importe où (appelant, destination, UUID, etc.)
"911"Correspondance exacte dans 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 une inverse
  • Exclure les numéros de test : !test AND !demo - Recherches inverses multiples
  • Débogage complexe : 61480 AND !"ANSWER" AND !CANCEL - Contient un terme, exclut exact et partiels d'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 : Recherchez 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 les modèles de problèmes
  • Audit des appels d'urgence : Recherchez "911" pour vérifier le traitement des appels d'urgence
  • Support client : Recherchez des appels clients spécifiques par ID d'appelant ou destination
  • Analyse de modèles : Trier par durée ou horodatages pour identifier des anomalies
  • Conformité et conservation des dossiers : Filtres par plage de dates pour les rapports réglementaires
  • Analyse des appels échoués : Utilisez !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 les champs CDR qui sont affichés par défaut dans la vue en direct 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 dans 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 sélectionner manuellement des colonnes supplémentaires à partir du sélecteur de colonnes à tout moment

Cas d'utilisation :

  • Définir une vue par défaut claire avec uniquement 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 si 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 par plage de dates
  4. Utilisez des filtres spécifiques au 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 se concentrer sur les données pertinentes et améliorer les performances
  • Combiner les filtres : Utilisez la recherche + la plage de dates + le filtre de champ ensemble pour des requêtes précises
  • Performance de la plage de dates : Les plages de dates étroites renvoient des résultats plus rapidement pour les grandes bases de données
  • Trier pour l'analyse : Triez par durée pour trouver des appels longs/courts, ou par horodatage pour voir les 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 entre 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 multipartite 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
    • Total des 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 des conférences actives et de l'utilisation des ressources
  • Gestion de la capacité : Surveillez 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, les problèmes de connexion des participants
  • Contrôle de la conférence : Verrouillez les conférences pour la confidentialité, gérez la vidéo pour contrôler la bande passante
  • Conformité : Surveillez et enregistrez 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 du watchdog : Surveillance du watchdog Diameter

Visionneuse de journaux système​

Visionneuse de journaux unifiée 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 de TAS Backend et de 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/verbose (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 dans les messages de journal
  • Pause/Reprendre : Geler la diffusion des 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éfilante : Conteneur de hauteur fixe avec défilement automatique pour les derniers journaux

Comment utiliser​

  1. Affichage de base :

    • La page se charge avec les 500 dernières entrées de journal 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/plan de numérotation
    • 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 dans les messages de journal
    • Filtre en temps réel au fur et à mesure que vous tapez
    • Combine avec les filtres de source et de niveau

  5. Pause/Reprendre le flux :

    • Cliquez sur le bouton "Pause" (orange) pour geler les mises à jour des journaux
    • L'indicateur "PAUSÉ" apparaît dans l'en-tête
    • Examinez des entrées de journal spécifiques sans que de nouveaux journaux ne perturbent
    • 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 de 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 variable

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 Erreur/Critique pour trouver des problèmes
  • Analyse du flux d'appels : Recherchez 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 de 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 tests : Utilisez le niveau Débogage pour voir le comportement détaillé de l'application

Conseils​

  • Combiner les filtres : Utilisez Source + Niveau + Recherche ensemble pour un filtrage précis
    • Exemple : Source="TAS Backend" + Niveau="Erreur" + Recherche="Diameter" → Trouver des 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 judicieusement : Le niveau Débogage est verbeux - filtrez par source spécifique pour réduire le bruit
  • Scan de couleur : Scannez 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 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 le traitement 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 (les plus récents 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énement (ESI) écouteur de journal

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 :
    • Rechercher par MCC (Code de pays mobile)
    • Rechercher par MNC (Code de réseau mobile)
    • Rechercher par type de radio (GSM, UMTS, LTE)
    • Rechercher 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 depuis OpenCellID
    • Voir l'état et la progression de l'importation
  • Résolution de localisation : Résoudre les ID de cellule 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 d'appels réels.

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 les 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 (le cas échéant)
    • XML du 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 provision 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 le traitement 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éro 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 complet de session
  • Sélection de type d'événement : Tester à la fois le 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 complètes CCA (Credit-Control-Answer)

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 milieu 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 auto-généré pour la corrélation
    • Cliquez sur "Nouvel ID" pour générer un nouvel Call ID pour un nouveau test
    • Conservez 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...)
      • Requête finale : 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érifiez la connexion Diameter Ro et l'authentification
  • Logique de contrôle de crédit : Testez les scénarios d'allocation, de consommation et d'épuisement de crédit
  • Tests de flux de session : Simulez le cycle de vie complet de l'appel (INITIAL → UPDATE → TERMINATION)
  • Validation de tarification : Vérifiez les taux de facturation corrects pour différents plages de numéros
  • Tests de basculement : Testez la redondance OCS en ciblant un Destination-Host spécifique
  • Débogage d'intégration : Dépannez les problèmes d'intégration OCS avec inspection détaillée des AVP
  • Préparation aux tests de charge : Validez le comportement OCS avant les tests de charge
  • Contournement des numéros d'urgence : Vérifiez 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 milieu 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 les données de profil des abonnés 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és 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) : déclencheurs iFC pour les serveurs d'applications
    • 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é 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 profil XML de l'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érifiez l'état de l'utilisateur et l'attribution S-CSCF
  • Configuration de facturation : Vérifiez les adresses de fonction de facturation P
  • Tests de connectivité HSS : Validez la connexion Diameter Sh
  • Validation de profil : Assurez-vous que le profil de service correct est attribué
  • Tests d'intégration : Testez l'intégration HSS après des modifications de provisionnement
  • Analyse d'itinérance : Vérifiez 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 confirmer si un abonné est enregistré
  • InitialFilterCriteria (13) montre quels serveurs d'applications 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 de traduction de numéros et de formatage sans passer d'appels réels.

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

Vue de traduction de numéros

Fonctionnalités​

  • Traduction en temps réel : Auto-traduit au fur et à mesure que vous tapez
  • Prise en charge des codes de pays : Tester différents contextes de codes de pays
  • Connaissance 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 les 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 le résultat traduit immédiatement

  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érifiez que la conversion E.164 fonctionne correctement
  • Tests de codes de pays : Assurez-vous que le traitement des préfixes internationaux est correct
  • Détection des numéros d'urgence : Vérifiez 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 SIP trunk
  • 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 en tête, 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 dans 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 montre 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
    • Un 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
  • Epoch créé : Quand le message a été laissé (formaté automatiquement en date/heure lisible)
  • Epoch lu : Quand le message a été consulté (le cas échéant)
  • 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 des messages vocaux pour le dépannage
  • Tester la livraison de la 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 vérifiez 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 ne montrer que la portion 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 de messagerie vocale 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 synthèse vocale (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 des invites : 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éez 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 toutes : 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 des invites :

    • 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" si manquant
    • 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 avoir ajouté de nouvelles invites
    • Réenregistrer toutes : Régénère toutes les invites, peu importe leur existence
      • Utile après avoir changé de voix, de format ou d'instructions
      • Utilisez 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
    • Un lecteur audio apparaît en bas avec tous les contrôles
    • 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 les 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érifiez que les fichiers d'invite existent et sont accessibles
  • Gestion de l'espace de stockage : Vérifiez les tailles de fichier et gérez l'utilisation du disque

Conseils​

  • Utilisez "Générer les manquantes" pour la configuration initiale - cela ne remplacera pas les invites existantes
  • Utilisez "Réenregistrer toutes" après avoir changé de voix ou de format dans la configuration
  • Le "Réenregistrement" individuel est utile pour itérer sur des invites spécifiques
  • Écoutez les invites avant le déploiement pour garantir 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 de 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 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 coloré pour une lecture facile
    • Étiquettes en teal
    • Attributs en bleu clair
    • Valeurs en orange/tan
    • 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éfilant : Les grands modèles défilent dans un conteneur de 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 syntaxe
    • Cliquez à nouveau pour réduire

  3. Lire le contenu XML :

    • Étiquettes (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​

  • Revoir 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érifiez 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 des modèles existants lors de la création de nouveaux

Conseils​

  • Les modèles sont chargés à partir de priv/templates/ au sein de 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 : Par ordre alphabétique par nom de fichier
  • Mise en surbrillance de la syntaxe : Colorisation côté client utilisant des motifs regex
  • Hauteur d'affichage max : 600px avec défilement pour les grands fichiers

Exécuteur de commandes ESL​

Exécutez des commandes 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 de la commande en temps réel
  • Historique des commandes : Menu déroulant des commandes récentes (dernières 10 commandes)
  • Prêt pour l'auto-complétion : Saisie en monospace pour une entrée 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 de saisie
    • 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écédées de "ERREUR :"
    • La sortie est défilable avec une hauteur max de 600px
    • Police monospace pour des données alignées

  4. Utiliser l'historique des commandes :

    • Les commandes récentes apparaissent dans le menu déroulant après la première exécution
    • Sélectionnez dans le menu "Récent :" pour remplir le champ de saisie
    • 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 FreeSWITCH en cours d'exécution
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 d'un profil spécifiqueNombre 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 les modifications de configuration avec reloadxml
  • Actions d'urgence : Tuez les appels bloqués avec uuid_kill
  • Inspection des variables : Vérifiez les variables globales ou de canal

Dépannage​

Abonnés ne s'affichant pas​

  • Vérifiez qu'OmniTAS fonctionne
  • 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 n'apparaissant pas​

  • 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 périodiquement 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.