Documentation Center

EventMonitor 2.5 RetrieveEventsByProgressIds

This method retrieves the metadata of events and event details


Parameters

NameTypeDirectionDescription
psAuthContextStringInOutDeprecated proprietary authentication context only used by .ASMX web services based on internal username/password authentication. Claims based security standards drive all the WCF .SVC web services making this parameter redundant.
palProgressIdsLongArrayInLong array with the unique identifiers of the events
peLevelFiltereEventLevelIn

Indicates the minimal event level that the events must have.

For instance, when the filter on the event level is "Information", the event details with level "Exception", "Warning" and "Information" will be returned while the event details with level "Verbose" and "Debug" will not be part of the result.

plLastDetailIdLongInThe identifier of the last event detail that was retrieved during a previous call
psXMLEventDataFilterStringInEvent Metadata Filter XML structure with an additional filter on metadata to limit the objects
psXMLRequestedEventDataStringInRequested Event Metadata XML structure indicating which metadata has to be retrieved for a given event
psOutXMLEventListStringOutEvent List XML structure containing both the event data content (base 64 encoded) and the requested metadata.

Note that:
  • No event data will be retrieved. Only metadata of events (level progress) and event details (level detail) will be retrieved.
    • The parameter psXMLEventDataFilter can only be used to filter on fields of the level 'progress' or 'detail'.
    • The level attribute on the ishfield elements in the parameter psXMLRequestedEventData is also limited to 'progress' or 'detail'.
  • The parameter peLevelFilter is used to filter the event details that are retrieved. Only event details that have an event level greater than or equal to the specified event level will be retrieved. For example, when you supply "Verbose", the event details with "Information", "Warning" and "Exception" will also be retrieved.
  • The parameter plLastDetailId can be used to reduce the overhead when refreshing the list with event details. Only the event details which are logged after the specified DetailId will be returned. All event details which were already retrieved in the previous call and which are already present in your application, are not transferred and processed again. So, this parameter can be used to reduce the load on the server and client.