Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

The ECS Statistics event is triggered when the ECS_Maintenance system task is executed, see 9.23 24 Error Correction System for further information about this system task.

...

In the Event Setup tab, the values for all the event fields are set by default to All in the Match Value(s) column, which will generate event notifications every time the ECS_Maintenance system task is executed. Double-click on the field to open the Match Values dialog where you can click on the Add button to add which values you want to filter on. If there are specific values available, these will appear in a drop-down list. Alternatively, you can enter a hard-coded string or a regular expression.

The following fields are available for filtering of ECS Statistics events in the Event Setup tab:

ECS Statistics event-specific fields

  • errorCodeCountNewUDRs - This field enables you to create a regular expression-based filter for UDRs in state New in order to only generate notifications for UDRs passing the filter. This may be useful for specifying that notifications should only be generated for certain error codes and/or when a certain amount of UDRs have be been registered, for example.


    Specifying error codes

  • errorCodeCountReprocessedUDRs - This field enables you to create a regular expression-based filter for UDRs in state Reprocessed in order to only generate notifications for UDRs passing the filter. This may be useful for specifying that notifications should only be generated for certain error codes and/or when a certain amount of UDRs have be registered, for example.

...

  • category - If you have configured any Event Categories, you can select to only generate notifications for ECS Statistics events with the selected categories. See 4.4 Event Category for further information about Event Categories.

  • contents - The contents field contains a hard-coded string with event-specific information. If you want to use this field for filtering you can enter a part of the contents as a hard-coded string. However, for ECS Statistics events, everything in the content is available for filtering by using the other event fields, i.e. eventName, errorCodeCountForNewUDRs, etc.

  • eventName - This field can be used to specify which event types you want to generate notifications for. This may be useful if the selected event type is a parent to other event types. However, since the ECS Statistics event is not a parent to any other event, this field will typically not be used for this event.

  • origin - If you only want to generate notifications for events that are issued from certain Execution Contexts, you can specify the IP addresses of these Execution Contexts in this field.

  • receiveTimeStamp - This field contains the date and time for when the event was inserted into the Platform database. If you want to use timeStamp for filtering, it may be a good idea to enter a regular expression, for example, "2012-06.-*" for catching all ECS Statistics events from 1st of June, 2012, to 30th of June, 2012.

  • severity - With this field, you can determine to only generate notifications for events with a certain severity; Information, Warning, Error, or Disaster. However, since ECS Statistics events only have severity Information, this field may not be very useful for filtering.

  • timeStamp This field contains the date and time for when the Execution Context generated the event. If you want to use timeStamp for filtering, it may be a good idea to enter a regular expression, for example, "2012-06-15 09:.*" for catching all ECS Statistics events from 9:00 to 9:59 on the 15th of June, 2012.

...

Info
titleExample - ECS Statistics Event notification saved in Log File

Image RemovedImage Added

This configuration will give you the following notification setup:

  • When the ECS_Maintenance system task is run, a notification will be generated if any UDRs in the New state with an error code myErrorCode, or if any UDRs in a Reprocessed state are detected.

  • When this notification is generated, a new line with information will be logged in the errorcodenew.txt file located in the /home/myDirectory/ecs folder, containing the following data:

    • The timestamp for when the event was triggered.

    • The event name, i.e. ECS Statistics Event.

    • The number of UDRs in state New with error code MyErrorCode

    • The number of UDRs registered for each error code for UDRs in the Reprocessed state.

    • The state of the UDRs.

...

Info
titleExample - ECS Statistics Event notification sent as mail

Image Removed Image Added

This configuration will give you the following notification setup:

  • When the ECS_Maintenance system task is run, a notification will be generated if more than 100 UDRs are in the New state with an error code CriticalError, or if any UDRs in Reprocessed state are detected.

  • When this notification is generated, a mail will be sent to the mail address my.mail@mycompany.com, containing the following data:

    • A subject line saying: ECS Alert - ECS Statistics Event

    • A message saying: At <the timestamp for when the event was generated> more than 100 UDRs with error code CriticalError was detected.

    • The the entire content of the notification will also be included in the message.


Scroll ignore
scroll-viewportfalse
scroll-pdftrue
scroll-officefalse
scroll-chmtrue
scroll-docbooktrue
scroll-eclipsehelptrue
scroll-epubtrue
scroll-htmlfalse


Next: