> # 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.