Appels Teams, flux SIP et captures

À quoi cela sert

Lorsqu’un appel de Teams n’arrive pas, se termine trop tôt ou n’a pas d’audio, vous avez besoin du déroulement exact des événements. EasyUC propose quatre outils de profondeur croissante : la liste des appels en cours, l’historique des appels avec un diagramme en échelle SIP par appel, la trace SIP de l’ensemble du tenant et la capture réseau sous forme de fichier pcap.

L’historique des appels enregistre, pour chaque appel, tous les messages SIP entre Microsoft et le SBC EasyUC, sans les OPTIONS périodiques. Le diagramme en échelle les présente dans l’ordre chronologique avec des flèches. Vous voyez d’un coup d’œil qui a donné quelle réponse. Les clés de chiffrement audio sont masquées avant l’enregistrement.

La trace SIP enregistre en plus les OPTIONS et tout le reste du tenant. La capture réseau écrit les paquets eux-mêmes. Le segment vers Microsoft y est chiffré et illisible ; seul le segment interne entre le SBC et EasyUC est lisible.

Prérequis

Module de licence teams. Sans ce module, l’espace de travail EasyUC Teams n’apparaît pas.
Rôle EasyUC Teams (ROLE_APP_TEAMS_WORKSPACE) avec le sous-droit TENANTS (ROLE_APP_TEAMS_TENANTS). Pour activer, désactiver et supprimer, ajoutez TENANTS bearbeiten (ROLE_APP_TEAMS_TENANTS_EDIT).
Pour le flux SIP des appels passés : Save the SIP flow of every call était activé au moment de l’appel, et la durée de conservation n’est pas échue.
Pour la capture réseau : le service SBC fonctionne et se signale. Au plus deux captures réseau s’exécutent simultanément sur le SBC.
Un programme tel que Wireshark pour analyser un fichier pcap.

Pas à pas : examiner un appel dans l’historique des appels

Ouvrez Teams Tenants, cliquez sur le tenant et sélectionnez Call history dans la barre du tenant. La page s’ouvre filtrée sur ce tenant.
Restreignez la période avec Date from et Date to.
Sous Direction, choisissez inbound ou outbound.
Dans Search, saisissez le numéro, le numéro composé, le Call-ID ou l’UUID et confirmez avec le bouton en forme de loupe.
Cliquez sur la ligne de l’appel. La page SIP flow s’ouvre.
Lisez l’en-tête : Tenant, Direction, From, To, le cas échéant Pilot, State, Codec, Remote IP, Start, Duration et SIP Call-ID.
Lisez le diagramme en échelle de haut en bas. Microsoft est à gauche, le SBC EasyUC à droite. Les messages avec SDP portent le libellé SDP.
Cliquez sur un message pour voir son contenu. Les touches fléchées déplacent la sélection. Copy place le texte dans le presse-papiers.
Cliquez sur Download SIP flow (.txt) si vous souhaitez transmettre le déroulement.

Pas à pas : suivre les appels en cours

Sélectionnez Show calls dans la barre du tenant. Le nombre affiché sur l’élément de menu est le nombre d’appels en cours.
Pour chaque appel, lisez Direction, From, To, State, Codec, Remote, Duration et Call-ID.
Cliquez sur une ligne. Le flux SIP s’ouvre et s’actualise toutes les 2 secondes tant que l’appel est en cours.
S’il est écrit “No call running through this trunk right now.”, passez l’appel de test et patientez un instant.

Pas à pas : enregistrer une trace SIP du tenant

Dans l’en-tête de la page du tenant, cliquez sur Start SIP trace. L’avis SIP trace is running apparaît avec l’heure de fin. La trace se termine d’elle-même au bout de 30 minutes.
Passez l’appel de test.
Sélectionnez SIP log dans la barre du tenant.
Dans Filter, saisissez par exemple INVITE, un numéro ou un Call-ID.
Cliquez sur une entrée pour déployer le message complet.
Cliquez sur Download log pour un fichier texte ou sur Export pcap (TranslatorX/Wireshark) pour un fichier pcap. Si le filtre se limite à un Call-ID, le fichier pcap ne contient que cet appel.
Cliquez sur Stop SIP trace dans l’en-tête lorsque vous avez terminé. Clear supprime le journal du tenant.

Pas à pas : enregistrer une capture réseau (pcap)

Sélectionnez Captures dans la barre du tenant.
Sous Capture for, choisissez la durée : 5, 10, 15, 30 ou 60 minutes.
Sous At most, choisissez la taille du fichier : 50, 100, 200 ou 500 Mo.
Cochez Include the internal leg to EasyUC uniquement si vous avez besoin du SIP et de l’audio en clair. Lisez l’avertissement : le fichier contient alors les appels de tous les tenants de ce SBC.
Cliquez sur Start network capture et confirmez l’invite si elle apparaît.
Attendez Network capture is running et passez l’appel de test.
Cliquez sur Stop network capture ou attendez la fin.
Le fichier apparaît dans la liste dès que le SBC l’a transféré. Jusque-là, il affiche Being transferred.
Cliquez sur l’icône de téléchargement dans la ligne. L’icône de corbeille supprime le fichier.

Champs et options

