Excerpt
Trend Detection is configured on projects to look for anomalies in time series data.

For an introduction and tutorial on this feature, read the Trend Detection chapter.

Methods

Table of Contents

outline	true
exclude	Methods

List Trend Detection Entities

GET https://squirro-endpoint/api/topic/v0/(string: tenant)/projects/(id: project_id)/trenddetections

...

Parameters:

tenant – User tenant.
project_id – Project identifier.

Headers:

See Common Headers.

Status Codes:

200 – All trend detection entities are returned.

See also Common Status Codes.

Returns:

List of configured trend detection entities in the "data" property.

Code Block

	js
	js

{
    "deprecated": false, 
    "data": {
        "trend_detection_entities": [
   
        {

               "aggregation_time_field": "$item_created_at", 
   
            "aggregation_field": "Price", 
   
            "name": "EU Egg Price Trend", 
  
             "created_at": "2016-06-07T10:52:05", 
                "modified"modified_at": "2016-06-07T10:52:07",

  			"trends_healthy": True, 
            "aggregation_interval": "1w", 
   
            "aggregation_method": "avg", 
  
             "query": "Type:\"Egg Price\" \"Country\":EU", 
                "project_id": "j0mN4DgQTGWDSBP3QcqDwg", 
 
              "id": "em_I-hJMRzi-OjvObOqU6A"
   
        }

       ]
   
}, 
    "id": "0a878cc1-e100-4b41-93e6-40e9ed184883", 
    "apiVersion": "v0"
}

Create Trend Detection Entity

...

In the output response, `trends_healthy` is a boolean parameter which signifies whether or not
the last retraining of the current trend-detection entity has been successful or not.

Create Trend Detection Entity

POST https://squirro-endpoint/api/topic/v0/(string: tenant)/projects/(id: project_id)/trenddetections

Parameters:

tenant – User tenant.
project_id – Project identifier.

JSON Data:

Data is passed in as a JSON object.

Valid object keys:

name (required) – Human-readable name of the trend detection entity.
query (required) – The query on which the trend is analyzed. The query may be an empty string, in which case all items in the project are analyzed.
email_user (required) – Email address to send an alert to when an anomaly is detected.
aggregation_interval (required) – Determines the time buckets into which the data is fitted.
The format of the interval is "<number><unit>" - for example "1d" for a daily interval. The full list of allowed units is "m" - minute, "h" - hour , "d" - day, "w" - week.
See the Aggregation Interval reference for full details on this parameter.
aggregation_field – Facet field on which to detect the trends. If this is not specified, the trend is computed on the number of results in a time frame.
aggregation_method – Aggregation method on how the numeric values are combined. Only used if aggregation_field is set too.
Valid options: avg (default), sum, max, min.
See the Aggregation Method reference for full details on this parameter.
aggregation_time_field – Datetime facet field on which axis to calculate the trend. This defaults to $item_created_at.

Headers: See Common Headers.

Status Codes:

201 – Trend detection entity created.

See also Common Status Codes.

Returns:

Created trend detection in the "data" property.

Code Block

	js
	js

{
	"trend_detection_entity": {
  "deprecated": false,      "data": {
        "	"aggregation_time_field": "$item_created_at", 
        	"aggregation_field": "Price", 
        	"name": "EU Egg Price Trend", 
        	"created_at": "2016-06-15T11:15:46", 
        	"modified_at": "2016-06-15T11:15:46", 
		"trends_healthy": True,
      	"aggregation_interval": "1d", 
        	"aggregation_method": "avg", 
        	"query": "Type:\"Egg Price\" \"Country\":EU", 
        	"project_id": "V73xio3rR6-8lPwBOG_EVA", 
        	"id": "hI9E58PvT_mTPtpC6_rQkQ"
  	} 
}, 
    "id": "2e4fe4f6-2b7e-4815-946e-2b904cd3c66d", 
    "apiVersion": "v0"
}

