SIP-Server: Konfiguration: Nachrichten-Debugging

Konfigurationsoptionen     

Auf dieser Seite können Sie die Zugriffsprotokollierung für WebLogic Communications Server aktivieren und konfigurieren.

Warnung: Dieses Element sollte nur in einer Entwicklungsumgebung verwendet werden, da bei der Zugriffsprotokollierung alle SIP-Anforderungen und -Antworten protokolliert werden. Aktivieren Sie diese Option nicht für ein Produktionssystem.

Informationen zum Konfigurieren und Verwenden der Zugriffsprotokollierung finden Sie unter "Enabling Access Logging" im Programmierhandbuch. Informationen zu einer selektiveren Protokollierung in einer Production-Umgebung finden Sie unter "Logging SIP Requests and Responses" im Administrationshandbuch.

Konfigurationsoptionen

Name Beschreibung
Debugging aktivieren

Gibt an, ob das Debugging für Nachrichten aktiviert ist.

Debug-Ebene

Die vordefinierte Sammlung an Informationen, die für die einzelnen SIP-Anforderungen und -Antworten protokolliert werden soll.

Die folgenden Ebenen werden unterstützt:

  • terse: protokolliert nur Domaineinstellung, Servlet-Name, Logging-Ebene und ob es sich bei der Nachricht um eine eingehende Nachricht handelt.

  • basic: protokolliert die Elemente unter terse und zusätzlich den SIP-Nachrichtenstatus, den Grund, den Typ der Antwort oder der Anforderung, die SIP-Methode, den Header "Von" und den Header "An".

  • full: protokolliert die grundlegenden Elemente und zusätzlich alle SIP-Nachrichten-Header, den Zeitstempel, das Protokoll, den Anforderungs-URI, den Anforderungstyp, den Inhaltstyp und den RAW-Inhalt.

MBean-Attribut:
MessageDebugBean.Level

Muster

Das Muster, mit dem ein Zugriffs-Log-Eintrag formatiert wird. Ganzzahlen in eckigen Klammern beziehen sich auf die unten definierten Token.

Das Format wird definiert, indem Sie eine oder mehrere Ganzzahlen angeben, die in geschweifte Klammern, "{" und "}", eingeschlossen sind. Die einzelnen Ganzzahlen stehen für ein Token, das später in der Formatdefinition definiert wird.

MBean-Attribut:
FormatBean.Pattern

Token

Zeichenfolgentoken die einen Teil der SIP-Nachricht angeben, der in einen Log-Datensatz aufgenommen werden soll. Positionieren Sie mehrere Token in getrennten Zeilen.

Eine Liste der verfügbaren Tokentypen finden Sie unter "Customizing Log Records" im Programmierhandbuch.

MBean-Attribut:
FormatBean.Tokens

Rotationsdateigröße

Die Größe (1 - 65535 KB), ab der der Server Log-Meldungen in eine separate Datei verschiebt.

Wenn die Logdatei bei der Prüfung der Dateigröße die angegebene Mindestgröße erreicht hat, benennt der Server die aktuelle Logdatei in FileName.logN um und erstellt eine neue Datei, in der nachfolgende Nachrichten gespeichert werden.

Hinweis: Diese Einstellung setzt voraus, dass unter "Rotationstyp" der Wert "bySize" eingestellt ist.

MBean-Attribut:
MessageDebugBean.FileMinSize

Änderungen werden wirksam, nachdem Sie das Modul erneut bereitgestellt oder den Server neu gestartet haben.

Log-Dateiname

Der Name der Log-Datei, in der SIP-Nachrichten gespeichert werden.

MBean-Attribut:
MessageDebugBean.LogFilename

Änderungen werden wirksam, nachdem Sie das Modul erneut bereitgestellt oder den Server neu gestartet haben.

Logging aktiviert

Gibt an, ob der Server SIP-Nachrichten in eine unabhängige Log-Datei protokolliert.

MBean-Attribut:
MessageDebugBean.LoggingEnabled

Änderungen werden wirksam, nachdem Sie das Modul erneut bereitgestellt oder den Server neu gestartet haben.

Rotationstyp

Definiert die Kriterien zum Verschieben alter Log-Meldungen in eine separate Datei.

MBean-Attribut:
MessageDebugBean.RotationType

Anzahl der beizubehaltenden Dateien begrenzen

Gibt an, ob die Anzahl der Logdateien, die diese Serverinstanz zum Speichern alter Meldungen erstellt, begrenzt werden soll. (Hierfür müssen Sie den Dateirotationstyp "bySize" oder "byTime" festlegen.)

MBean-Attribut:
MessageDebugBean.NumberOfFilesLimited

Beizubehaltende Dateien

Die Höchstzahl von Logdateien, die vom Server erstellt werden, wenn er das Log rotiert. Diese Zahl enthält nicht die Datei, mit der der Server aktuelle Meldungen speichert. (Hierfür muss "Anzahl der beibehaltenen Dateien einschränken" aktiviert werden.)

MBean-Attribut:
MessageDebugBean.FileCount

Log-Datei beim Start rotieren

Gibt an, ob ein Server seine Log-Dateien beim Startzyklus rotiert.

MBean-Attribut:
MessageDebugBean.RotateLogOnStartup

Rotationsverzeichnis der Log-Datei

Das Verzeichnis, in dem die rotierten Log-Dateien gespeichert werden. Standardmäßig werden die rotierten Dateien in dem Verzeichnis gespeichert, in dem sich die Log-Datei befindet.

MBean-Attribut:
MessageDebugBean.LogFileRotationDir

Startrotationszeit

Bestimmt die Startzeit (Stunde und Minuten) für eine zeitbasierte Rotationsabfolge.

Hinweis: Bei dieser Einstellung müssen Sie einen Logrotationstyp in Stunden und Minuten festlegen ("hh:mm", Beispiel: 07:30).

MBean-Attribut:
MessageDebugBean.RotationTime

Rotationsintervall

Das Intervall (in Stunden), in dem der Server alte Log-Meldungen in einer anderen Datei speichert.

Hinweis: Bei dieser Einstellung müssen Sie einen Logrotationstyp in Stunden und Minuten festlegen ("hh:mm", Beispiel: 07:30).

MBean-Attribut:
MessageDebugBean.FileTimeSpan

Datumsformatmuster

Das Datumsformatmuster für die Wiedergabe von Datumsangaben in der Server-Log-Datei und stdout-Ausgabe

Die Zeichenfolge "DateFormatPattern" entspricht der Spezifikation der Klasse java.text.SimpleDateFormat.

MBean-Attribut:
MessageDebugBean.DateFormatPattern

Änderungen werden wirksam, nachdem Sie das Modul erneut bereitgestellt oder den Server neu gestartet haben.