Champs et options
Champ / action	Signification et utilisation
Last OPTIONS	Heure des derniers SIP OPTIONS reçus de Microsoft pour ce tenant. Affichée dans l’en-tête de la page du tenant.
To	Le numéro composé. Avec Operator Connect through Teams forwarding, il s’agit du numéro Operator Connect ; le numéro pilote est affiché en dessous, avec la mention « via pilot … ».
State	État de l’appel. Les appels en cours portent le libellé Live dans l’historique.
SIP messages	Nombre de messages SIP enregistrés pour cet appel. 0 signifie : le flux SIP était désactivé ou a déjà été supprimé.
Start SIP trace / Stop SIP trace	Écrit dans la base de données chaque message SIP de ce tenant, OPTIONS compris. Dure 30 minutes. Le journal conserve au plus les 20 000 messages les plus récents par tenant.
Start network capture / Stop network capture	Écrit dans un fichier pcap les ports SIP et RTP de ce tenant ainsi que les connexions TLS de tous les tenants vers Microsoft. Durée de 1 à 60 minutes, taille de 1 à 500 Mo, par défaut 15 minutes et 200 Mo.
Include the internal leg to EasyUC	Enregistre en plus le segment non chiffré entre le SBC et EasyUC. C’est la seule option qui rend le SIP et l’audio lisibles dans Wireshark.
Storage used	Stockage des enregistrements et captures de ce tenant, limité à 1 Go. À côté figure le stockage partagé de tous les tenants.
Capture list	Started, Finished, Duration, File size, Packets. Les captures sont supprimées automatiquement après 7 jours.
Call history : recherche et filtres	La recherche trouve l’appelant, la destination, le numéro composé, le Call-ID et l’UUID. S’y ajoutent Date from, Date to et Direction. Les appels les plus récents sont en haut.
Save the SIP flow of every call	Commutateur dans les paramètres du tenant, activé par défaut. Tous les messages SIP d’un appel entre Microsoft et le SBC sont enregistrés, sans les OPTIONS.
Keep call history (days)	De 1 à 365 jours, 14 par défaut. Les appels plus anciens et leurs messages SIP sont supprimés.
Diagramme en échelle : structure	À gauche l’heure avec les millisecondes, puis la voie Microsoft avec l’adresse du pair et, à droite, la voie EasyUC SBC. Une flèche vers la droite vient de Microsoft, une flèche vers la gauche va vers Microsoft. Les réponses portent le code et le texte, par exemple `200 OK`.
Download SIP flow (.txt)	Fichier texte contenant tous les messages de l’appel. Si le numéro composé diffère de la destination, le fichier indique les deux.
Non inclus	Le segment interne entre le SBC et l’exécution des scripts d’EasyUC n’est pas enregistré dans l’historique des appels. Utilisez pour cela la capture réseau avec le segment interne.
Clés	Les clés SRTP sont masquées avant l’enregistrement, dans l’historique des appels comme dans le journal SIP.

Vérifier le résultat et circonscrire les erreurs

Succès : l’appel de test figure dans l’historique des appels, et le diagramme en échelle affiche INVITE, 200 OK et BYE.
L’appel manque dans l’historique : Teams ne l’a pas envoyé par le trunk EasyUC. Vérifiez si la politique EasyUC est attribuée à l’appelant, si le numéro figure comme Reachable sous Scripts over this trunk et si Routes in Teams affiche Up to date.
“SIP flow recording is off for this tenant” Activez Save the SIP flow of every call dans les paramètres du tenant. Les appels qui commencent ensuite sont enregistrés.
“No SIP messages were stored for this call.” Le flux était désactivé pendant l’appel ou a été supprimé après la durée de conservation.
Pas d’audio ou audio dans un seul sens : vérifiez Public IP et Media IP sur la page SBC ainsi que la règle UDP pour la plage RTP. Des OPTIONS réussis ne prouvent que le chemin de signalisation.
L’appel se termine environ 10 secondes après le décroché, sans audio : l’exécution du script ne fournit pas d’audio au SBC. Vérifiez que le script est activé et que le service d’exécution des scripts fonctionne.
Teams signale immédiatement un échec d’appel vers un numéro de script : le script est inconnu, désactivé ou non Reachable via MS Teams, ou l’exécution du script ne répond pas.
“The SBC has not confirmed the network capture yet.” ou “Network capture not available: …” Le service SBC ne se signale pas ou le composant de capture ne fonctionne pas. Vérifiez le service dans EasyUC Manager.
„Es laufen bereits 2 Netzwerk-Mitschnitte auf anderen Tenants. Bitte einen davon beenden oder sein Ende abwarten.“ Arrêtez l’une des captures en cours.
“The SIP trace is off. Turn it on above to record what goes over this trunk.” Le journal SIP reste vide tant qu’aucune trace n’a été lancée.
Les captures contiennent des numéros de téléphone et, avec le segment interne, le contenu des appels. Ne les transmettez qu’au destinataire prévu.
Un appel en cours est considéré comme terminé lorsque le SBC ne l’a plus signalé depuis deux minutes. Jusque-là, il porte le libellé Live.
Avec Operator Connect through Teams forwarding, l’INVITE du diagramme en échelle montre l’en-tête History-Info avec le numéro Operator Connect. L’historique des appels enregistre donc aussi le nom de connexion du compte de service de renvoi. Il est soumis à la même durée de conservation.
Lisez le flux comme dans le chapitre sur le diagramme en échelle SIP : premier INVITE, dernière réponse à celui-ci, BYE. Une réponse rouge du SBC indique la raison du côté d’EasyUC, une réponse rouge de Microsoft la raison dans le tenant.