List monitors associated with a log

curl --request GET \
  --url https://api.eu.bronto.io/logs/{logId}/monitors \
  --header 'X-BRONTO-API-KEY: <api-key>'

const options = {method: 'GET', headers: {'X-BRONTO-API-KEY': '<api-key>'}};

fetch('https://api.eu.bronto.io/logs/{logId}/monitors', 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.eu.bronto.io/logs/{logId}/monitors",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-BRONTO-API-KEY: <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.eu.bronto.io/logs/{logId}/monitors"

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

	req.Header.Add("X-BRONTO-API-KEY", "<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.eu.bronto.io/logs/{logId}/monitors")

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

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

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

[
  {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "name": "High Error Rate",
    "comparison_operator": "ABOVE",
    "threshold": 1000,
    "window": "'Last 20 minutes', 'Last 2 hours', 'Last 1 days'",
    "actions": [
      {
        "type": "EMAIL",
        "email": "<string>",
        "integration_id": "<string>"
      }
    ],
    "status": "OK",
    "monitor_type": "PATTERN",
    "ai_report_enabled": true,
    "metadata": {
      "created_at": 123,
      "created_by": {
        "type": "API_KEY_ID",
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
      },
      "modified_at": 123,
      "modified_by": {
        "type": "API_KEY_ID",
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
      },
      "deleted_at": 123,
      "deleted_by": {
        "type": "API_KEY_ID",
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
      },
      "last_heartbeat_at": 123
    },
    "description": "Average response time is over 1 seconds in the last 20 minutes",
    "warning_threshold": 900,
    "monitored_groups": [
      {
        "group_id": "region:EU,host:100",
        "status": "OK",
        "groups": {
          "region": "EU",
          "host": 100
        }
      },
      {
        "group_id": "region:EU,host:101",
        "status": "ALERT",
        "groups": {
          "region": "EU",
          "host": 100
        }
      }
    ],
    "no_data_status": "OK",
    "muted_until": 1710958395538,
    "notify_once": false,
    "group_retention": 600000,
    "last_trigger_ts": 1710948395538,
    "aux": {},
    "compare_to": "2 hours ago",
    "change_type": "DIFFERENCE",
    "evaluation_window": "'24 hours', '7 days'",
    "anomaly_algorithm": "MEDIAN_MAD",
    "ai_report_instructions": "<string>",
    "metric_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "template": {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "arguments": {
        "from": {
          "value": {
            "value": "a157b003-d5b8-4333-a3e2-7c7864300852"
          }
        },
        "region": {
          "value": {
            "input": "region"
          }
        }
      }
    }
  }
]

{
  "bad_request_validation": {
    "summary": "Bad Request - Validation Error",
    "description": "Example error when request validation fails",
    "value": {
      "code": 400,
      "type": "Bad Request",
      "correlation_id": "95c6a974e3ab01209b6b0dfedb1b16c5",
      "details": "Validation failed: 'name' field is required and cannot be empty"
    }
  },
  "bad_request_invalid_type": {
    "summary": "Bad Request - Invalid Metric Type",
    "description": "Example error when an invalid metric type is provided",
    "value": {
      "code": 400,
      "type": "Bad Request",
      "correlation_id": "00d8a51bb2874f2583670317a4fb8db7",
      "details": "Invalid metric_type 'INVALID'. Must be one of: COUNTER, GAUGE, HISTOGRAM"
    }
  },
  "forbidden": {
    "summary": "Forbidden Access",
    "description": "Example error when user lacks required permissions",
    "value": {
      "code": 403,
      "type": "Forbidden",
      "correlation_id": "40276639de0f49d586e32edd8c4f6b34",
      "details": "Access denied. User does not have permission to create metric definition templates"
    }
  },
  "not_found": {
    "summary": "Resource Not Found",
    "description": "Example error when requested resource doesn't exist",
    "value": {
      "code": 404,
      "type": "Not Found",
      "correlation_id": "605f832bcfe44a1081441691c8d42253",
      "details": "Metric definition template with id '550e8400-e29b-41d4-a716-446655440000' not found"
    }
  },
  "rate_limit": {
    "summary": "Rate Limit Exceeded",
    "description": "Example error when API rate limit is exceeded",
    "value": {
      "code": 429,
      "type": "Too Many Requests",
      "correlation_id": "53909ed43c544531b7a555e295960437",
      "details": "Rate limit exceeded. Maximum 100 requests are allowed within a 5-minute window"
    }
  },
  "internal_server_error": {
    "summary": "Internal Server Error",
    "description": "Example error for unexpected server-side failures",
    "value": {
      "code": 500,
      "type": "Internal Server Error",
      "correlation_id": "b129b8e0e66c41aa9541a30f67e38ce2",
      "details": "An unexpected error occurred while processing your request"
    }
  }
}