In the output response, `trends_healthy` is a boolean parameter which signifies whether or not the last retraining of the current trend-detection entity has been successful or not.

Get Trend Detection Entity

GET https://squirro-endpoint/api/topic/v0/(string: tenant)/projects/(id: project_id)/trenddetections/(id: tde_id)

Trend Detection Entity in the "data" property.

{ "deprecated": false, "data": { "aggregation_time_field": "$item_created_at", "aggregation_field": "Price", "name": "EU Egg Price Trend", "created_at": "2016-06-15T11:15:46", "modified

Parameters:

Returns:

Code Block

js

tenant – User tenant.
project_id – Project identifier.
tde_id – Trend Detection Entity identifier.

Headers:

See Common Headers.

Status Codes:

200 – Trend Detection Entity returned.

See also Common Status Codes.

include_trend_detection_entity – Boolean flag to include the trend detection entity parameters in the response. Defaults to True if not specified.
include_thresholds – Boolean flag to include the thresholds corresponding of the trend detection entity in the response. Defaults to False if not specified.
include_anomalies – Boolean flag to include the detected anomalies of the trend detection entity in the response. Defaults to False if not specified.
include_predictions – Boolean flag to include the predictions and the corresponding threholds of the trend detection entity. Defaults to False if not specified.
result_before – A Datetime type string to limit the time series data returned to be strictly before the result_before timestamp. If not specified, defaults to no end date restrictions for the returned data.
result_after – A Datetime type string to limit the time series data returned to be strictly after the result_after timestamp. If not specified, defaults to no start date restrictions for the returned data.

Headers:

See Common Headers.

Status Codes:

200 – Trend Detection Entity returned.

See also Common Status Codes.

Returns:

Requested Trend Detection Entity.

Code Block

	js
	js

{
	"trend_detection_entity": {
    	"aggregation_time_field": "$item_created_at", 
    	"aggregation_field": "Price", 
    	"name": "EU Egg Price Trend", 
    	"created_at": "2016-06-15T11:15:46", 
    	"modified_at": "2016-06-15T11:15:46",
		"trends_healthy": True,
    	"aggregation_interval": "1d", 
        	"aggregation_method": "avg", 
        	"query": "Type:\"Egg Price\" \"Country\":EU", 
        	"project_id": "V73xio3rR6-8lPwBOG_EVA", 
        	"id": "hI9E58PvT_mTPtpC6_rQkQ"
    }, 
    "id": "49d2bc0a-163a-48e1-9fa6-238770e8e488", 
    "apiVersion": "v0"
}

...

}
}

In the output response, `trends_healthy` is a boolean parameter which signifies whether or not the last retraining of the current trend-detection entity has been successful or not.

Delete Trend Detection Entity

DELETE https://squirro-endpoint/api/topic/v0/(string: tenant)/projects/(id: project_id)/trenddetections/(id: tde_id)

Parameters:

tenant – User tenant.
project_id – Project identifier.
tde_id – Trend Detection Entity identifier.

Headers:

See Common Headers.

Status Codes:

204 – Trend Detection Entity deleted.

See also Common Status Codes.

Get Thresholds

...

Warning

title	Method deprecations

Methods below will be deprecated soon. Please use the boolean flags with `Get Trend Detection Entity` end point to get the thresholds, labels and predictions.

Get Thresholds

GET https://squirro-endpoint/api/topic/v0/(string: tenant)/projects/(id: project_id)/trenddetections/{id: tde_id}/thresholds

...

