Enabling Log Rotation and Viewing Log Files trace-pattern.dtd Reference

5-26 Oracle WebLogic SIP Server Container Administrators Guide load-on-startup servlet

5.7.4 Specifying Content Types for Unencrypted Logging

By default Oracle WebLogic Server SIP Container uses String format UTF-8 encoding to log the content of SIP messages having a text or applicationsdp Content-Type value. For all other Content-Type values, Oracle WebLogic Server SIP Container attempts to log the message content using the character set specified in the charset parameter of the message, if one is specified. If no charset parameter is specified, or if the charset value is invalid or unsupported, Oracle WebLogic Server SIP Container uses Base-64 encoding to encrypt the message content before logging the message. If you want to avoid encrypting the content of messages under these circumstances, specify a list of String-representable Content-Type values using the string-rep element in sipserver.xml. The string-rep element can contain one or more content-type elements to match. If a logged message matches one of the configured content-type elements, Oracle WebLogic Server SIP Container logs the content in String format using UTF-8 encoding, regardless of whether or not a charset parameter is included. Example 5–5 shows a sample message-debug configuration that logs String content for three additional Content-Type values, in addition to text and applicationsdp content. Example 5–5 Logging String Content for Additional Content Types message-debug levelfulllevel string-rep content-typeapplicationmsml+xmlcontent-type content-typeapplicationmedia_control+xmlcontent-type content-typeapplicationmedia_controlcontent-type string-rep message-debug

5.7.5 Enabling Log Rotation and Viewing Log Files

The Oracle WebLogic Server SIP Container logging infrastructure enables you to automatically write to a new log file when the existing log file reaches a specified size. You can also view log contents using the Administration Console or configure additional server-level events that are written to the log.

5.7.6 trace-pattern.dtd Reference

trace-pattern.dtd defines the required contents of the request-pattern.xml and response-pattern.xml, documents, as well as the values for the request-pattern-string and response-pattern-string Servlet init-param variables. Note: You do not need to specify text or applicationsdp content types as these are logged in String format by default. Monitoring and Troubleshooting 5-27 Example 5–6 trace-pattern.dtd -- The different types of conditions supported. - ENTITY condition and | or | not | equal | contains | exists | subdomain-of -- A pattern is a condition: a predicate over the set of SIP requests. - ELEMENT pattern condition; -- An and condition is true if and only if all its constituent conditions are true. - ELEMENT and condition;+ -- An or condition is true if at least one of its constituent conditions is true. - ELEMENT or condition;+ -- Negates the value of the contained condition. - ELEMENT not condition; -- True if the value of the variable equals the specified literal value. - ELEMENT equal var, value -- True if the value of the variable contains the specified literal value. - ELEMENT contains var, value -- True if the specified variable exists. - ELEMENT exists var -- - ELEMENT subdomain-of var, value -- Specifies a variable. Example: varrequest.uri.uservar 5-28 Oracle WebLogic SIP Server Container Administrators Guide - ELEMENT var PCDATA -- Specifies a literal string value that is used to specify rules. - ELEMENT value PCDATA -- Specifies whether the equal test is case sensitive or not. - ATTLIST equal ignore-case true|false false -- Specifies whether the contains test is case sensitive or not. - ATTLIST contains ignore-case true|false false -- The ID mechanism is to allow tools to easily make tool-specific references to the elements of the deployment descriptor. This allows tools that produce additional deployment information i.e information beyond the standard deployment descriptor information to store the non-standard information in a separate file, and easily refer from these tools-specific files to the information in the standard sip-app deployment descriptor. - ATTLIST pattern id ID IMPLIED ATTLIST and id ID IMPLIED ATTLIST or id ID IMPLIED ATTLIST not id ID IMPLIED ATTLIST equal id ID IMPLIED ATTLIST contains id ID IMPLIED ATTLIST exists id ID IMPLIED ATTLIST subdomain-of id ID IMPLIED ATTLIST var id ID IMPLIED ATTLIST value id ID IMPLIED

5.7.7 Adding Tracing Functionality to SIP Servlet Code