Add an alert.

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=PCAlarmAdd&Version=2022-10-28

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	PCAlarmAdd	The API name. The name of the current API is PCAlarmAdd.
Version	String	Yes	2022-10-28	The API version. The current API version is 2022-10-28.
common	Object of CommonParams	Yes	-	Public parameters.
alarm_param_list	Array of AlarmParam	Yes	-	Alert parameters.

CommonParams

Parameters	Type	Required	Sample value	Description
os	String	Yes	pc	Operating system.
aid	Long	Yes	12345	App ID.
env	String	No	crash	Environment information.

AlarmParam

Parameters	Type	Required	Sample value	Description
id	Long	No	1	The parameter is not required during creation and is required during update.
desc	String	Yes	New alert	Alert description.
name	String	Yes	minitor	Alert name.
category	String	Yes	pc_flexible	The alert type.
is_close	Integer	Yes	1	Whether to disable alerts. 0: Enabled 1: Disabled
alarm_level	String	Yes	Warn	The alert level. Notice Warn Fatal
strategy_op	String	Yes	and	The multiple-policy logic. and or
alarm_period	Object of AlarmPeriod	Yes	-	The alert time period.
notify_config	Object of NotifyConfig	No	-	The alert notification.
strategy_list	Array of AlarmStrategy	Yes	-	Alert policy.
category_label	String	No	""	Alert type display name.
interval_seconds	Integer	Yes	300	The alerting interval. The minimum interval is 5 minutes.

AlarmPeriod

Parameters	Type	Required	Sample value	Description
end_time	Integer	Yes	86399	The end time of alerting, in seconds.
start_time	Integer	Yes	0	The start time of alerting, in seconds.

NotifyConfig

Parameters	Type	Required	Sample value	Description
notify_types	Array of String	No	["mail"]	The alert notification method. lark mail wechat dingding
notify_groups	Array of Long	No	[1,23]	A list of mail receiver group IDs.
upgrade_groups	Array of Long	No	[1,23]	A list of elevated email receiver group IDs.
notify_lark_webhooks	Array of String	No	["http://lark/url"]	A list of Feishu notification webhooks.
notify_wechat_webhooks	Array of String	No	["http://wechat/url"]	A list of WeCom notification webhooks.
notify_dingding_webhooks	Array of String	No	["http://dingding/url"]	A list of DingTalk notification webhooks.

AlarmStrategy

Parameters	Type	Required	Sample value	Description
id	String	Yes	9018754602-1655285699772	The parameter value is generated by the frontend when a new alert policy is created. This parameter value is used by the backend to plot trend charts.
measure	Object of FlexMeasure	Yes	-	The metric set.
group_bys	Array of FlexGroupBy	No	-	Alert grouping.
filter_list	Array of FlexFilter	No	-	Filter condition.
alarm_threshold	Double	Yes	10	The alert threshold.
threshold_cmp_op	String	Yes	gt	The operator for the alert threshold. gt gte lt lte abs_gt abs_gte
alarm_window_size	Long	Yes	180	The time window in seconds.
alarm_strategy_type	String	Yes	threshold	The metric calculation policy. For a threshold policy, the value is "threshold". For a period-over-period policy, the value is "cmp_last_n_day".
daily_compare_count	Integer	No	60	Period-over-period comparison now supports the past X minutes.
alarm_sample_threshold	Double	No	3	Sample count threshold.

FlexMeasure

Parameters	type	Required	Sample value	Description
name	String	Yes	crash_affected_users	The metric name.
type	String	Yes	monomial	Metric type. monomial polynomial
customId	String	No	xe3ejx98	Used by the frontend to restore the page.
raw_measure_list	Array of FlexRawMeasure	Yes	-	Specific query metrics.

FlexGroupBy

Parameters	Type	Required	Sample value	Description
label	String	No	OS	The displayed group name.
group_by_name	String	Yes	os	The grouping dimension.

FlexFilter

Parameters	Type	Required	Sample value	Description
op	String	Yes	in	Filtering method.
values	Array of String	Yes	["intel", "Qualcomm"]	Filter values.
filter_name	String	Yes	cpu	Indicates the dimension of the filter.

FlexRawMeasure

Parameters	Type	Required	Sample value	Description
event_name	String	No	test_service_gyf	This parameter is passed by the frontend but not used by the backend. However, when the system restores the chart, it reads the event name from this field.
filter_list	Array of FlexFilter	No	-	Filter condition.
measure_name	String	Yes	"{"metric":"pc_flexible.count","event_dimension":"pc_flexible.event_name","event_name":"test_service_gyf"}"	Value calculated for a specific metric.

Sample request

Response parameters

Parameters	Type	Sample value	Description
data	Object of AddAlarmResponseData	-	Response data.
errmsg	String	""	Error message. If the request was successful, this field is empty.
errno	Integer	200	Error code. If the request was successful, this field is 200.

AddAlarmResponseData

Parameters	Type	Sample value	Description
ids	Array of Long	[1]	A list of alert rule IDs.

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