Managing Events
The services for event management are available in the TW.AnalysisServices.EventManagementServicesAPI resource.
The following table provides information about the purpose, input parameters, and the result of each service:
|
Service Name and Purpose
|
Input Parameters
|
Result
|
||||||
|---|---|---|---|---|---|---|---|---|
|
Parameter Name
|
Base Type
|
Description
|
||||||
|
CloneAnalysisEvent — Clones an analysis event, along with input and result mappings, on the specified thing.
|
eventId
|
String
|
Specifies the event ID of the analysis event to be cloned.
|
Returns information about the cloned analysis event in the form of an infotable that has the TW.AnalysisServices.AnalysisServiceTriggerDataShape data shape.
Throws an exception in case of any errors while specifying the input parameters.
|
||||
|
thingName
|
Thingname
|
Specifies the name of the thing on which the analysis event is to be cloned.
|
||||||
|
alertName
|
String
|
Specifies the name of the alert. This allows you to customize the cloned event according to alert type. This parameter is optional.
|
||||||
|
propertyName
|
String
|
Specifies the name of the property. This allows you to customize the cloned event according to alert type for a given alert name and property name. This parameter is optional.
|
||||||
|
CreateAnalysisEvent — Creates an analysis event for a particular provider and model from a specified entity and event.
|
sourceEntityName
|
Thingname
|
Specifies the name of the source entity.
|
Returns the ID of the analysis event that is created.
|
||||
|
eventName
|
String
|
Specifies the name of the event on which the analysis is triggered.
|
||||||
|
eventProperty
|
String
|
Specifies the name of the property if the event specified by eventName is a property event. Otherwise, it can be set to null.
|
||||||
|
alertName
|
String
|
Specifies the name of the specific alert on the eventproperty, if the event is a property-based alert. Otherwise, it can be set to null.
|
||||||
|
providerName
|
String
|
Specifies the name of the provider.
|
||||||
|
modelName
|
String
|
Specifies the name of the model for which the analysis must be executed on event trigger.
|
||||||
|
isSimulation
|
Boolean
|
Specifies if the analysis is to be executed as a simulation. Set the value of this parameter to true to run the analysis as simulation. Setting the value of this parameter to false runs the analysis in the discrete mode.
|
||||||
|
runOnSameHost
|
Boolean
|
Specifies if the cascaded event must run on the same host as the event that triggered it.
|
||||||
|
matchExecutionRate
|
Boolean
|
The value of this parameter is set to true only if below two conditions are met:
• If the value of the isSimulation parameter is set to true
• Execute the analysis only if the interval between executions exceeds the average execution time
|
||||||
|
retainJobHistory
|
String
|
Specifies if the job details will be stored for the discrete analysis event. The following are the eligible values:
• None
• Failed
• All
The default value is None.
|
||||||
|
agentName
|
String
|
Specifies the name of the agent where the event must be executed.
This parameter is optional.
|
||||||
|
isTimeSeries
|
Boolean
|
Specifies whether the analysis event is instance-based or time series-based. Set to true to configure the event as time-series based.
This parameter is optional.
|
||||||
|
trailingTimeDuration
|
Long
|
If the value of the isTimeSeries parameter is set to true, specify the time in milliseconds for which you want collect the trailing data.
|
||||||
|
lookBackCount
|
Integer
|
If the value of the isTimeSeries parameter is set to false, this parameter specifies the number of mapped entries’ rows for which trailing data is to be collected.
|
||||||
|
samplingFrequency
|
Long
|
Specifies the frequency in milliseconds at which you want to collect the trailing data for the specified values of the trailingTimeDuration parameter or the lookBackCount parameter.
|
||||||
|
EntityType
|
String
|
Specifies the type of entity that the event is to be created on as one of the following:
• Thing
• Thing template
• Thing shape
This parameter is optional.
|
||||||
|
customData
|
Infotable
|
Specifies any additional information that is customer-specific about an event.
|
||||||
|
DeleteAnalysisEvent — Deletes the specified analysis event.
|
eventId
|
String
|
Specifies the ID of the analysis event that must be deleted.
|
Returns a message that states the successful completion or errors that occur during the execution of the service.
|
||||
|
DisableAnalysisEvent — Disables the specified analysis event.
|
eventId
|
String
|
Specifies the ID of the analysis event that must be disabled.
|
Returns a message that states the successful completion or errors that occur during the execution of the service.
|
||||
|
EnableAnalysisEvent — Enables the specified analysis event.
|
eventId
|
String
|
Specifies the ID of the analysis event that must be enabled.
|
Returns a message that states the successful completion or errors that occur during the execution of the service.
|
||||
|
FilterAnalysisEvents — Filters analysis events that are present on a specified thing, based on thing name, provider name, and model name.
|
thingName
|
Thingname
|
Specifies the name of the thing based on which the analysis events are filtered on.
|
Returns the analysis events that match the specified input parameters in the form of an infotable that has the TW.AnalysisServices.AnalysisServiceTriggerDataShape data shape.
Throws an exception if an analysis event is enabled on the specified thing, or in case of any errors while specifying the input parameters.
|
||||
|
providerName
|
String
|
Specifies the name of the provider.
|
||||||
|
modelName
|
String
|
Specifies the name of the model.
|
||||||
|
FilterAnalysisEventsForCloning — Filters analysis events that are present on the predecessors (thing templates and thing shapes) of a specified thing that can be cloned based on the thing name, provider name, and model name.
|
thingName
|
Thingname
|
Specifies the name of the thing based on which the analysis events are filtered on for cloning.
|
Returns the analysis events that can be cloned on the specified thing in the form of an infotable that has the TW.AnalysisServices.AnalysisServiceTriggerDataShape data shape.
Throws an exception if an analysis event is enabled on the specified thing, or in case of any errors while specifying the input parameters.
|
||||
|
providerName
|
String
|
Specifies the name of the provider.
|
||||||
|
modelName
|
String
|
Specifies the name of the model.
|
||||||
|
GetAnalysisEvent — Retrieves the analysis event for a particular entity, event, alert, model, and provider.
|
sourceEntityName
|
String
|
Specifies the name of the source entity.
|
Returns the analysis event entry for the specified entity, event, alert, model, and provider. This is an infotable has the TW.AnalysisServices.AnalysisServiceTriggerDataShape data shape.
|
||||
|
eventName
|
String
|
Specifies the name of the event on which the analysis is triggered.
|
||||||
|
eventProperty
|
String
|
Specifies the name of the property if the event specified by eventName is a property event. Otherwise, it can be set to null.
|
||||||
|
alertName
|
String
|
Specifies the name of the specific alert on the eventproperty, if the event is a property-based alert. Otherwise, it can be set to null.
|
||||||
|
providerName
|
String
|
Specifies the name of the provider.
|
||||||
|
modelName
|
String
|
Specifies the name of the model for which the analysis must be executed on event trigger.
|
||||||
|
GetJobsByAnalysisEventID — Retrieves the specified number of latest jobs fired by a particular given analysis event.
|
analysisEventId
|
String
|
Specifies the ID of the analysis event.
|
Returns an infotable that contains job rows. This infotable is in the same format as TW.AnalysisServices.AnalysisDataShape.
|
||||
|
count
|
Integer
|
Specifies the number of entries to be returned. By default, it returns 500 entries.
|
||||||
|
GetLatestJobByAnalysisEventID — Retrieves the latest job (filtered by created timestamp) fired by a particular analysis event.
|
analysisEventId
|
String
|
Specifies the ID of the analysis event.
|
Returns an infotable that contains the latest job row. This infotable is in the same format as TW.AnalysisServices.AnalysisDataShape.
|
||||
|
IsResultMappingAvailableForEventId — Checks if result mapping is available for the specified analysis event.
|
eventId
|
String
|
Specifies the event ID of the analysis event that needs to be checked for result mapping availability.
|
If the analysis event is enabled, it returns a boolean value of false.
If the analysis event is disabled, and an analysis replay is not created on the event, it returns a boolean value of true.
If the analysis event is disabled, and an analysis replay is created on the event, then depending on the value of the mapResults parameter of the CreateReplay service, it returns the following value:
• If mapResults is set to true, returns false.
• If mapResults is set to false, returns true.
Throws an exception in case of any errors while specifying the input parameters.
|
||||
|
QueryAnalysisEvents — Returns event information based on the query.
|
values
|
Infotable
|
Specifies the attributes of the event in the form of a collection of multiple value rows.
|
Returns information about the model in the form of an infotable that has the TW.AnalysisServices.AnalysisServiceTriggerDataShape data shape.
|
||||
|
query
|
Query
|
Specifies the query that includes what information is required about a particular event.
|
||||||
|
UpdateRetainJobHistoryValue — Updates the configuration setting of retaining the job history for a particular analysis event.
|
eventId
|
String
|
Specifies the event ID of the analysis event.
|
Returns a message that states the successful completion or errors that occur during the execution of the service.
|
||||
|
retainJobHistory
|
String
|
Specifies if the job details will be stored for the analysis event. The following are the eligible values:
• None
• Failed
• All
|
||||||
