{tenantId}/trace-alerts

This API can be used to create alert definitions. Generated accessToken required to have alerts:manage scope to access this API and EVERYONE Target level and CLIENT provider.

Json key	Json Value Type	Description	accepted format	mandatory/optional
name	String	alert definition name, it should be unique across the client	String should not be null or empty	mandatory
query	String	PromQL Query	String should not be null or empty	mandatory
alertThresholdType	String	it indicates alerts threshold type	it should be STATIC_THRESHOLD	mandatory
alertThresholdData	JSON Object	it contains either warningCondition or criticalCondition or both	JSON Object	mandatory
warningCondition/criticalCondition	String	comma separated positive values preceeded with operators. operators supported are >,>=,<,<=,!=,-(between). if we give a single number then it is considered as = operator	3,>4,<3,!=2,>=2,<=2,!=4,8-20	mandatory
noDataCondition	String	No Data Alert will be generate at client and alert definition level. for every 15 minutes it will compute	no data condition should be NO_DATA_ALERT or WARNING_ALERT or CRITICAL_ALERT.	mandatory
alertTriggerDuration	String	alert generation is happened when thresholds breach continuously upto mention peroid. Minimum duration should be 1 minute.	positive integer values including zero followed by m or s. m means minutes and s means seconds	mandatory
labels	JSON Array	JSON Array contains the metric labels as JSON Objects	JSON Array contains JSON Objects, each JSON Object contain name and value	optional
attributes	JSON Array	JSON Array contains the resource attribute labels as JSON Objects	JSON Array contains JSON Objects, each JSON Object contain name as [name or host or ip or uuid] and value	mandatory
subject	String	alert subject	String	optional
description	String	alert description	String	optional
entityType	JSONArray	indicates the entity type of Alert	array should only contains RESOURCE	mandatory
component	JSONArray	indicates the component of Alert	array contains one label	optional
status	boolean	alert are generated if status is true	value should be true to generate alerts	optional - default value is true

Note:

Alert Subject and description can be customised with the help of tokens. In the triggered alerts the tokens will get replaced with actual values.

Please ensure these tokens have a space before and after them

  "subject": "Test host {{$host}} {{$name}} ",
  "description": "Test host {{$host}} {{$name}} "

{tenantId}/trace-alerts

Path Parameters

Request Body

Responses

200OK