WebSphere brand IBM WebSphere Telecom Web Services Server, Version 7.1

Network Statistics

Records Web service requests, responses, entries, exiting and asynchronous write information.

Description

The Network Statistics mediation primitive records Web service request/response entry and exit information. The statistics are stored in a database table for use by network operations. This information can be used to construct traffic summaries for network analysis and capacity planning.

Policy configuration

This mediation primitive uses the following policies for runtime configuration:

message.statistics.RecordStatistics

Indicates whether statistics recording is enabled. In addition, the policy message.transaction.RecordTransaction must also be true for a record to be written.
  • Type: Boolean
  • Default: True
  • Allowed values: True or False

messageUTCTime

Indicates whether Universal Time Code (UTC), time should be used in the database record or local time.
  • Type: Boolean
  • Default: True
  • Allowed values: True or False

Mediation primitive properties

This mediation primitive uses the following configuration properties. Some of these properties can be modified using WebSphere® Integration Developer (WID) tooling. Properties that are promoted can be configured using the Integrated Solutions Console.

recordByDefault

Indicates whether to record statistics by default in the absence of policy information.
  • Type: Boolean
  • Promoted: Yes
  • Default: True

eventType

The event type to use when recording the statistics. This event type indicates where in the flow the event statistics were recorded. Each mediation primitive instance can be configured with a different event type to uniquely identify the point in the flow where the statistics were recorded.
  • Type: Boolean
  • Promoted: no

dataSourceName

The JNDI data source name used to access the Network Statistics mediation primitive table. This data source must match the data source used by the Transaction Recorder mediation primitive to satisfy foreign key relationships.
  • Type: string
  • Promoted: Yes
  • Default: jdbc/TWSSDB

messageType

Used to indicate the type of message seen at the Network Statistics mediation primitive. Valid values are I (Inbound), O (Outbound), and F (Fault).
  • Type: char
  • Promoted: no

Upstream SOAP headers

The following SOAP header elements are expected from upstream mediation primitives:
<twss:twssHeaders>
  ...
  <twss:globalTransactionID>
    <!-- Used to identify the transaction associated with this
         request. The global transaction ID is used in a foreign
         key relationship with the TRANSACTIONS table. -->
  </twss:globalTransactionID>
  <twss:policies>
    <twss:policy attribute="" value=""/>
    <twss:policy attribute="" value=""/>
    ...
  </twss:policies>
  ...
</twss:twssHeaders>

Added SOAP headers

The following SOAP header elements are added or modified for downstream mediation primitives:

None

Data definitions

Table name: NETWORKSTATISTICS

Field Key Data type Contents
ENTRYID PK VARCHAR (127) The unique identifier for the entry.
TRANSACTIONID PK VARCHAR (127) The unique transaction identifier. A single request/response can have multiple entries under a given transaction ID.
MESSAGETYPE   CHAR (1) (I)nbound, (O)utbound, (F)ault.
EVENTTYPE   VARCHAR (250) The event type indicating at what point in the flow execution this statistic is being recorded.
EVENTTIME   TIMESTAMP The time of the message. See the message.UseUTCTime policy.

Foreign key restrictions: UPDATE RESTRICT, CASCADE DELETE

View name: NETWORKSTATISTICSVIEW

Field Data type Contents
TRANSACTIONID VARCHAR (127) The unique transaction identifier.
REQUESTER VARCHAR (250) The requester ID.
SERVICE VARCHAR (250) The service being invoked.
SERVICEOPERATION VARCHAR (250) The service operation being invoked.
MESSAGETYPE CHAR(1) (I)nbound, (O)utbound, (F)ault.
EVENTTYPE VARCHAR (250) The event type indicating at what point in the flow execution this statistic is being recorded.
EVENTTIME TIMESTAMP The time of the message.See the message.UseUTCTime policy.

Message handling

Messages that are successfully processed by the Network Statistics mediation primitive are passed to the output terminal of the mediation primitive. If an error occurs while processing the message, the message is redirected to the fault terminal:
  • The service message object (SMO) data object transient context (context/transient/exceptionType) indicates whether a service-related or policy-related exception occurred. For the Network Statistics mediation primitive, this context is always set to service.
  • Fault information is set in the SMO headers as indicated in the following table:
SMO header (represented by XPath) Contents
ServiceMessageObject/context/failInfo/failureString The full message text that represents the fault situation with substituted variables. For example, SOAC4025E: Error occurred.
ServiceMessageObject/context/failInfo/origin The name of the mediation primitive class that originated the fault.
ServiceMessageObject/SOAPFaultInfo/faultcode The TWSS message code that represents the fault situation. For example, SOAC4025E.
ServiceMessageObject/SOAPFaultInfo/faultstring The full message text that represents the fault situation with substituted variables. For example, SOAC4025E: Error occurred.



Terms of use
(C) Copyright IBM Corporation 2009. All Rights Reserved.