{
  "bad_request_validation": {
    "summary": "Bad Request - Validation Error",
    "description": "Example error when request validation fails",
    "value": {
      "code": 400,
      "type": "Bad Request",
      "correlation_id": "95c6a974e3ab01209b6b0dfedb1b16c5",
      "details": "Validation failed: 'name' field is required and cannot be empty"
    }
  },
  "bad_request_invalid_type": {
    "summary": "Bad Request - Invalid Metric Type",
    "description": "Example error when an invalid metric type is provided",
    "value": {
      "code": 400,
      "type": "Bad Request",
      "correlation_id": "00d8a51bb2874f2583670317a4fb8db7",
      "details": "Invalid metric_type 'INVALID'. Must be one of: COUNTER, GAUGE, HISTOGRAM"
    }
  },
  "forbidden": {
    "summary": "Forbidden Access",
    "description": "Example error when user lacks required permissions",
    "value": {
      "code": 403,
      "type": "Forbidden",
      "correlation_id": "40276639de0f49d586e32edd8c4f6b34",
      "details": "Access denied. User does not have permission to create metric definition templates"
    }
  },
  "not_found": {
    "summary": "Resource Not Found",
    "description": "Example error when requested resource doesn't exist",
    "value": {
      "code": 404,
      "type": "Not Found",
      "correlation_id": "605f832bcfe44a1081441691c8d42253",
      "details": "Metric definition template with id '550e8400-e29b-41d4-a716-446655440000' not found"
    }
  },
  "rate_limit": {
    "summary": "Rate Limit Exceeded",
    "description": "Example error when API rate limit is exceeded",
    "value": {
      "code": 429,
      "type": "Too Many Requests",
      "correlation_id": "53909ed43c544531b7a555e295960437",
      "details": "Rate limit exceeded. Maximum 100 requests are allowed within a 5-minute window"
    }
  },
  "internal_server_error": {
    "summary": "Internal Server Error",
    "description": "Example error for unexpected server-side failures",
    "value": {
      "code": 500,
      "type": "Internal Server Error",
      "correlation_id": "b129b8e0e66c41aa9541a30f67e38ce2",
      "details": "An unexpected error occurred while processing your request"
    }
  }
}

{
  "bad_request_validation": {
    "summary": "Bad Request - Validation Error",
    "description": "Example error when request validation fails",
    "value": {
      "code": 400,
      "type": "Bad Request",
      "correlation_id": "95c6a974e3ab01209b6b0dfedb1b16c5",
      "details": "Validation failed: 'name' field is required and cannot be empty"
    }
  },
  "bad_request_invalid_type": {
    "summary": "Bad Request - Invalid Metric Type",
    "description": "Example error when an invalid metric type is provided",
    "value": {
      "code": 400,
      "type": "Bad Request",
      "correlation_id": "00d8a51bb2874f2583670317a4fb8db7",
      "details": "Invalid metric_type 'INVALID'. Must be one of: COUNTER, GAUGE, HISTOGRAM"
    }
  },
  "forbidden": {
    "summary": "Forbidden Access",
    "description": "Example error when user lacks required permissions",
    "value": {
      "code": 403,
      "type": "Forbidden",
      "correlation_id": "40276639de0f49d586e32edd8c4f6b34",
      "details": "Access denied. User does not have permission to create metric definition templates"
    }
  },
  "not_found": {
    "summary": "Resource Not Found",
    "description": "Example error when requested resource doesn't exist",
    "value": {
      "code": 404,
      "type": "Not Found",
      "correlation_id": "605f832bcfe44a1081441691c8d42253",
      "details": "Metric definition template with id '550e8400-e29b-41d4-a716-446655440000' not found"
    }
  },
  "rate_limit": {
    "summary": "Rate Limit Exceeded",
    "description": "Example error when API rate limit is exceeded",
    "value": {
      "code": 429,
      "type": "Too Many Requests",
      "correlation_id": "53909ed43c544531b7a555e295960437",
      "details": "Rate limit exceeded. Maximum 100 requests are allowed within a 5-minute window"
    }
  },
  "internal_server_error": {
    "summary": "Internal Server Error",
    "description": "Example error for unexpected server-side failures",
    "value": {
      "code": 500,
      "type": "Internal Server Error",
      "correlation_id": "b129b8e0e66c41aa9541a30f67e38ce2",
      "details": "An unexpected error occurred while processing your request"
    }
  }
}

