Get the alert task list.

Request description

RUM is deployed across multiple regions worldwide to provide more stable and low-latency access. You can refer to the Service addresses topic to choose the most suitable access point based on your business location.

Request method: POST

Request URL: https://apmplus-openapi.cn-beijing.volcengineapi.com?Action=MiniProAlarmList&Version=2024-03-12

Request parameters

The following table lists only the request parameters specific to this API and some public parameters. For details, see Public parameters.

Parameters	Type	Required	Sample value	Description
Action	String	Yes	MiniProAlarmList	The API name. The current API name is MiniProAlarmList.
Version	String	Yes	2024-03-12	The API version. The current API version is 2024-03-12.
common	Object of Common	Yes	-	Common parameters.
self	Integer	No	1	Whether to return the Task list managed by me. 1: Returns the task list managed by me. 0: Returns all.
category_list	Array of String	No	["pageview"]	Alert type filtering. If not specified, alert tasks of all alert types are returned. If specified, alert tasks of the specified alert type are returned. Call the GetAlarmMeta API to view available values.
keyword	String	No	test	Fuzzy search by alert task name. If not specified, all alert tasks are returned. If specified, alert tasks whose task names meet the condition are returned.
page_num	Long	No	1	Number of pages in the alert task list.
page_size	Long	No	10	Number of items returned in the alert task list.

Common

Parameters	Type	Required	Sample value	Description
aid	Long	Yes	12345	Application ID.
os	String	No	minipro	Service type. Supported values: app, webpro, minipro.

Sample request

Response parameters

Parameters	Type	Sample value	Description
data	Object of Data	-	Returned data.
error_msg	String	-	Error message.
error_no	Integer	0	Error code. 0 indicates success.

Data

Parameters	Type	Sample value	Description
alarm_rule_list	Array of AlarmRuleList	-	Alert task list.
count	Integer	1	Alert task count.

AlarmRuleList

Parameters	Type	Sample value	Description
alarm_param	Object of AlarmParam	-	Alert parameter set.
created_by	String	leeac	Alert task creator.
updated_by	String	leeac	Last modifier of the alert task.
created_time	Long	1665409567	Alert task creation time.
updated_time	Long	1665409567	The latest modification time of the alert task.
next_trigger_time	Long	1665409567	Next trigger time of the alert task.
last_execute_time	Long	0	Last execution time of the alert task.
ack_until_time	Long	0	ACK expiration time of alert task.
num_of_alarm_in_last_one_month	Integer	0	Alert task alert count in the most recent month.

AlarmParam

Parameters	Type	Sample value	Description
id	Long	1	Alert task ID.
name	String	test	Alert task name.
desc	String	-	Alert description.
category	String	pageview	Alert type key. Call the GetAlarmMeta API to view available values. data.measure_category_meta_list[i].key
alarm_level	String	warning	Alert level. warning fatal
strategy_list	Array of StrategyList	-	Alert policy list.
strategy_op	String	and	Alert multi-policy relationship. and: Satisfy all policies simultaneously or: Satisfy any one policy
interval_seconds	Integer	300	Alert task execution interval. 300: 5 minutes 600: 10 minutes 1800: 30 minutes 3600: 60 minutes
alarm_period	Object of AlarmPeriod	-	Alert effective time. Alerts outside the time range will not trigger notifications.
notify_config	Object of NotifyConfig	-	Alert task notification configuration.
is_avoid_spike	Boolean	false	Whether to silence spike alerts.
pct_avoid_spike	Object of PctAvoidSpike	-	PCT alert parameter. Required when PCT alert silence is enabled.

StrategyList

