IceWarp v11 et suivantes -

Les journaux (ou logs en anglais) sont un moyen essentiel pour identifier et corriger des problèmes de configuration du serveur.

Une description de l'ensemble des journaux est effectuée dans cette FAQ.

Ceci est en particulier vrai pour le serveur de voix sur IP (VoIP) pour lequel le journal est le seul moyen de bien comprendre ce qui se passe si une anomalie se produit au cours de l’établissement d'un appel téléphonique.

La VoIP sur IceWarp est construite autour du protocole SIP pour l'établissement et la libération des appels (avec le protocole SDP pour la description des medias utilisés) et du protocole RTP pour le transport de la voix.

Le protocole SIP peut s'appuyer sur le protocole UDP ou le protocole TCP (au choix du client SIP)
Le protocole RTP s'appuie toujours sur UDP

Ce document se propose donc d'expliquer :
1 - Comment sont activés et visualisés les journaux VoIP
2 - Quels journaux transmettre au support en cas de difficulté rencontrée sur des appels

Rappel : les journaux sont des fichiers texte qui sont en général placés dans le dossier "logs" qui est défini dans Système -> Stockage -> onglet Dossiers -> champ Journaux

1 - Comment activer et visualiser les journaux VoIP

Le journal VoIP

Ce journal du protocole SIP est activé dans Système -> Services -> onglet Général -> VoIP -> colonne Journal
Il est conseillé de le mettre en mode Étendu.

Il génère un fichier par jour consultable :
- Par la console d’administration dans Etat -> Journaux -> journal "VoIP"
- Sous Windows dans le répertoire logs des journaux, dans le sous répertoire sip, il y a un fichier par jour avec comme nom aaaammjj.log

Les appels VoIP

Chaque appel peut être (et doit être pour les besoins du support) enregistré dans une ligne d'un fichier texte.

Cette ligne se présente sous la forme (exemple) :
"2019-12-18 10:58:10 00:00:33 bertrand.mennesson@darnis.com echo@darnis.com 200 ANSWERED OUT 127.0.0.1:63790 fhqqlk3ted4267hqkggl echo@darnis.com B.men"
Elle contient : la date, l'appelant, l'appelé, le résultat de l'appel, sa direction, l'adresse du serveur, l'identifiant de l'appel et l'appelé.

Le fichier est configuré par la console dans VoIP -> Général -> "Enr. appels SIP dans un fichier"
On pourra mettre par exemple : "C:\Program Files\IceWarp\logs\sip\appelsVoIP.log"

Ce fichier est consultable par la console d’administration dans État -> Journaux -> journal "Appels VoIP"

Remarque : l'enregistrement de la voix n'est pas utile pour le support (champ "Enregistrer tous les appels à")

Les journaux des clients SIP

Le serveur contient des clients SIP qui peuvent être activés ou non et qui génèrent un journal si les journaux VoIP sont activés. Ces journaux sont consultables :
- Par la console d’administration dans Etat -> Journaux -> journal "Services VoIP", "Echo VoIP", "Voicemail VoIP", "IVR VoIP", "Réunions VoIP"
- Sous Windows dans le répertoire logs des journaux, dans les sous répertoires voip\root, voip\echo, voip\voicemail, voip\ivr, voip\conf. Il y a un fichier par jour avec comme nom aaaammjj.log.

Les clients SIP d'IceWarp sont des applets java qui dialoguent en SIP avec le serveur. Le journal peut être utile dans certains cas selon le service utilisé car il ne contient pas que les échanges SIP.

2 - Quels journaux transmettre au support en cas de difficulté rencontrée sur des appels

En cas de problème sur des appels, il faut envoyer au minimum :
- Le journal des Appels VoIP en indiquant de quels appels (au moins quelques exemples) il s'agit (vous pouvez l'identifier par l'heure, l'identité de l'appelant et celle de l'appelé)
- Le journal VoIP complet de la journée (à compresser).

Pour plus d'efficacité, il est préférable de n'envoyer le journal VoIP que pour le ou les appels posant problème, il faut pour cela filtrer le journal de la façon suivante :
- Identifier l'appel dans le journal des Appels VoIP
- Faire une copie de l'identifiant de l'appel : c'est l'avant dernier élément de la ligne. Dans l'exemple ci-dessus : fhqqlk3ted4267hqkggl
- Il faut coller ce numéro dans le champ filtre des journaux
- Il faut sélectionner le journal VoIP (en sélectionnant la date si ce n'est pas celle du jour)
- Le journal obtenu correspond aux échanges SIP uniquement pour cet appel, il est possible de l'exporter (Svg dans fichier...)
- Si une ligne de ce type apparaît :
"10:58:10:439 Outgoing Call Replace sip:echo@darnis.com fhqqlk3ted4267hqkggl -> 9be15711-7599-8537-fbaf-72e899a04ba8"
- C'est que le serveur a contacté l'appelé et il faut aussi enregistrer cette deuxième moitié de l'appel en mettant 9be15711-7599-8537-fbaf-72e899a04ba8 dans le filtre

Modifié le 18/12/2019