{
  "bad_request_validation": {
    "summary": "Bad Request - Validation Error",
    "description": "Example error when request validation fails",
    "value": {
      "code": 400,
      "type": "Bad Request",
      "correlation_id": "95c6a974e3ab01209b6b0dfedb1b16c5",
      "details": "Validation failed: 'name' field is required and cannot be empty"
    }
  },
  "bad_request_invalid_type": {
    "summary": "Bad Request - Invalid Metric Type",
    "description": "Example error when an invalid metric type is provided",
    "value": {
      "code": 400,
      "type": "Bad Request",
      "correlation_id": "00d8a51bb2874f2583670317a4fb8db7",
      "details": "Invalid metric_type 'INVALID'. Must be one of: COUNTER, GAUGE, HISTOGRAM"
    }
  },
  "forbidden": {
    "summary": "Forbidden Access",
    "description": "Example error when user lacks required permissions",
    "value": {
      "code": 403,
      "type": "Forbidden",
      "correlation_id": "40276639de0f49d586e32edd8c4f6b34",
      "details": "Access denied. User does not have permission to create metric definition templates"
    }
  },
  "not_found": {
    "summary": "Resource Not Found",
    "description": "Example error when requested resource doesn't exist",
    "value": {
      "code": 404,
      "type": "Not Found",
      "correlation_id": "605f832bcfe44a1081441691c8d42253",
      "details": "Metric definition template with id '550e8400-e29b-41d4-a716-446655440000' not found"
    }
  },
  "rate_limit": {
    "summary": "Rate Limit Exceeded",
    "description": "Example error when API rate limit is exceeded",
    "value": {
      "code": 429,
      "type": "Too Many Requests",
      "correlation_id": "53909ed43c544531b7a555e295960437",
      "details": "Rate limit exceeded. Maximum 100 requests are allowed within a 5-minute window"
    }
  },
  "internal_server_error": {
    "summary": "Internal Server Error",
    "description": "Example error for unexpected server-side failures",
    "value": {
      "code": 500,
      "type": "Internal Server Error",
      "correlation_id": "b129b8e0e66c41aa9541a30f67e38ce2",
      "details": "An unexpected error occurred while processing your request"
    }
  }
}

GET

logs

{logId}

monitors

List monitors associated with a log

curl --request GET \
  --url https://api.eu.bronto.io/logs/{logId}/monitors \
  --header 'X-BRONTO-API-KEY: <api-key>'

const options = {method: 'GET', headers: {'X-BRONTO-API-KEY': '<api-key>'}};

