User Tools

Site Tools


products:promonitor:6.8:monitorsguide:netweaver:idocexchangemonitoring

IDOC exchange monitoring

Purpose

This monitor is dedicated to the monitoring of IDOC messages. It will look for ERROR or WAITING status of messages received with a given period of time. You can customize the monitoring by creating specific rules depending on the client, the message type, the partner and the direction.

Configuration hints

Use the surveillance table to adjust the monitoring settings: Thresholds, severity, filters, etc… Note: The time period must be configured in a consistent way together with the schedule time of the monitor: If the monitor is configured to run every 15 minutes, it is advised to set a period of 15 minutes too. You can set longer periods if you want to catch the number of errors within a large time frame, for statistics purpose.

With a period of 10 minutes, when the monitor runs at 12:00, it will look for IDOC messages occurred between 11:50 and 12:00.

Surveillance table

ParameterDescription
ActiveUse this field to activate or deactivate a line of configuration.
ClientA filter to match only IDOC messages for/from a given client
Message typeA filter to match only IDOC message of a given type
PartnerA filter to match only IDOC for/from a given partner
Status codeA filter to match only IDOC in error state with a particular status code
DirectionDefines the direction of the IDOC messages to look for
StatusDefine the type of status to look for.
Time period (min)Defines how far in the past the monitor will look for IDOC messages at each check.
Max errorThe threshold for the maximum number of IDOC messages matching the filters and status settings.
AggregateIf enabled, the monitor will count the number of IDOC matching the filter and send an alarm if it reaches the threshold. If not enable, it will send an alarm per IDOC.
SeverityThe severity of the alarm.
Auto clearIf checked, the alarm will be cleared as soon as the alarm condition is not met anymore.
Alarm tagThis field allows to add custom text within the alarm message. %MSG% variable will contain the actual generated message and can be used such as: “my_prefix %MSG% my_suffix”. By default, tag will be used as prefix.
AlarmIf checked, this line of surveillance will be used for alarm generation.
MetricIf checked, this line of surveillance will be used for metric generation.
ReportIf checked, this line of surveillance will be used for report generation.

Examples

ActiveClientMessage typePartnerStatus codeDirectionStatusTime period (min)Max errorAggregateSeverityAuto clearAlarm tagAlarmMetricReport
true****ANYERROR151TRUEMAJORtrue truefalsefalse

Effect : Sends a MAJOR alarm if an IDOC message with an ERROR status is found in the last 15 minutes

Examples

ActiveClientMessage typePartnerStatus codeDirectionStatusTime period (min)Max errorAggregateSeverityAuto clearAlarm tagAlarmMetricReport
true800***INBOUNDWAITING6010TRUEWARNINGtrue truefalsefalse

Effect : Sends a WARNING alarm if 10 or more IDOC messages with WAITING status from client 800 are found in the last 60 minutes.

Generated metrics

metricIdmetricUnitmetricTargetmetricDescription
FAILED_IDOC_MESSAGESIDOCS[CLIENT][DIRECTION][TYPE][PARTNER][ERROR_CODE]Sends the number of failed IDOCS matching the filter. Target field will be set according to how specific is the configuration
WAITING_IDOC_MESSAGESIDOCS[CLIENT][DIRECTION][TYPE][PARTNER][ERROR_CODE]Sends the number of waiting IDOCS matching the filter. Target field will be set according to how specific is the configuration
/home/clients/8c48b436badcd3a0bdaaba8c59a54bf1/wiki-web/data/pages/products/promonitor/6.8/monitorsguide/netweaver/idocexchangemonitoring.txt · Last modified: 2020/05/29 16:16 (external edit)