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