fetch('https://api.eu.bronto.io/logs/{logId}/monitors', 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.eu.bronto.io/logs/{logId}/monitors",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-BRONTO-API-KEY: <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.eu.bronto.io/logs/{logId}/monitors"

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

	req.Header.Add("X-BRONTO-API-KEY", "<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.eu.bronto.io/logs/{logId}/monitors")

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

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

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

[
  {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "name": "High Error Rate",
    "comparison_operator": "ABOVE",
    "threshold": 1000,
    "window": "'Last 20 minutes', 'Last 2 hours', 'Last 1 days'",
    "actions": [
      {
        "type": "EMAIL",
        "email": "<string>",
        "integration_id": "<string>"
      }
    ],
    "status": "OK",
    "monitor_type": "PATTERN",
    "ai_report_enabled": true,
    "metadata": {
      "created_at": 123,
      "created_by": {
        "type": "API_KEY_ID",
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
      },
      "modified_at": 123,
      "modified_by": {
        "type": "API_KEY_ID",
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
      },
      "deleted_at": 123,
      "deleted_by": {
        "type": "API_KEY_ID",
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
      },
      "last_heartbeat_at": 123
    },
    "description": "Average response time is over 1 seconds in the last 20 minutes",
    "warning_threshold": 900,
    "monitored_groups": [
      {
        "group_id": "region:EU,host:100",
        "status": "OK",
        "groups": {
          "region": "EU",
          "host": 100
        }
      },
      {
        "group_id": "region:EU,host:101",
        "status": "ALERT",
        "groups": {
          "region": "EU",
          "host": 100
        }
      }
    ],
    "no_data_status": "OK",
    "muted_until": 1710958395538,
    "notify_once": false,
    "group_retention": 600000,
    "last_trigger_ts": 1710948395538,
    "aux": {},
    "compare_to": "2 hours ago",
    "change_type": "DIFFERENCE",
    "evaluation_window": "'24 hours', '7 days'",
    "anomaly_algorithm": "MEDIAN_MAD",
    "ai_report_instructions": "<string>",
    "metric_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "template": {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "arguments": {
        "from": {
          "value": {
            "value": "a157b003-d5b8-4333-a3e2-7c7864300852"
          }
        },
        "region": {
          "value": {
            "input": "region"
          }
        }
      }
    }
  }
]

{
  "bad_request_validation": {
    "summary": "Bad Request - Validation Error",
    "description": "Example error when request validation fails",
    "value": {
      "code": 400,
      "type": "Bad Request",
      "correlation_id": "95c6a974e3ab01209b6b0dfedb1b16c5",
      "details": "Validation failed: 'name' field is required and cannot be empty"
    }
  },
  "bad_request_invalid_type": {
    "summary": "Bad Request - Invalid Metric Type",
    "description": "Example error when an invalid metric type is provided",
    "value": {
      "code": 400,
      "type": "Bad Request",
      "correlation_id": "00d8a51bb2874f2583670317a4fb8db7",
      "details": "Invalid metric_type 'INVALID'. Must be one of: COUNTER, GAUGE, HISTOGRAM"
    }
  },
  "forbidden": {
    "summary": "Forbidden Access",
    "description": "Example error when user lacks required permissions",
    "value": {
      "code": 403,
      "type": "Forbidden",
      "correlation_id": "40276639de0f49d586e32edd8c4f6b34",
      "details": "Access denied. User does not have permission to create metric definition templates"
    }
  },
  "not_found": {
    "summary": "Resource Not Found",
    "description": "Example error when requested resource doesn't exist",
    "value": {
      "code": 404,
      "type": "Not Found",
      "correlation_id": "605f832bcfe44a1081441691c8d42253",
      "details": "Metric definition template with id '550e8400-e29b-41d4-a716-446655440000' not found"
    }
  },
  "rate_limit": {
    "summary": "Rate Limit Exceeded",
    "description": "Example error when API rate limit is exceeded",
    "value": {
      "code": 429,
      "type": "Too Many Requests",
      "correlation_id": "53909ed43c544531b7a555e295960437",
      "details": "Rate limit exceeded. Maximum 100 requests are allowed within a 5-minute window"
    }
  },
  "internal_server_error": {
    "summary": "Internal Server Error",
    "description": "Example error for unexpected server-side failures",
    "value": {
      "code": 500,
      "type": "Internal Server Error",
      "correlation_id": "b129b8e0e66c41aa9541a30f67e38ce2",
      "details": "An unexpected error occurred while processing your request"
    }
  }
}

