Data Machines
...
Models Supported by Data Machi...
Activity Models

List Anomalies

5min

This model will provide a list of anomalies occurring when captured using Data Streaming, when specific input parameters are provided for a specific data field, the threshold of tolerance for anomaly detection and the alpha value or the smoothness value to smoothen the data from spikes in given duration. Data ingestion through Qualetics API is required for this model to return results.

Note: Data Streaming integration is required for this model. Please complete the integration setup, verify the data connection and ensure that the streaming is Live before using this model.

Model Input Parameters

Name

Type

Required

Pre-Defined Values

Info

fieldname

Text

Yes



Name of the field on which we need to detect the anomalous values.

threshold

Number

Yes

0 - 100

What percentage of deviation from the mean should we consider as an anomaly?

smoothness

Text



low, normal, high

Smoothing or alpha value - do you want to smoothen the spikes and dips in the data? If not provided, "normal" is applied as the default value

duration

Number





Duration in number of days to fetch data for detecting anomalies. If not provided, a value of 1 is applied as the default value

actor

Text





If looking for anomalies in a specific user's data, provide the user id. This value needs to match the Actor id included in the Actor data object.

If not provided, all user data is considered.

action

Text





If looking for anomalies for a specific type of event, provide the action or event name. This value needs to match the Action names included in the Action data object.

If not provided, all event data is considered.

context

Text





If looking for anomalies for a specific context, provide the context name. This value needs to match the Context names included in the Contextdata object.

If not provided, all event data is considered.

Rest API Input Example

The following Rest API code is trying to detect anomalies on a temperature sensor data stream and looking for anomalies where the deviation from the mean is greater than or equal to 40%.

JS


Model Output Result

Parameter Name

Parameter Type

Info

anomaly count

Number



result

Text

Anomalies Detected/Anomalies Not Detected

anomalies

Dictionary



action name

Text

Name of the Action provided in the Action data object

actor

Text

Name of the Actor provided in the Actor data object

anomaly

Boolean



attributes

Dictionary

Data attributes sent as part of the Context object using Qualetics Data Streaming

context name

Text

Name of the Context provided as part of the Context data object

current value

Number

Value of the fieldname in the event recorded

expected value

Number

Expected value

deviation from expected

Number

Actual amount of deviation from the expected value

id

Number

Unique ID of the event

timestamp

DateTime

Timestamp of the Event

Rest API Output Example

JSON


Standard Output Parameters

Every model execution output consists of the following standard output parameters

  • input
    • The input string required for the model to extract the categories
  • original input
    • This is the input provided to the first step in model which is retained across multiple steps in a Data Machine workflow.
  • final result
    • The result of the model executed in the final step of the Data Machine workflow
  • sessionid
    • A unique session id that is generated for every execution of a Data Machine which can be used to retain results across multiple sessions
  • status
    • The result of the Data Machine execution. If all of the steps in a sequence are successfully executed, a value of "Completed" is provided. If the execution is interrupted at any point, a value of "Terminated" is provided with the reason for Termination.