| Oracle® Communications Service Broker System Administrator's Guide Release 5.0 Part Number E15183-01 |
|
|
View PDF |
| Oracle® Communications Service Broker System Administrator's Guide Release 5.0 Part Number E15183-01 |
|
|
View PDF |
The following sections explain how you can monitor Oracle Communications Service Broker using Service Broker Service Description Records (SDRs):
A Service Description Record (SDR) is a set of parameter-value pairs that provide information on how service activation and delivery are performed through Service Broker.
An SDR is generated by the OE for each session. You will find SDRs on each Processing Server where an OE instance runs.
The OE stores SDRs in text files. The file name conventions is as follows:
ocsb.sdr.oe.<processing-server-host-name>.<SN>
Where:
<processing-server-host-name> is the name of the processing server where the OE runs
<SN> is a file serial number, starting from 1
For example:
ocsb.sdr.oe.sb-processing01.17
Each file contains multiple SDRs. A files is closed when it reaches a pre-configured file size, at which time a new file is created. The default file size is 100 KB.
When the number of files reaches a pre-configured maximum, the oldest file is deleted with the addition of each new file. The default maximum number of files is 10.
If you need to store SDR files for longer periods of time, you should fetch the SDR files daily and move them to a separate system.
Depending on your system capacity, you may want to modify maximum SDR file size and the maximum allowed number of SDR files. You can also disable writing SDRs to files if you do not need them.
SDR logging is controlled by Log4J. Service Broker includes pre-configured Log4J parameters with key-value pairs that define SDR logging.
The Log4J Configuration MBeans reflect the structure of the Log4J XML configuration file. See the Log4J documentation at:
http://wiki.apache.org/logging-log4j/Log4jXmlFormat
The MBean Object Name is:
oracle:type=oracle.axia.cm.ConfigurationMBean,name=oracle.axia.logging.log4jconfig,version=1.0.0.0,name0=log4jConfig
The default configuration MBean has an object name with name1 set to configuration[0]:
oracle:type=oracle.axia.cm.ConfigurationMBean,name=oracle.axia.logging.log4jconfig,version=1.0.0.0,name0=log4jConfig,name1=configuration[0]]
Using the Scripting Engine or an MBean browser:
Locate the Log4J Configuration MBean.
Locate the configuration MBean with object name:
oracle:type=oracle.axia.cm.ConfigurationMBean,name=oracle.axia.logging.log4jconfig,version=1.0.0.0,name0=log4jConfig,name1=configuration[0]]
Locate the appender MBean that has the attribute name set to oe_file.
Example Object Name:
oracle:type=oracle.axia.cm.ConfigurationMBean,name=oracle.axia.logging.log4jconfig,version=1.0.0.0,name0=log4jConfig,name1=configuration[0],name2=appender[2]
Locate the param MBean with the attribute name set to MaxFileSize.
Example Object Name:
oracle:type=oracle.axia.cm.ConfigurationMBean,name=oracle.axia.logging.log4jconfig,version=1.0.0.0,name0=log4jConfig,name1=configuration[0],name2=appender[2],name3=param[1]
Set the attribute value for the param MBean to the maximum file size. Default value is 100KB.
Locate the param MBean with the attribute name set to MaxBackupIndex.
Example Object Name:
oracle:type=oracle.axia.cm.ConfigurationMBean,name=oracle.axia.logging.log4jconfig,version=1.0.0.0,name0=log4jConfig,name1=configuration[0],name2=appender[2],name3=param[2]]
Set the attribute value for the param MBean to the number of files. Default value is 10.
To disable writing SDRs to files, change the log level of the SDR logger from trace to info or any higher log level.
Using the Scripting Engine or an MBean browser:
Locate the Log4J Configuration MBean.
Locate the configuration MBean with object name:
oracle:type=oracle.axia.cm.ConfigurationMBean,name=oracle.axia.logging.log4jconfig,version=1.0.0.0,name0=log4jConfig,name1=configuration[0]]
Locate the logger MBean that has the attribute name set to com.convergin.oe.common.datarecord.OeSpooler.
Example Object Name:
oracle:type=oracle.axia.cm.ConfigurationMBean,name=oracle.axia.logging.log4jconfig,version=1.0.0.0,name0=log4jConfig,name1=configuration[0],name2=logger[5]
Locate the level MBean for the logger MBean.
Set the attribute value for the level MBean to trace or info. Default value is trace, which enables SDR logging.
Each SDR consists of parameter-value pairs that store information about service activation and delivery performed through Service Broker. Table 14-1 describes the parameters available in each SDR.
Table 14-1 Service Broker SDR Fields
| Field | Description |
|---|---|
|
ModuleType |
Specifies the type of Service Broker module that generated the SDR. This value of field is always "OE". |
|
ModuleVersion |
Specifies the OE version |
|
RecordType |
Specifies the type of session that triggered the OE: Possible values:
|
|
ModuleInstanceName |
Specifies the module instance name |
|
Server |
Specifies the name of the Processing Server where the OE runs. |
|
CallDirection |
Specifies the session direction. Possible values:
|
|
CallReferenceNumber |
Specifies the unique session reference number. |
|
ChargingVector |
Specifies the call p-charging-vector, as defined in IETF RFC 3455 |
|
SBCorrelationID |
Specifies a unique identifier generated by the first Service Broker module in the session path |
|
SubscriberID |
Specifies the identifier of the subscriber for whom the service is triggered |
|
ServiceKey |
Specifies the service identifier. This field is displayed only when the OE is triggered through the IM-SCF CAP or IM-SCF CS1. |
|
CallingPartyNumber |
Specifies the calling party number |
|
AdditionalCallingPartyNumber |
Specifies the calling party number. Usually this number is identical to the value of the CallingPartyNumber field. |
|
CalledPartyNumber |
Specifies the called party number |
|
OPR |
Specifies the Orchestration Profile Receiver that the OE used to obtain the orchestration profile. For more information about the types of OPRs, see "About Orchestration Profile Receivers" in the Oracle Communications Service Broker Concepts Guide. |
|
OLID |
Specifies the unique identifier of the orchestration profile that the OPR downloaded. When the LSS is used, this field shows the ID field given to an LSS profile. When the orchestration logic was not found, this field is set to 'not found'. |
|
OLP |
Specifies the OLP that was used. |
|
ServiceStartTime |
Specifies the time when the session started (that is when the OE was triggered) |
|
ServiceTermTime |
Specifies the time when the Service Broker finished handling the session |
|
Application |
Specifies the application that the Service Broker triggered in the following format: <Application Name>; <Time>; <Application Response>, where:
For example: SBX@domain.com; 2009-02-13T07:29:28.482-0600; 302 |
|
ImInfo |
Information received from IMs in the session path inside Service Broker. The information is dynamic and varies, depending on the IM that provided the information. Field format: <im-type->; <info-tag-value-string> For example: ImInfo: IMOCF; sid=35263; requm=3; nonChargeDuration=25 The values in the info-tag-value-string are listed in IM-Generated Tags. |
An example of an SDR is provided below:
ModuleType : oe ModuleVersion : 1.0 RecordType : CallControl ModuleInstanceName : oe_instance Server : sb_processing01 CallDirection : Outgoing CallReferenceNumber : 36011211571409664 ChargingVector : icid-value=360112115714096647FF001; icid-generated-at=sb.ora.com SBCorrelationID : null SubscriberID : <sip:2425540022@wcs.convergin.com;noa=national> ServiceKey : 11 CallingPartyNumber : <sip:2425540022@wcs.convergin.com;noa=national> AdditionalCallingPartyNumber : "sipp"<sip:sipp@192.168.0.170:5060>;tag=1260965860664 CalledPartyNumber : "sut"<sip:service@192.168.0.170:2345>;tag=1260965860665 OPR : LSS OLID : 101 OLP : ifc ServiceStartTime : Wed Dec 16 14:17:41 IST 2009 ServiceTermTime : Wed Dec 16 14:17:52 IST 2009 Application : <sip:imasf_instance.IMASF@convergin.com;lr> ; Wed Dec 16 14:17:42 IST 2009 ; INVITE
Service Broker IMs generate session-related data describing IM activity during the session. The OE receives this data and incorporates into the SDR. The data consists of a range of tags, which vary according to the IM type.
Table 14–2 describes the tags generated by the IM-OCF.
| IM Type | Tags | Description |
|---|---|---|
|
IMOCF |
sid=35263; recum=3; nonChargeDuration=25 |
sid: session id reqnum: the number of the last successful CCR request sent to an OCF nonchargeDuration: The time that elapsed from the last successful CCR request to the end of the session. This time can be used at a later time for provisioning in the OCF (if it fails), for offline charging. |
|
 Copyright © 2010, Oracle and/or its affiliates. All rights reserved. Legal Notices |
|