{
  "bad_request_validation": {
    "summary": "Bad Request - Validation Error",
    "description": "Example error when request validation fails",
    "value": {
      "code": 400,
      "type": "Bad Request",
      "correlation_id": "95c6a974e3ab01209b6b0dfedb1b16c5",
      "details": "Validation failed: 'name' field is required and cannot be empty"
    }
  },
  "bad_request_invalid_type": {
    "summary": "Bad Request - Invalid Metric Type",
    "description": "Example error when an invalid metric type is provided",
    "value": {
      "code": 400,
      "type": "Bad Request",
      "correlation_id": "00d8a51bb2874f2583670317a4fb8db7",
      "details": "Invalid metric_type 'INVALID'. Must be one of: COUNTER, GAUGE, HISTOGRAM"
    }
  },
  "forbidden": {
    "summary": "Forbidden Access",
    "description": "Example error when user lacks required permissions",
    "value": {
      "code": 403,
      "type": "Forbidden",
      "correlation_id": "40276639de0f49d586e32edd8c4f6b34",
      "details": "Access denied. User does not have permission to create metric definition templates"
    }
  },
  "not_found": {
    "summary": "Resource Not Found",
    "description": "Example error when requested resource doesn't exist",
    "value": {
      "code": 404,
      "type": "Not Found",
      "correlation_id": "605f832bcfe44a1081441691c8d42253",
      "details": "Metric definition template with id '550e8400-e29b-41d4-a716-446655440000' not found"
    }
  },
  "rate_limit": {
    "summary": "Rate Limit Exceeded",
    "description": "Example error when API rate limit is exceeded",
    "value": {
      "code": 429,
      "type": "Too Many Requests",
      "correlation_id": "53909ed43c544531b7a555e295960437",
      "details": "Rate limit exceeded. Maximum 100 requests are allowed within a 5-minute window"
    }
  },
  "internal_server_error": {
    "summary": "Internal Server Error",
    "description": "Example error for unexpected server-side failures",
    "value": {
      "code": 500,
      "type": "Internal Server Error",
      "correlation_id": "b129b8e0e66c41aa9541a30f67e38ce2",
      "details": "An unexpected error occurred while processing your request"
    }
  }
}

{
  "bad_request_validation": {
    "summary": "Bad Request - Validation Error",
    "description": "Example error when request validation fails",
    "value": {
      "code": 400,
      "type": "Bad Request",
      "correlation_id": "95c6a974e3ab01209b6b0dfedb1b16c5",
      "details": "Validation failed: 'name' field is required and cannot be empty"
    }
  },
  "bad_request_invalid_type": {
    "summary": "Bad Request - Invalid Metric Type",
    "description": "Example error when an invalid metric type is provided",
    "value": {
      "code": 400,
      "type": "Bad Request",
      "correlation_id": "00d8a51bb2874f2583670317a4fb8db7",
      "details": "Invalid metric_type 'INVALID'. Must be one of: COUNTER, GAUGE, HISTOGRAM"
    }
  },
  "forbidden": {
    "summary": "Forbidden Access",
    "description": "Example error when user lacks required permissions",
    "value": {
      "code": 403,
      "type": "Forbidden",
      "correlation_id": "40276639de0f49d586e32edd8c4f6b34",
      "details": "Access denied. User does not have permission to create metric definition templates"
    }
  },
  "not_found": {
    "summary": "Resource Not Found",
    "description": "Example error when requested resource doesn't exist",
    "value": {
      "code": 404,
      "type": "Not Found",
      "correlation_id": "605f832bcfe44a1081441691c8d42253",
      "details": "Metric definition template with id '550e8400-e29b-41d4-a716-446655440000' not found"
    }
  },
  "rate_limit": {
    "summary": "Rate Limit Exceeded",
    "description": "Example error when API rate limit is exceeded",
    "value": {
      "code": 429,
      "type": "Too Many Requests",
      "correlation_id": "53909ed43c544531b7a555e295960437",
      "details": "Rate limit exceeded. Maximum 100 requests are allowed within a 5-minute window"
    }
  },
  "internal_server_error": {
    "summary": "Internal Server Error",
    "description": "Example error for unexpected server-side failures",
    "value": {
      "code": 500,
      "type": "Internal Server Error",
      "correlation_id": "b129b8e0e66c41aa9541a30f67e38ce2",
      "details": "An unexpected error occurred while processing your request"
    }
  }
}

