5-24 Oracle WebLogic SIP Server Container Administrators Guide
WebLogic Server SIP Container uses for selecting SIP requests and responses to place in the log file.
A typical pattern definition defines a condition for matching a particular value in a SIP message header. For example, the sample response-pattern.xml used by the
msgTraceLogger Servlet matches all MESSAGE requests. The contents of this descriptor are shown in
Example 5–3 Sample response-pattern.xml for msgTraceLogger Servlet
?xml version=1.0 encoding=UTF-8? DOCTYPE pattern
PUBLIC RegistrationOrganizationType LabelDefinition Language trace-pattern.dtd
pattern equal
varresponse.methodvar valueMESSAGEvalue
equal pattern
Additional operators and conditions for matching SIP messages are described in Section 5.7.6, trace-pattern.dtd Reference
. Most conditions, such as the equal condition shown in
Example 5–3 , require a variable var element that identifies the
portion of the SIP message to evaluate. Table 5–2
lists some common variables and sample values. For additional variable names and examples, see Section 16: Mapping
Requests to Servlets in the SIP Servlet API 1.1 specification http:jcp.orgenjsrdetail?id=289
; Oracle WebLogic Server SIP Container enables mapping of both request and response variables to logging Servlets.
Both request-pattern.xml and response-pattern.xml use the same Document Type Definition DTD. See
Section 5.7.6, trace-pattern.dtd Reference for
more information.
5.7.3.2 Using Servlet Parameters to Specify Logging Criteria
Pattern-matching criteria can also be specified as initialization parameters to the logging Servlet, rather than as separate XML documents. The parameter names used
to specify matching criteria are request-pattern-string and response-pattern-string. They are defined along with the logging level and
destination as described in
Section 5.7.2, Configuring the Logging Level and Destination
.
Note: By default Oracle WebLogic Server SIP Container logs both
requests and responses. If you do not want to log responses, you must define a response-pattern.xml file with empty matching criteria.
Table 5–6 Pattern-matching Variables and Sample Values
Variable Sample Values
request.method, response.method MESSAGE, INVITE, ACK, BYE, CANCEL
request.uri.user, response.uri.user guest, admin, joe
request.to.host, response.to.host server.mydomain.com
Monitoring and Troubleshooting 5-25
The value of each pattern-matching parameter must consist of a valid XML document that adheres to the DTD for standalone pattern definition documents see
Section 5.7.3.1, Using XML Documents to Specify Logging Criteria . Because the
XML documents that define the patterns and values must not be parsed as part of the sip.xml descriptor, you must enclose the contents within the CDATA tag.
Example 5–4 shows the full sip.xml entry for the sample logging Servlet,
invTraceLogger. The final two init-param elements specify that the Servlet log only INVITE request methods and OPTIONS response methods.
Example 5–4 Logging Criteria Specified as init-param Elements
servlet servlet-nameinvTraceLoggerservlet-name
servlet-classcom.bea.wcp.sip.engine.tracing.listener.TraceMessageListenerImpls ervlet-class
init-param param-namedomainparam-name
param-valuetrueparam-value init-param
init-param param-namelevelparam-name
param-valuefullparam-value init-param
init-param param-namerequest-pattern-stringparam-name
param-value [CDATA[
?xml version=1.0 encoding=UTF-8? DOCTYPE pattern
PUBLIC RegistrationOrganizationType LabelDefinition Language
trace-pattern.dtd pattern
equal varrequest.methodvar
valueINVITEvalue equal
pattern ]]
param-value init-param
init-param param-nameresponse-pattern-stringparam-name
param-value [CDATA[
?xml version=1.0 encoding=UTF-8? DOCTYPE pattern
PUBLIC RegistrationOrganizationType LabelDefinition Language
trace-pattern.dtd pattern
equal varresponse.methodvar
valueOPTIONSvalue equal
pattern ]]
param-value init-param
5-26 Oracle WebLogic SIP Server Container Administrators Guide
load-on-startup servlet
5.7.4 Specifying Content Types for Unencrypted Logging