Serveur SIP : Configuration : Débogage de message

Options de configuration     

Utilisez cette page afin d'activer et de configurer la journalisation des accès pour WebLogic Communications Server.

Avertissement : cet élément ne doit être utilisé que dans un environnement de développement car la journalisation des accès consigne dans le journal toutes les demandes et réponses SIP. N'activez pas cette option sur un système de production.

Pour plus d'informations sur la configuration et l'utilisation de la journalisation des accès, reportez-vous à "Enabling Access Logging" dans le manuel de programmation. Pour effectuer une journalisation plus sélective dans un environnement de production, reportez-vous à "Logging SIP Requests and Responses" dans le manuel d'administration.

Options de configuration

Nom Description
Activer le débogage

Indique si le débogage des messages est activé.

Niveau de débogage

Collecte prédéfinie des informations à consigner dans le journal pour toutes les demandes et réponses SIP.

Les niveaux suivants sont pris en charge :

  • terse : consigne dans le journal uniquement le paramètre de domaine, le nom de servlet de journalisation, le niveau de journalisation, et indique s'il s'agit d'un message entrant.

  • basic : consigne dans le journal les éléments de type terse, ainsi que le statut des messages SIP, le motif, le type de réponse ou de demande, la méthode SIP, les en-têtes De et A.

  • full : consigne dans le journal les éléments de base, ainsi que tous les en-têtes de message SIP avec l'horodatage, le protocole, l'URI de demande, le type de demande et de réponse, le type de contenu et le contenu raw.

Attribut de MBean :
MessageDebugBean.Level

Modèle

Modèle utilisé pour formater une entrée de journal d'accès. Les entiers entre accolades font référence aux jetons définis ci-dessous

Le format est défini en indiquant des entiers, entre accolades ("{" et "}"). Chaque entier représente un jeton défini ultérieurement dans la définition de format.

Attribut de MBean :
FormatBean.Pattern

Jetons

Jetons de chaîne identifiant une partie du message SIP à inclure dans un enregistrement de journal. Placez plusieurs jetons sur des lignes différentes.

Pour obtenir la liste des types de jeton disponibles, reportez-vous à "Customizing Log Records" dans le manuel de programmation.

Attribut de MBean :
FormatBean.Tokens

Taille du fichier de rotation

Taille (entre 1 et 65 535 kilo-octets) déclenchant le déplacement des messages de journalisation vers un autre fichier par le serveur.

Lorsque le serveur vérifie la taille du fichier journal, si ce dernier a atteint la taille maximale définie, le serveur renomme le fichier journal en cours en FileName.logN et crée un autre fichier afin de stocker les messages suivants.

Remarque : pour ce paramètre, vous devez indiquer un déplacement de fichier de type 'bySize'.

Attribut de MBean :
MessageDebugBean.FileMinSize

Les modifications sont prises en compte une fois le module redéployé ou le serveur relancé.

Nom de fichier journal

Nom du fichier journal qui stocke les messages SIP.

Attribut de MBean :
MessageDebugBean.LogFilename

Les modifications sont prises en compte une fois le module redéployé ou le serveur relancé.

Journalisation activée

Indique si le serveur journalise les messages SIP dans un fichier journal indépendant.

Attribut de MBean :
MessageDebugBean.LoggingEnabled

Les modifications sont prises en compte une fois le module redéployé ou le serveur relancé.

Type de rotation

Définit les critères de déplacement des anciens messages de journalisation vers un autre fichier.

Attribut de MBean :
MessageDebugBean.RotationType

Limiter le nombre de fichiers conservés

Indique si le nombre de fichiers journaux créés par l'instance de serveur pour stocker les anciens messages doit être limité. (Exige que vous indiquiez le type de déplacement de fichier 'bySize' ou 'byTime'.)

Attribut de MBean :
MessageDebugBean.NumberOfFilesLimited

Fichiers à conserver

Nombre maximal de fichiers journaux créés par le serveur lorsqu'il change de journal. Cette valeur n'inclut pas le fichier utilisé par le serveur pour stocker les messages en cours (pour cela, vous devez activer l'option Limiter le nombre de fichiers conservés).

Attribut de MBean :
MessageDebugBean.FileCount

Changer de fichier journal au démarrage

Indique si un serveur change de fichier journal pendant son cycle de démarrage.

Attribut de MBean :
MessageDebugBean.RotateLogOnStartup

Répertoire de stockage des fichiers déplacés

Répertoire de stockage des fichiers journaux déplacés. Par défaut, ceux-ci se trouvent dans le répertoire du fichier journal.

Attribut de MBean :
MessageDebugBean.LogFileRotationDir

Heure de début de rotation

Détermine l'heure de début (heures et minutes) d'une séquence de rotation temporelle.

Remarque : pour ce paramètre, vous devez définir le type de rotation des journaux en heures et minutes ('hh:mm' ; par exemple, 07:30).

Attribut de MBean :
MessageDebugBean.RotationTime

Intervalle de rotation

Intervalle (en heures) auquel le serveur enregistre les anciens messages de journalisation dans un autre fichier.

Remarque : pour ce paramètre, vous devez définir le type de rotation des journaux en heures et minutes ('hh:mm' ; par exemple, 07:30).

Attribut de MBean :
MessageDebugBean.FileTimeSpan

Modèle de format de date

Modèle de format de date utilisé pour l'affichage des dates dans le fichier journal et la sortie stdout du serveur.

La chaîne DateFormatPattern est conforme à la spécification de la classe java.text.SimpleDateFormat.

Attribut de MBean :
MessageDebugBean.DateFormatPattern

Les modifications sont prises en compte une fois le module redéployé ou le serveur relancé.