{ "deprecated": false, "data": { "thresholds": [ { "count": 127.8694520548, "timestamp": "2015-01-05T00:00:00" },

.

Parameters:

tenant – User tenant.
project_id – Project identifier.
tde_id – Trend Detection Entity identifier.

Query Parameters:

Parameters are optional.

thresholds_before – Date and Time string. Return thresholds from before this timestamp.
thresholds_after – Date and Time string. Return thresholds from after this timestamp.

Headers:

See Common Headers.

Status Codes:

200 – Thresholds returned.

See also Common Status Codes.

Returns:

Thresholds in the "data" property.

Code Block

language	js

Headers:

See Common Headers.

Status Codes:

200 – Thresholds returned.

See also Common Status Codes.

Returns:

List of Thresholds.

Code Block

language	js

{
    "thresholds": [
          {

               "count": 126127.97042561488694520548, 
   
            "timestamp": "2015-01-12T0005T00:00:00"

           }, 
            {
   
            "count": 126.23582468859704256148,  
               "timestamp": "2015-01-19T0012T00:00:00"
 
          }, 
    
       {    {
            "count": 125126.67589499242358246885, 
 
              "timestamp": "2015-01-26T0019T00:00:00"
        }, 
  }      {
        ]     },"count": 125.6758949924, 
            "idtimestamp": "d7d8ec432015-1aba-441b-b6fd-73709b97debd", 
01-26T00:00:00"
        }
   "apiVersion": "v0" ]
}

Get Labels

GET https://squirro-endpoint/api/topic/v0/(string: tenant)/projects/(id: project_id)/trenddetections/{id: tde_id}/labels

...

Parameters:

tenant – User tenant.
project_id – Project identifier.
tde_id – Trend Detection Entity identifier.

Query Parameters:

Parameters are optional.

labels_before – Date and Time string. Return labels from before this timestamp.
labels_after – Date and Time string. Return labels from after this timestamp.

Headers:

See Common Headers.

Status Codes:

200 – Labels returned.

See also Common Status Codes.

Returns:

Labels in the "data" propertyList of Labels.

Code Block

language	js

{
    "deprecated": false, 
    "data": {
        "labels": [
   [
        "2015-04-06T00:00:00"
   
    ]
 
  }, 
    "id": "119f1156-9267-40e4-9aa5-edcf0f56a0bb", 
    "apiVersion": "v0"
}

This output signifies that the data contains one anomaly in the data, namely in the aggregation interval that starts on 2015-04-06 midnight.

Get Predictions

GET https://squirro-endpoint/api/topic/v0/(string: tenant)/projects/(id: project_id)/trenddetections/{id: tde_id}/predictions

...

Parameters:

tenant – User tenant.
project_id – Project identifier.
tde_id – Trend Detection Entity identifier.

Headers:

See Common Headers.

Status Codes:

200 – Thresholds returned.

See also Common Status Codes.

Returns:

Predictions in the "data" propertyList of Predictions.

The example output below has been cut.

Code Block

language	js

{
    "deprecated": false, 
    "data": {
        "predictions": [
            {
   
            "timestamp": "2016-02-22T00:00:00", 
  
             "prediction_value": 8.3393183124, 
   
            "prediction_threshold": 11.1056841591
 
          }, 
    
       {    {
            "timestamp": "2016-02-29T00:00:00", 
   
            "prediction_value": 11.9445990546, 
 
              "prediction_threshold": 12.7986151892
 
          }
        ]
    }, 
    "id": "f62822b9-1f54-4c54-bcf7-c87f016b3715", 
    "apiVersion": "v0"
}

This output shows two time buckets (weekly interval) with a predicted value and the anomaly threshold for each of those buckets.

...

Versions Compared

Old Version 4

New Version Current

Key

Methods

List Trend Detection Entities

Create Trend Detection Entity

Create Trend Detection Entity

Get Trend Detection Entity

Delete Trend Detection Entity

Get Thresholds

Get Thresholds

Get Labels

Get Predictions

Page Comparison

Versions Compared

Old Version 4

New Version Current

Key

Methods

List Trend Detection Entities

Create Trend Detection Entity

Create Trend Detection Entity

Get Trend Detection Entity

Delete Trend Detection Entity

Get Thresholds

Get Thresholds

Get Labels

Get Predictions