Managing and Configuring EDRs, CDRs and Alarms

The following section describes how to manage and configure EDRs, CDRs, and alarms in Oracle Communications Services Gatekeeper.

About EDRs, CDRs, and Alarms

EDR categories and XML markup

EDRs are the base component of both CDRs and alarms: they are, in fact, subsets of EDRs.

In order to categorize the objects in the EDR flow as either pure EDRs, alarms or CDRs, the EDR service uses an EDR configuration file:

<edr-config> contains descriptors that describe pure EDRs.
<alarm-config> contains descriptors that describe EDRs that should be considered alarms.
<cdr-config> contains descriptors that describe EDRs that should be considered CDRs.

Out-of-the-box, Oracle Communications Services Gatekeeper comes with a set of pre-defined descriptors. Changing and adapting the descriptors is done as a part of an integration project.

  <edr id="<ID>" description="<description>">

        <name><message response> <message></name>

        <class><fully qualified class name></class>

EDR format

The following values are always available in an EDR when it is generated from an aspect:

Class name
Method name
Direction (south, north), if the request is travelling from Oracle Communications Services Gatekeeper to the network (south) or from the network to Oracle Communications Services Gatekeeper (north)
Position (before, after), if the EDR was emitted before or after the method was invoked or exception was thrown.
Interface (north, south), if the EDR was emitted from the north interface or from the south interface of the plug-in
Source (method, exception), if the EDR is related to a method invocation or to an exception.

In addition to these values, the EDR may also contain values relevant to the context of the request.

Below is a description of the contents of an EDR. Individual value fields in an EDR are retrieved by name using a key in a name/value pair.

Table 7-1 Contents of an EDR
String value of name (key) in name/ value pair	Description
EdrId	Defined in wlng-edr.xml
ServiceName	The name, or type, of the service.
ServerName	Name of server where the EDR was generated.
Timestamp	The time at which the EDR was triggered. Milliseconds since midnight, January 1, 1970 UTC.
ContainerTransactionId	WebLogic Server transaction ID (if available)
Class	Name of the class that logged the EDR
Method	Name of the method that logged the EDR
Direction	Direction of the request
Source	The type of source that logged the EDR
Position	Position of the EDR relative to the method that logged the EDR
Interface	Interface where the EDR is logged
Exception	Name of the exception that triggered the EDR
SessionId	Session ID
ServiceProviderId	Service provider account ID
ApplicationId	Application account ID
AppInstanceGroupId	Application instance ID.
OrigAddress	The originating address with scheme included. For example tel:1212771234
DestAddress	The destination address, or addresses, with scheme included. May contain multiple addresses.
<custom>	Any additional context-specific information

EDRs

All EDRs are passed through the EDRService. All EDRs are dispatched to a JMS distributed topic so external clients can receive them over JMS.

Alarms

CDRs

External EDR listeners

EDRService

Configuration of the EDRService

Management of the EDRService

Defining batch attributes

To configure the maximum number of EDRs sent in a batch to a JMS EDR listener and the maximum time to wait before the EDRs in the buffer are sent to listeners:

Reference: Attributes and Operations for EDRService

Attribute: BatchTimeout

Attribute: StatisticsEnabled

Specifies if statistics is enabled for EDRService. Must be enabled for Operation: displayStatistics to be relevant.

Attribute: BatchSize

Attribute: PublishToJMS

Specifies if EDRs shall be published in the JMS topic or not. Needs to be true if external EDR listeners are used.

Attribute: StoreAlarms

Attribute: StoreCDRs

Operation: displayStatistics

Displays a snapshot of the current statistics for EDRService. Attribute: StatisticsEnabled must be true in order for this operation to be relevant.

Table 7-2 displayStatistics
displayStatistics
Parameter	Description
-	-

Operation: resetStatistics

Table 7-3 resetStatistics
resetStatistics
Parameter	Description
-	-

Managing EDR, CDR, and alarms configuration files using the EDR Configuration Pane

The Oracle Communications Services Gatekeeper EDR Configuration pane allows the administrator to load new EDR, CDR, and Alarm configuration files.

Open the pane by selecting OCSG

EDR Configuration from the Domain Structure in the Administration Console.

Table 7-4 Oracle Communications Services Gatekeeper EDR Configuration pane
Entry field	Input
EDR descriptor:	The EDR configuration file, see EDR categories and XML markup.
CDR descriptor	The CDR configuration file, see EDR categories and XML markup.
Alarm descriptor	The alarms configuration file, see EDR categories and XML markup.

System Administrator’s Guide