Parameters	Type	Sample value	Description
measure	Object of Measure	-	The metric set of the current policy. It includes simple metrics and composite metrics.
filter_list	Array of FilterList	-	Alert policy filter criteria.
alarm_strategy_type	String	threshold	Alert policy type. threshold: Threshold-based alert cmp_last_n_day: Ratio-based alert
daily_compare_count	Integer	5	Time interval between the previous period and the current period. Required when the alert policy is a ratio-based alert. The unit is minutes. For example, a value of 1440 means compared with 1 day ago.
alarm_threshold	Double	10	Alert threshold.
threshold_cmp_op	String	gt	Policy operators. For ratio-based alerts, the available values are gt and lt For threshold-based alerts, the available values are lt, lte, gt, and gte
alarm_user_threshold	Double	1	User count threshold.
alarm_sample_threshold	Double	1	Sample count threshold.
alarm_window_size	Long	180	Time window for alert task query. It represents the most recent X minutes. The unit is minutes.
group_bys	Array of GroupBys	-	Alert grouping dimension.
attribution_dimensions	Array of AttributionDimensions	-	Alert attribution dimension.

AlarmPeriod

Parameters	Type	Sample value	Description
start_time	Integer	0	Alert start time. The value is the start timestamp in seconds relative to 0:00 of the current day. For example, if the start time is 2:00 on the current day, the value is 7200.
end_time	Integer	86399	Alert end time. The value is the end timestamp in seconds relative to 0:00 of the current day. For example, if the end time is 23:59:59 on the current day, the value is 86399.

NotifyConfig

Parameters	Type	Sample value	Description
notify_types	Array of String	["mail"]	Notification method for the alert task. mail: Email lark: Feishu wechat: WeCom dingding: DingTalk
notify_lark_webhooks	Array of String	[]	List of Feishu notification webhooks. Required when the alert notification method includes Feishu.
notify_groups	Array of Long	[ 291 ]	ID List for alert notification email group. Required when the alert notification method includes email.
notify_wechat_webhooks	Array of String	[]	List of WeCom notification webhooks. Required when the alert notification method includes WeCom.
notify_dingding_webhooks	Array of String	[]	List of DingTalk notification webhooks. Required when the alert notification method includes DingTalk.

PctAvoidSpike

Parameters	Type	Sample value	Description
pct	Integer	1	Alert sub-window value. Available values are 1~9. The alert is triggered only when the alert metric values of X or more sub-windows exceed the configured alert threshold.

Measure

Parameters	Type	Sample value	Description
type	String	monomial	Metric type. monomial: Simple metric polynomial: Composite metric
raw_measure_list	Array of RawMeasureList	-	Alert metric list.
formula	String	-	Metric arithmetic formula. Optional when the metric type is the composite metric polynomial.
name	String	PV	The metric name. When the metric is a simple metric, it is the metric name. When the metric is a composite metric, it is the custom metric name.

Parameters	Type	Sample value	Description
op	String	in	Condition operator. in not_in Regex not_regex
filter_name	String	browser_brand	Filter criterion key. Call the GetAlarmMetricRelatedMeta API to view the values.
values	Array of String	["Chrome"]	Filter criterion values. Call the GetAlarmMetricCandidate API to view available values.

GroupBys

Parameters	Type	Sample value	Description
label	String	pid	Grouping metric.
group_by_number_terms	Array of GroupByNumberTerms	pid	Grouping dimension key. Call the GetAlarmMetricRelatedMeta API to view the values.

AttributionDimensions

Parameters	Type	Sample value	Description
label	String	pid	Attribution metric.
group_by_number_terms	Array of GroupByNumberTerms	pid	Attribution dimension key. Call the GetAlarmMetricRelatedMeta API to view the values.

RawMeasureList

Parameters	Type	Sample value	Description
measure_name	String	pv_uv.count	Simple metric key. Call the GetAlarmMeta and GetAlarmEventMetaMetric APIs to view the values.
filter_list	Array of FilterList	-	The filter condition. Optional when a single simple metric carries criteria and the metric type is composite.
event_name	String	-	Custom event key. Required when the metric is a custom event metric.

GroupByNumberTerms

Parameters	Type	Sample value	Description
name	String	-	Attribution dimension name.
min	Double	-	Minimum value.
max	Double	-	Maximum value.

Sample response

Error codes

No error codes are specific to this API. If the API call returns an error code, refer to Public error codes for troubleshooting.

Application Performance Management Plus