Data Collection and Logging Watches and Notifications

Monitoring and Troubleshooting 5-17 WebLogic Server instance and its applications. Oracle WebLogic Server SIP Container version integrates with several components of the WLDF in order to monitor and diagnose the operation of engine and SIP data tier nodes, as well as deployed SIP Servlets: ■ Data Collectors—Oracle WebLogic Server SIP Container integrates with the Harvester service to collect information from runtime MBeans, and with the Logger service to archive SIP requests and responses. ■ Watches and Notifications—Administrators can use the Watches and Notifications component to create complex rules, based on Oracle WebLogic Server SIP Container runtime MBean attributes, that trigger automatic notifications using JMS, JMX, SNMP, SMTP, and so forth. ■ Image Capture—Oracle WebLogic Server SIP Container instances can collect certain diagnostic data and write the data to an image file when requested by an Administrator. This data can then be used to diagnose problems in a running server. ■ Instrumentation—Oracle WebLogic Server SIP Container instruments the server and application code with monitors to help you configure diagnostic actions that are performed on SIP messages requests and responses that match certain criteria. The sections that follow provide more details about how Oracle WebLogic Server SIP Container integrates with each of the above WLDF components.

5.6.1 Data Collection and Logging

Oracle WebLogic Server SIP Container uses the WLDF Harvester service to collect data from the attributes of these runtime MBeans: ■ ReplicaRuntimeMBean ■ SipApplicationRuntimeMBean ■ SipServerRuntimeMBean You can add charts and graphs of this data to your own custom views using the WLDF console extension. To do so, first enable the WLDF console extension by copying the JAR file into the console-ext subdirectory of your domain directory: cp ~beawlserver_10.3serverlibconsole-extdiagnostics-console-extension.jar ~beauser_projectsdomainsmydomainconsole-ext When accessing the WLDF console extension, the Oracle WebLogic Server SIP Container runtime MBean attributes are available in the Metrics tab of the extension. Oracle WebLogic Server SIP Container also uses the WLDF Logger service to archive SIP and Diameter messages to independent, dedicated log files by default, domain_ home logsserver_namesipMessages.log. You can configure the name and location of the log file, as well as log rotation policies, using the Configuration Message Debug tab in the SIP Server Administration Console extension. Note that a server restart is necessary in order to initiate independent logging and log rotation.

5.6.2 Watches and Notifications

The data collected from Oracle WebLogic Server SIP Container runtime MBeans can be used to create automated monitors, or watches, that observe a servers diagnostic state. One or more notifications can then be configured for use by a watch, in order to 5-18 Oracle WebLogic SIP Server Container Administrators Guide generate a message using SMTP, SNMP, JMX, or JMS when your configured watch conditions and rules occur. To use watches and notifications, you select the Diagnostics Diagnostic Modules node in the left pane of the Administration Console and create a new module with the watch rules and notifications required for monitoring your servers. The watch rules can use the metrics collected from Oracle WebLogic Server SIP Container runtime MBeans, messages written to the log file, or events generated by the diagnostic framework.

5.6.3 Image Capture