Anomaly Detector v1.1
Anomaly Detector is an AI service with a set of APIs, which enables you to monitor and detect anomalies in your time series data with little ML knowledge, either batch validation or real-time inference. It includes the following features:
- Univariate Anomaly Detection - Detect different types of anomalies in single variable.
- Multivariate Anomaly Detection - Detect different types of anomalies in multiple variables from your equipment or system.
Multivariate Anomaly Detection - Detect anomalies in the last point of the request body
Submit multivariate anomaly detection task with the modelId of trained model and inference data, and the inference data should be put into request body in a JSON format. The request will complete synchronously and return the detection immediately in the response body.
Select the testing console in the region where you created your resource:
Open API testing consoleRequest URL
Request parameters
string
Format - uuid. Format - uuid. Model identifier.
Request headers
string
Media type of the body sent to the API.
string
Subscription key which provides access to this API. Found in your Cognitive Services accounts.
Request body
Request for last detection
{
"variables": [
{
"variable": "variable_1",
"timestamps": [
"2022-01-01T00:00:00Z",
"2022-01-01T00:01:00Z",
"2022-01-01T00:02:00Z"
],
"values": [
0.45513785459339717,
0.7388603950488748,
0.201088255984052
]
}
],
"topContributorCount": 10
}
{
"required": [
"topContributorCount",
"variables"
],
"properties": {
"variables": {
"type": "array",
"description": "This contains the inference data, including the name, timestamps(ISO 8601) and values of variables.",
"example": [
{
"variable": "variable_1",
"timestamps": [
"2022-01-01T00:00:00Z",
"2022-01-01T00:01:00Z",
"2022-01-01T00:02:00Z"
],
"values": [
0.45513785459339717,
0.7388603950488748,
0.201088255984052
]
}
],
"items": {
"required": [
"timestamps",
"values",
"variable"
],
"properties": {
"variable": {
"type": "string",
"description": "Variable name of last detection request."
},
"timestamps": {
"type": "array",
"description": "Timestamps of last detection request",
"items": {
"type": "string"
}
},
"values": {
"type": "array",
"description": "Values of variables.",
"items": {
"type": "number"
}
}
},
"type": "object"
}
},
"topContributorCount": {
"type": "integer",
"description": "An optional field, which is used to specify the number of top contributed variables for one anomalous timestamp in the response. The default number is 10.",
"example": 10
}
},
"type": "object",
"example": {
"variables": [
{
"variable": "variable_1",
"timestamps": [
"2022-01-01T00:00:00Z",
"2022-01-01T00:01:00Z",
"2022-01-01T00:02:00Z"
],
"values": [
0.45513785459339717,
0.7388603950488748,
0.201088255984052
]
}
],
"topContributorCount": 10
}
}
Response 200
Detection has completed successfully.
{
"variableStates": [
{
"variable": "string",
"filledNARatio": 0,
"effectiveCount": 0,
"firstTimestamp": "string",
"lastTimestamp": "string"
}
],
"results": [
{
"timestamp": "2022-01-01T00:00:00Z",
"value": {
"isAnomaly": true,
"severity": 0.8,
"score": 0.3,
"interpretation": [
{
"variable": "variable_1",
"contributionScore": 0.3324159383,
"correlationChanges": {
"changedVariables": [
"variable_2",
"variable_3"
]
}
}
]
},
"errors": [
{
"code": "string",
"message": "string"
}
]
}
]
}
{
"properties": {
"variableStates": {
"type": "array",
"items": {
"properties": {
"variable": {
"type": "string",
"description": "Variable name in variable states."
},
"filledNARatio": {
"type": "number",
"description": "Proportion of missing values that need to be filled by fillNAMethod.",
"minimum": 0,
"maximum": 1
},
"effectiveCount": {
"type": "integer",
"description": "Number of effective data points before applying fillNAMethod."
},
"firstTimestamp": {
"type": "string",
"format": "date-time",
"description": "First valid timestamp with value of input data."
},
"lastTimestamp": {
"type": "string",
"format": "date-time",
"description": "Last valid timestamp with value of input data."
}
},
"type": "object"
}
},
"results": {
"type": "array",
"items": {
"required": [
"timestamp"
],
"properties": {
"timestamp": {
"type": "string",
"format": "date-time",
"description": "The timestamp for this anomaly.",
"example": "2022-01-01T00:00:00Z"
},
"value": {
"required": [
"isAnomaly",
"score",
"severity"
],
"properties": {
"isAnomaly": {
"type": "boolean",
"description": "True if an anomaly is detected at the current timestamp.",
"example": true
},
"severity": {
"type": "number",
"description": "Indicates the significance of the anomaly. The higher the severity, the more significant the anomaly is.",
"example": 0.8,
"minimum": 0,
"maximum": 1
},
"score": {
"type": "number",
"description": "Raw anomaly score of severity, will help indicate the degree of abnormality as well.",
"example": 0.3,
"minimum": 0,
"maximum": 2
},
"interpretation": {
"type": "array",
"items": {
"description": "Interpretation contains more details of the anomaly, which will help with root cause analysis.",
"allOf": [
{
"properties": {
"variable": {
"type": "string",
"description": "Variable.",
"example": "variable_1"
},
"contributionScore": {
"type": "number",
"description": "This score shows the percentage contributing to the anomalous timestamp. A number between 0 and 1.",
"example": 0.3324159383
},
"correlationChanges": {
"example": {
"changedVariables": [
"variable_2",
"variable_3"
]
},
"properties": {
"changedVariables": {
"type": "array",
"description": "The correlated variables that have correlation changes under an anomaly.",
"example": [
"variable_2",
"variable_3"
],
"items": {
"type": "string"
}
}
},
"type": "object"
}
},
"type": "object"
}
]
}
}
},
"type": "object"
},
"errors": {
"type": "array",
"description": "Error message for the current timestamp.",
"items": {
"required": [
"code",
"message"
],
"properties": {
"code": {
"type": "string",
"description": "The error code."
},
"message": {
"type": "string",
"description": "The message explaining the error reported by the service."
}
},
"type": "object"
}
}
},
"type": "object"
}
}
},
"type": "object"
}
Response 500
Error response.
{
"code": "string",
"message": "string"
}
{
"required": [
"code",
"message"
],
"properties": {
"code": {
"type": "string",
"description": "The error code."
},
"message": {
"type": "string",
"description": "The message explaining the error reported by the service."
}
},
"type": "object"
}
Code samples
@ECHO OFF
curl -v -X POST "https://switzerlandwest.api.cognitive.microsoft.com/anomalydetector/v1.1/multivariate/models/{modelId}:detect-last"
-H "Content-Type: application/json"
-H "Ocp-Apim-Subscription-Key: {subscription key}"
--data-ascii "{body}"
using System;
using System.Net.Http.Headers;
using System.Text;
using System.Net.Http;
using System.Web;
namespace CSHttpClientSample
{
static class Program
{
static void Main()
{
MakeRequest();
Console.WriteLine("Hit ENTER to exit...");
Console.ReadLine();
}
static async void MakeRequest()
{
var client = new HttpClient();
var queryString = HttpUtility.ParseQueryString(string.Empty);
// Request headers
client.DefaultRequestHeaders.Add("Ocp-Apim-Subscription-Key", "{subscription key}");
var uri = "https://switzerlandwest.api.cognitive.microsoft.com/anomalydetector/v1.1/multivariate/models/{modelId}:detect-last?" + queryString;
HttpResponseMessage response;
// Request body
byte[] byteData = Encoding.UTF8.GetBytes("{body}");
using (var content = new ByteArrayContent(byteData))
{
content.Headers.ContentType = new MediaTypeHeaderValue("< your content type, i.e. application/json >");
response = await client.PostAsync(uri, content);
}
}
}
}
// // This sample uses the Apache HTTP client from HTTP Components (http://hc.apache.org/httpcomponents-client-ga/)
import java.net.URI;
import org.apache.http.HttpEntity;
import org.apache.http.HttpResponse;
import org.apache.http.client.HttpClient;
import org.apache.http.client.methods.HttpGet;
import org.apache.http.client.utils.URIBuilder;
import org.apache.http.impl.client.HttpClients;
import org.apache.http.util.EntityUtils;
public class JavaSample
{
public static void main(String[] args)
{
HttpClient httpclient = HttpClients.createDefault();
try
{
URIBuilder builder = new URIBuilder("https://switzerlandwest.api.cognitive.microsoft.com/anomalydetector/v1.1/multivariate/models/{modelId}:detect-last");
URI uri = builder.build();
HttpPost request = new HttpPost(uri);
request.setHeader("Content-Type", "application/json");
request.setHeader("Ocp-Apim-Subscription-Key", "{subscription key}");
// Request body
StringEntity reqEntity = new StringEntity("{body}");
request.setEntity(reqEntity);
HttpResponse response = httpclient.execute(request);
HttpEntity entity = response.getEntity();
if (entity != null)
{
System.out.println(EntityUtils.toString(entity));
}
}
catch (Exception e)
{
System.out.println(e.getMessage());
}
}
}
<!DOCTYPE html>
<html>
<head>
<title>JSSample</title>
<script src="http://ajax.googleapis.com/ajax/libs/jquery/1.9.0/jquery.min.js"></script>
</head>
<body>
<script type="text/javascript">
$(function() {
var params = {
// Request parameters
};
$.ajax({
url: "https://switzerlandwest.api.cognitive.microsoft.com/anomalydetector/v1.1/multivariate/models/{modelId}:detect-last?" + $.param(params),
beforeSend: function(xhrObj){
// Request headers
xhrObj.setRequestHeader("Content-Type","application/json");
xhrObj.setRequestHeader("Ocp-Apim-Subscription-Key","{subscription key}");
},
type: "POST",
// Request body
data: "{body}",
})
.done(function(data) {
alert("success");
})
.fail(function() {
alert("error");
});
});
</script>
</body>
</html>
#import <Foundation/Foundation.h>
int main(int argc, const char * argv[])
{
NSAutoreleasePool * pool = [[NSAutoreleasePool alloc] init];
NSString* path = @"https://switzerlandwest.api.cognitive.microsoft.com/anomalydetector/v1.1/multivariate/models/{modelId}:detect-last";
NSArray* array = @[
// Request parameters
@"entities=true",
];
NSString* string = [array componentsJoinedByString:@"&"];
path = [path stringByAppendingFormat:@"?%@", string];
NSLog(@"%@", path);
NSMutableURLRequest* _request = [NSMutableURLRequest requestWithURL:[NSURL URLWithString:path]];
[_request setHTTPMethod:@"POST"];
// Request headers
[_request setValue:@"application/json" forHTTPHeaderField:@"Content-Type"];
[_request setValue:@"{subscription key}" forHTTPHeaderField:@"Ocp-Apim-Subscription-Key"];
// Request body
[_request setHTTPBody:[@"{body}" dataUsingEncoding:NSUTF8StringEncoding]];
NSURLResponse *response = nil;
NSError *error = nil;
NSData* _connectionData = [NSURLConnection sendSynchronousRequest:_request returningResponse:&response error:&error];
if (nil != error)
{
NSLog(@"Error: %@", error);
}
else
{
NSError* error = nil;
NSMutableDictionary* json = nil;
NSString* dataString = [[NSString alloc] initWithData:_connectionData encoding:NSUTF8StringEncoding];
NSLog(@"%@", dataString);
if (nil != _connectionData)
{
json = [NSJSONSerialization JSONObjectWithData:_connectionData options:NSJSONReadingMutableContainers error:&error];
}
if (error || !json)
{
NSLog(@"Could not parse loaded json with error:%@", error);
}
NSLog(@"%@", json);
_connectionData = nil;
}
[pool drain];
return 0;
}
<?php
// This sample uses the Apache HTTP client from HTTP Components (http://hc.apache.org/httpcomponents-client-ga/)
require_once 'HTTP/Request2.php';
$request = new Http_Request2('https://switzerlandwest.api.cognitive.microsoft.com/anomalydetector/v1.1/multivariate/models/{modelId}:detect-last');
$url = $request->getUrl();
$headers = array(
// Request headers
'Content-Type' => 'application/json',
'Ocp-Apim-Subscription-Key' => '{subscription key}',
);
$request->setHeader($headers);
$parameters = array(
// Request parameters
);
$url->setQueryVariables($parameters);
$request->setMethod(HTTP_Request2::METHOD_POST);
// Request body
$request->setBody("{body}");
try
{
$response = $request->send();
echo $response->getBody();
}
catch (HttpException $ex)
{
echo $ex;
}
?>
########### Python 2.7 #############
import httplib, urllib, base64
headers = {
# Request headers
'Content-Type': 'application/json',
'Ocp-Apim-Subscription-Key': '{subscription key}',
}
params = urllib.urlencode({
})
try:
conn = httplib.HTTPSConnection('switzerlandwest.api.cognitive.microsoft.com')
conn.request("POST", "/anomalydetector/v1.1/multivariate/models/{modelId}:detect-last?%s" % params, "{body}", headers)
response = conn.getresponse()
data = response.read()
print(data)
conn.close()
except Exception as e:
print("[Errno {0}] {1}".format(e.errno, e.strerror))
####################################
########### Python 3.2 #############
import http.client, urllib.request, urllib.parse, urllib.error, base64
headers = {
# Request headers
'Content-Type': 'application/json',
'Ocp-Apim-Subscription-Key': '{subscription key}',
}
params = urllib.parse.urlencode({
})
try:
conn = http.client.HTTPSConnection('switzerlandwest.api.cognitive.microsoft.com')
conn.request("POST", "/anomalydetector/v1.1/multivariate/models/{modelId}:detect-last?%s" % params, "{body}", headers)
response = conn.getresponse()
data = response.read()
print(data)
conn.close()
except Exception as e:
print("[Errno {0}] {1}".format(e.errno, e.strerror))
####################################
require 'net/http'
uri = URI('https://switzerlandwest.api.cognitive.microsoft.com/anomalydetector/v1.1/multivariate/models/{modelId}:detect-last')
request = Net::HTTP::Post.new(uri.request_uri)
# Request headers
request['Content-Type'] = 'application/json'
# Request headers
request['Ocp-Apim-Subscription-Key'] = '{subscription key}'
# Request body
request.body = "{body}"
response = Net::HTTP.start(uri.host, uri.port, :use_ssl => uri.scheme == 'https') do |http|
http.request(request)
end
puts response.body