{
  "bad_request_validation": {
    "summary": "Bad Request - Validation Error",
    "description": "Example error when request validation fails",
    "value": {
      "code": 400,
      "type": "Bad Request",
      "correlation_id": "95c6a974e3ab01209b6b0dfedb1b16c5",
      "details": "Validation failed: 'name' field is required and cannot be empty"
    }
  },
  "bad_request_invalid_type": {
    "summary": "Bad Request - Invalid Metric Type",
    "description": "Example error when an invalid metric type is provided",
    "value": {
      "code": 400,
      "type": "Bad Request",
      "correlation_id": "00d8a51bb2874f2583670317a4fb8db7",
      "details": "Invalid metric_type 'INVALID'. Must be one of: COUNTER, GAUGE, HISTOGRAM"
    }
  },
  "forbidden": {
    "summary": "Forbidden Access",
    "description": "Example error when user lacks required permissions",
    "value": {
      "code": 403,
      "type": "Forbidden",
      "correlation_id": "40276639de0f49d586e32edd8c4f6b34",
      "details": "Access denied. User does not have permission to create metric definition templates"
    }
  },
  "not_found": {
    "summary": "Resource Not Found",
    "description": "Example error when requested resource doesn't exist",
    "value": {
      "code": 404,
      "type": "Not Found",
      "correlation_id": "605f832bcfe44a1081441691c8d42253",
      "details": "Metric definition template with id '550e8400-e29b-41d4-a716-446655440000' not found"
    }
  },
  "rate_limit": {
    "summary": "Rate Limit Exceeded",
    "description": "Example error when API rate limit is exceeded",
    "value": {
      "code": 429,
      "type": "Too Many Requests",
      "correlation_id": "53909ed43c544531b7a555e295960437",
      "details": "Rate limit exceeded. Maximum 100 requests are allowed within a 5-minute window"
    }
  },
  "internal_server_error": {
    "summary": "Internal Server Error",
    "description": "Example error for unexpected server-side failures",
    "value": {
      "code": 500,
      "type": "Internal Server Error",
      "correlation_id": "b129b8e0e66c41aa9541a30f67e38ce2",
      "details": "An unexpected error occurred while processing your request"
    }
  }
}

Authorizations

X-BRONTO-API-KEY

string

header

required

Path Parameters

logId

string<uuid>

required

The unique identifier of the log

Response

List of monitors for the given log

string<uuid>

required

The unique identifier for the monitor

name

string

required

The name of the monitor

Required string length: 1 - 255

Example:

"High Error Rate"

comparison_operator

enum<string>

required

the comparison operator of the monitor (ABOVE, ABOVE_OR_EQUAL, BELOW, BELOW_OR_EQUAL, EQUAL, NOT_EQUAL, OUTSIDE). OUTSIDE is two-sided and is only allowed for ANOMALY_DETECTION monitors, which are the only type whose compared value is a signed deviation from a baseline.

Available options:

BELOW,

BELOW_OR_EQUAL,

ABOVE,

ABOVE_OR_EQUAL,

EQUAL,

NOT_EQUAL,

OUTSIDE

Example:

"ABOVE"

threshold

number<double>

required

the threshold the monitor compares against. For PATTERN, USAGE and CHANGE_DETECTION monitors this is a metric value. For ANOMALY_DETECTION monitors it is instead a count of baseline spread units (scaled median absolute deviations, comparable to standard deviations), so it must be greater than 0; a threshold of 3 means "more than 3 spread units away from the baseline centre".

Example:

1000

window

string

required

The time window to evaluate the monitor; minimum five minutes, maximum one day

Example:

"'Last 20 minutes', 'Last 2 hours', 'Last 1 days'"

actions

object[]

required

