Anomalies

List anomaly feed

Paginated, filterable feed of detected anomalies ordered by severity then cost impact, with active and new-since-yesterday aggregates. resource_id scopes the feed and its aggregates to anomalies whose resource matches a given id exactly or by its provider resource key (the trailing id segment, case-insensitive), so aws:///us-east-1d/i-0abc and i-0abc match each other. filter scopes the feed and its aggregates to a cost box: an anomaly is in the box when its resource had cost in the last 31 days matching every filter, or, when every filter is on provider, region, service or resource, when its own provider (required, case-insensitive), region and service (case-insensitive, matched when set) and resource match. A not: filter on those dimensions inverts the value test and keeps the same blank handling.

GET

api

tenant

anomalies

List anomaly feed

curl --request GET \
  --url https://api.costgraph.ai/api/v1/tenant/anomalies \
  --header 'Authorization: <api-key>'

const options = {method: 'GET', headers: {Authorization: '<api-key>'}};

fetch('https://api.costgraph.ai/api/v1/tenant/anomalies', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.costgraph.ai/api/v1/tenant/anomalies",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.costgraph.ai/api/v1/tenant/anomalies"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.costgraph.ai/api/v1/tenant/anomalies")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "message": "some message",
  "status": "success",
  "data": {
    "active_count": 123,
    "items": [
      {
        "activated_at": "<string>",
        "anomaly_type": "<string>",
        "availability_zone": "<string>",
        "category": "<string>",
        "confidence": "<string>",
        "contributors": [
          {
            "cost_monthly": 123,
            "dimension": "<string>",
            "share_pct": 123
          }
        ],
        "cost_impact_annual": 123,
        "cost_impact_basis": "<string>",
        "cost_impact_monthly": 123,
        "created_at": "<string>",
        "description": "<string>",
        "detector": "<string>",
        "detector_version": "<string>",
        "evidence": {
          "baseline_p50": 123,
          "baseline_p95": 123,
          "source": {},
          "stateful": true,
          "value": 123,
          "version": 123,
          "window_end": "<string>",
          "window_start": "<string>"
        },
        "fingerprint": "<string>",
        "id": "<string>",
        "labels": {},
        "line_item_type": "<string>",
        "magnitude": 123,
        "magnitude_bar": {
          "baseline_pct": 123,
          "unit": "<string>",
          "value": 123,
          "baseline": 123
        },
        "magnitude_unit": "<string>",
        "miss_count": 123,
        "name": "<string>",
        "num_recurring_events": 123,
        "prompt_context": {
          "explanation": "<string>",
          "metadata": {},
          "observations": [
            {
              "severity": "<string>",
              "text": "<string>"
            }
          ],
          "resource": {},
          "suggested_questions": [
            "<string>"
          ],
          "summary": "<string>",
          "version": 123
        },
        "provider": "<string>",
        "region": "<string>",
        "resolved_at": "<string>",
        "resource_id": "<string>",
        "resource_name": "<string>",
        "resource_type": "<string>",
        "service": "<string>",
        "severity": "<string>",
        "status": "<string>",
        "tenant_id": "<string>",
        "title": "<string>",
        "updated_at": "<string>"
      }
    ],
    "new_since_yesterday": 123,
    "total": 123
  }
}

{
  "message": "some message",
  "status": "error"
}

{
  "message": "some message",
  "status": "error"
}

Authorizations

Authorization

string

header

required

Enter "Bearer {token}"

Query Parameters

status

string[]

Filter by status

severity

string[]

Filter by severity

Response

message

string

required

Example:

"some message"

status

string

required

Example:

"success"

data

object

Show child attributes

List anomaly feed

curl --request GET \
  --url https://api.costgraph.ai/api/v1/tenant/anomalies \
  --header 'Authorization: <api-key>'

const options = {method: 'GET', headers: {Authorization: '<api-key>'}};

fetch('https://api.costgraph.ai/api/v1/tenant/anomalies', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.costgraph.ai/api/v1/tenant/anomalies",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.costgraph.ai/api/v1/tenant/anomalies"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.costgraph.ai/api/v1/tenant/anomalies")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "message": "some message",
  "status": "success",
  "data": {
    "active_count": 123,
    "items": [
      {
        "activated_at": "<string>",
        "anomaly_type": "<string>",
        "availability_zone": "<string>",
        "category": "<string>",
        "confidence": "<string>",
        "contributors": [
          {
            "cost_monthly": 123,
            "dimension": "<string>",
            "share_pct": 123
          }
        ],
        "cost_impact_annual": 123,
        "cost_impact_basis": "<string>",
        "cost_impact_monthly": 123,
        "created_at": "<string>",
        "description": "<string>",
        "detector": "<string>",
        "detector_version": "<string>",
        "evidence": {
          "baseline_p50": 123,
          "baseline_p95": 123,
          "source": {},
          "stateful": true,
          "value": 123,
          "version": 123,
          "window_end": "<string>",
          "window_start": "<string>"
        },
        "fingerprint": "<string>",
        "id": "<string>",
        "labels": {},
        "line_item_type": "<string>",
        "magnitude": 123,
        "magnitude_bar": {
          "baseline_pct": 123,
          "unit": "<string>",
          "value": 123,
          "baseline": 123
        },
        "magnitude_unit": "<string>",
        "miss_count": 123,
        "name": "<string>",
        "num_recurring_events": 123,
        "prompt_context": {
          "explanation": "<string>",
          "metadata": {},
          "observations": [
            {
              "severity": "<string>",
              "text": "<string>"
            }
          ],
          "resource": {},
          "suggested_questions": [
            "<string>"
          ],
          "summary": "<string>",
          "version": 123
        },
        "provider": "<string>",
        "region": "<string>",
        "resolved_at": "<string>",
        "resource_id": "<string>",
        "resource_name": "<string>",
        "resource_type": "<string>",
        "service": "<string>",
        "severity": "<string>",
        "status": "<string>",
        "tenant_id": "<string>",
        "title": "<string>",
        "updated_at": "<string>"
      }
    ],
    "new_since_yesterday": 123,
    "total": 123
  }
}

{
  "message": "some message",
  "status": "error"
}

{
  "message": "some message",
  "status": "error"
}

Getting started

Endpoints

List anomaly feed

Authorizations

Query Parameters

Response