The list of actions (notifications) to take when the monitor fires or resolves

Required array length: 1 - 10 elements

Show child attributes

status

enum<string>

required

The status of the monitor

Available options:

OK,

NO_DATA,

ALERT,

WARN

Example:

"OK"

monitor_type

enum<string>

default:PATTERN

required

What the monitor compares its metric against. PATTERN and USAGE compare it to a fixed threshold, CHANGE_DETECTION to the same metric at an earlier time (see compare_to and change_type), and ANOMALY_DETECTION to a trailing baseline of the same series (see evaluation_window and anomaly_algorithm).

Available options:

PATTERN,

USAGE,

CHANGE_DETECTION,

ANOMALY_DETECTION

Example:

"PATTERN"

ai_report_enabled

boolean

required

True if an automatic report should be generated when the monitor triggers

metadata

object

required

Common metadata attached to all persisted resources.

Show child attributes

description

string

Extra contextual information to add to the monitor

Maximum string length: 4000

Example:

"Average response time is over 1 seconds in the last 20 minutes"

warning_threshold

number<double>

the warning threshold value, in the same units as threshold. For ANOMALY_DETECTION monitors it must be greater than 0 and less than threshold whatever the comparison operator, because the comparison is on the magnitude of the deviation.

Example:

900

monitored_groups

object[]

Representation of all the monitored groups and their status

Show child attributes

Example:

[
  {
    "group_id": "region:EU,host:100",
    "status": "OK",
    "groups": { "region": "EU", "host": 100 }
  },
  {
    "group_id": "region:EU,host:101",
    "status": "ALERT",
    "groups": { "region": "EU", "host": 100 }
  }
]

no_data_status

enum<string>

Specify the status to use if a group has no data (no events matched in a time window)

Available options:

OK,

NO_DATA,

ALERT,

WARN

Example:

"OK"

muted_until

integer<int64>

The timestamp indicating the ending of the muting. -1 indicates muted forever

Example:

1710958395538

notify_once

boolean

default:false

Notify only the groups changing the global monitor status, i.e. notifications are sent only for the first group entering ALERT status or for the last group resolving

Example:

false

group_retention

integer<int64>

Remove groups with no data after the provided time in milliseconds

Required range: 0 <= x <= 604800000

Example:

600000

last_trigger_ts

integer<int64>

The timestamp of the last time the monitor fired

Example:

1710948395538

aux

object

Additional monitor configuration

compare_to

string

For change detection monitors only. How far back in time the comparison query should be run. Minimum "5 mins ago", maximum "1 month".

Example:

"2 hours ago"

change_type

enum<string>

For change detection monitors only. Specifies how the change values are calculated, as described in the Bronto documentation.

Available options:

DIFFERENCE,

PERCENTAGE

evaluation_window

string

For anomaly detection monitors only, where it is required. The trailing period used to build the baseline the candidate window is compared against, expressed as " ". It must cover at least 10 and at most 1000 monitor windows and be at most 30 days: fewer than 10 windows leaves the baseline permanently degenerate, so the monitor reports healthy and never fires.

Example:

"'24 hours', '7 days'"

anomaly_algorithm

enum<string>

default:MEDIAN_MAD

For anomaly detection monitors only. How the baseline centre and spread are estimated. MEDIAN_MAD uses the median as the centre and the median absolute deviation, scaled by 1.4826 so it reads like a standard deviation, as the spread.

Available options:

MEDIAN_MAD

Example:

"MEDIAN_MAD"

ai_report_instructions

string

Instructions for the AI on what to include in the report, e.g. check for recent deployments, verify the health of the following dependencies: ... etc

metric_id

string<uuid>

The unique identifier for the metric definition that backs this monitor

template

object

Show child attributes

⌘I

API overview

api-keys

users

groups

search

context

live-tail

logs

datasets

monitors

dashboards

collections

access

downtimes

events

forward

top-keys

widgets

usage

integrations

exports

customers

tags

limits

permissions

parsers

ai

policies

encryption-keys

timeseries

patterns

List monitors associated with a log

Authorizations

Path Parameters

Response