API概览

更新时间: 2023-12-08 14:14:23
本产品(应用实时监控服务ARMS/2019-08-08)的OpenAPI采用RPC签名风格,签名细节参见签名机制说明我们已经为开发者封装了常见编程语言的SDK,开发者可通过下载SDK直接调用本产品OpenAPI而无需关心技术细节。如果现有SDK不能满足使用需求,可通过签名机制进行自签名对接。由于自签名细节非常复杂,需花费 5个工作日左右。因此建议加入我们的服务钉钉群(11370001915),在专家指导下进行签名对接。
在使用API前,您需要准备好身份账号及访问密钥(AccessKey),才能有效通过客户端工具(SDK、CLI等)访问API。细节请参见获取AccessKey

监控指标

API标题API概述
QueryMetricByPage查询监控指标分页查询应用监控或前端监控的相关监控指标。

应用监控

API标题API概述
GetTraceApp获取应用监控任务详情获取应用监控任务详情。
GetAppApiByPage查询接口的黄金三指标数据通过分页的形式查询应用下每个接口的请求量、错误数、平均响应时间三种性能数据。可通过返回信息中的Completed字段判断分页是否结束。如未结束,CurrentPage参数加一后继续发起查询即可。
GetTrace获取调用链详情加快获取调用链详情。
GetStack获取调用链方法栈获取调用链方法栈信息。
GetMultipleTrace获取多个调用链详情获取多个调用链的详情。
ConfigApp打开或关闭应用监控总开关打开或关闭应用监控的Agent总开关,或者查询Agent总开关的状态。
SaveTraceAppConfig应用监控自定义设置进行应用监控的自定义设置(如调用链采样设置、Agent开关等)。
DeleteTraceApp删除指定ID和类型的应用删除指定ID和类型的应用。
QueryReleaseMetric查看不同版本的指标查询EDAS和K8s应用发布过程中不同版本的指标。
ListTraceApps获取指定地域下全部应用监控任务的列表获取指定地域下全部应用监控任务的列表。
SearchTraceAppByName按应用名称查询应用监控任务按应用名称查询应用监控任务。
SearchTraceAppByPage分页查询应用监控任务分页查询应用监控任务。
SearchTraces查询调用链列表信息查询调用链列表信息,可根据时间、应用名称、IP地址、Span名称和Tag等信息筛选调用链。
SearchTracesByPage分页查询调用链列表信息分页查询调用链列表信息,可根据时间、应用名称、IP地址、Span名称和Tag等信息筛选调用链。
GetAgentDownloadUrl获取探针下载链接获取探针下载链接。
DescribeTraceLicenseKey列出LicenseKey列出LicenseKey。
ListInsightsEvents查询异常事件列表查询指定时间段内Insights的异常事件列表。
QueryAppMetadata查询编码映射内容根据ID和类型查询编码映射内容。
DeleteAppList批量删除应用根据应用监控PID列表,批量删除应用。

前端监控

API标题API概述
Upload上传SourceMap上传SourceMap到ARMS前端监控。
DeleteSourceMap删除SourceMap文件删除前端监控中上传的SourceMap文件。
GetSourceMapInfo获取SourceMap文件详细信息获取前端监控中上传的SourceMap文件详细信息。
CreateRetcodeApp创建前端监控任务创建前端监控任务。
GetRetcodeShareUrl获取前端监控站点的分享地址获取前端监控站点的分享地址。
DeleteRetcodeApp删除前端监控任务删除前端监控任务。
SetRetcodeShareStatus打开或关闭前端监控站点的免登录分享开关打开或关闭前端监控站点的免登录分享开关。
ListRetcodeApps列出所有前端监控任务列出指定地域下所有前端监控任务。
SearchRetcodeAppByPage分页查询前端监控任务分页查询前端监控任务。
GetRetcodeLogstore获取Project和Logstore获取指定账号下前端监控应用对应SLS存储的Project和Logstore。
GetRetcodeDataByQuery根据SLS查询语句获取前端监控数据根据SLS的查询语句查询前端监控的数据。
GetRetcodeAppByPid根据Pid获取前端监控应用根据前端监控应用Pid返回前端监控应用对象。

可观测监控 Prometheus 版

API标题API概述
CreateEnvironment创建环境创建环境实例。
InitEnvironment初始化环境实例初始化环境实例。
DescribeEnvironment查询环境详情查询环境详情。
UpdateEnvironment更新环境信息更新环境信息。
ListEnvironments查询环境列表查询环境列表。
DeleteEnvironment删除环境删除环境实例。
InstallEnvironmentFeature安装Feature安装Feature。
DescribeEnvironmentFeature查询Feature详情查询Feature详情。
UpgradeEnvironmentFeature更新Feature更新Feature信息。
RestartEnvironmentFeature重启Feature重启feature。
ListEnvironmentFeatures查询环境中的Feature查询环境中的Feature。
DeleteEnvironmentFeature删除feature删除feature。
CreateEnvCustomJob创建环境的自定义Job创建环境的自定义Job。
UpdateEnvCustomJob更新环境的自定义Job更新环境的自定义Job。
ListEnvCustomJobs查询环境的自定义Job列表查询环境的自定义Job列表。
DescribeEnvCustomJob查询环境CustomJob详情查询环境CustomJob详情。
DeleteEnvCustomJob删除环境的自定义Job删除环境的自定义job。
CreateEnvPodMonitor创建环境的PodMonitor创建环境的PodMonitor。
DescribeEnvPodMonitor查询环境的PodMonitor详情查询环境的PodMonitor详情。
ListEnvPodMonitors查询环境的PodMonitor列表查询环境的PodMonitor列表。
UpdateEnvPodMonitor更新环境的PodMonitor更新环境的PodMonitor。
DeleteEnvPodMonitor删除环境PodMonitor删除环境PodMonitor。
CreateEnvServiceMonitor创建环境的ServiceMonitor创建环境的ServiceMonitor。
DescribeEnvServiceMonitor查询环境的ServiceMonitor详情查询环境的ServiceMonitor详情。
ListEnvServiceMonitors查询环境的ServiceMonitor列表查询环境的ServiceMonitor列表。
UpdateEnvServiceMonitor更新环境的ServiceMonitor更新环境的ServiceMonitor。
DeleteEnvServiceMonitor删除环境ServiceMonitor删除环境ServiceMonitor。
InstallAddon安装Addon信息安装Addon信息。
DescribeAddonRelease查看AddonRelease详情通过名称查询AddonRelease详情。
UpgradeAddonRelease更新AddonRelease信息更新AddonRelease信息。
ListAddonReleases查询环境中安装的Addon查询环境中安装的Addon。
DeleteAddonRelease删除AddonRelease信息通过AddonRelease名称删除AddonRelease数据。
EnableMetric启用单个废弃指标启用废弃指标。
UpdatePrometheusMonitoringStatus更新Prometheus实例监控配置状态更新Prometheus实例监控配置状态。
UpdatePrometheusMonitoring更新Prometheus实例监控配置更新Prometheus实例监控配置。
ListPrometheusMonitoring查询Prometheus实例监控配置查询Prometheus实例监控配置。
GetPrometheusMonitoring查询Prometheus实例指定监控配置查询Prometheus实例指定监控配置。
DeletePrometheusMonitoring删除Prometheus实例监控配置删除Prometheus实例监控配置。
CreatePrometheusMonitoring创建Prometheus实例的监控配置创建Prometheus实例的监控配置。
AppendInstancesToPrometheusGlobalView新增Prometheus实例数据源增加ARMS Prometheus监控聚合实例中的数据源,将数据源添加到Prometheus聚合实例。
AddPrometheusInstance创建RemoteWrite类型的Prometheus实例创建RemoteWrite类型Prometheus实例。
AddPrometheusGlobalViewByAliClusterIds新增容器聚合实例增加ARMS Prometheus监控的聚合实例。
AddPrometheusGlobalView新增聚合实例增加ARMS Prometheus监控的聚合实例。
AddAliClusterIdsToPrometheusGlobalView新增聚合实例数据源增加ARMS Prometheus监控聚合实例的数据源。
AddRecordingRule创建RecordingRule创建或者更新Prometheus监控的RecordingRule规则。
SyncRecordingRules将某个集群的聚合规则批量同步到全Region的其他目标集群将某个集群的聚合规则批量同步到全Region的其他目标集群。
AddIntegration集成大盘及采集规则集成ARMS Prometheus监控的大盘以及采集规则。
GetIntegrationState获取Integration的接入状态来获取Integration的接入状态。
DeleteIntegration删除Integration接入的采集规则删除Integration接入的采集规则。
AddGrafana集成Prometheus监控大盘集成ARMS Prometheus监控的大盘。
InstallCmsExporter安装云服务采集器安装云服务采集器。
OpenVCluster开通虚拟集群开通虚拟集群。
DeletePrometheusGlobalView删除Prometheus聚合实例删除Prometheus聚合实例。
RemoveAliClusterIdsFromPrometheusGlobalView删除聚合实例数据源移除ARMS Prometheus监控聚合实例的某些数据源。
RemoveSourcesFromPrometheusGlobalView删除聚合实例非阿里数据源移除ARMS Prometheus监控聚合实例中的数据源,仅支持删除非阿里数据源。
DeleteCmsExporter卸载Prometheus for 云服务实例来卸载Prometheus for 云服务实例。
DelAuthToken关闭鉴权token关闭鉴权token。
DeleteGrafanaResource删除集群的大盘资源删除ARMS Prometheus监控集群中的Grafana大盘资源。
UninstallPromCluster卸载prometheus集群来卸载ARMS Prometheus集群实例。
ManageRecordingRule修改聚合规则编辑ARMS Prometheus的RecordingRule聚合规则。
QueryPromInstallStatus查询集群安装状态来查询ARMS Prometheus集群的安装状态。
ListPrometheusGlobalView获取聚合实例列表增加ARMS Prometheus监控的聚合实例,获取聚合实例列表。
GetPrometheusGlobalView获取聚合实例的数据源详情增加ARMS Prometheus监控的聚合实例,获取指定聚合实例的详细数据源情况。
ManageGetRecordingRule获取聚合规则获取ARMS Prometheus的RecordingRule聚合规则。
CheckServiceStatus检查产品开通状态检查集群当前的服务状态,例如是否开通服务,是否欠费等。
GetPrometheusApiToken获取Prometheus监控所需Token获取集成ARMS Prometheus监控所需的Token。
GetExploreUrl获取Grafana的Explore功能获取使用Grafana的Explore功能。
ListDashboards获取集群的大盘列表获取集群的Grafana大盘的列表。
ListClusterFromGrafana列出指定地域下的所有Grafana大盘列出指定地域下的所有Grafana大盘。
GetRecordingRule获取聚合规则获取集群的RecordingRule聚合规则。
ListCmsInstances查询云服务采集状态查询云服务采集状态。
ListDashboardsByName创建Loki数据源和相关的多数据源大盘来创建与Prometheus关联的Loki数据源和相关的多数据源大盘。
GetAuthToken获取公网读写鉴权获取公网读写鉴权Token。
GetClusterAllUrl获取集群所有地址获取集群所有地址。包括远程读写地址、 Push Gateway地址、 Grafana地址。
GetCloudClusterAllUrl获取云产品各种URL获取云监控云产品读写地址,pushgateway,grafana 地址。
ListPrometheusInstances获取所有正常实例获取Prometheus的所有正常实例。
AddPrometheusRemoteWrite增加Prometheus实例的Remote Write配置增加Prometheus实例(仅支持aliyun-cs、ecs两种类型的实例)Remote Write配置。
UpdatePrometheusRemoteWrite更新Prometheus实例remoteWrite配置编辑Prometheus实例(仅支持aliyun-cs、ecs两种类型的实例)指定RemoteWrite配置。
ListPrometheusRemoteWrites查询Prometheus实例的Remote Write配置列表查询Prometheus实例(仅支持aliyun-cs、ecs两种类型的实例)Remote Write配置列表。
GetPrometheusRemoteWrite查询Prometheus实例的指定Remote Write配置项查询Prometheus实例(仅支持aliyun-cs、ecs两种类型的实例)的指定Remote Write配置项。
DeletePrometheusRemoteWrite删除Prometheus实例的RemoteWrite配置项删除Prometheus实例Remote Write配置项(仅支持aliyun-cs、ecs两种类型的实例)。
InstallManagedPrometheus创建托管Prometheus创建托管(ASK/ECS)Prometheus。
UninstallManagedPrometheus卸载托管Prometheus卸载托管(ASK/ECS/ACKoNE)Prometheus。
GetManagedPrometheusStatus获取托管版Prometheus安装状态获取托管版(ask、ecs和one)Prometheus实例的安装状态。
BindPrometheusGrafanaInstance绑定Prometheus实例使用的Grafana工作区ID绑定Prometheus实例使用的Grafana工作区ID。
AddPrometheusIntegration增加Prometheus实例的集成中心Exporter实例增加Prometheus实例的集成中心Exporter实例(仅支持aliyun-cs、ecs两种类型的实例)。
UpdatePrometheusIntegration更改Prometheus实例集成中心Exporter配置更改Prometheus实例(仅支持aliyun-cs、ecs两种类型的实例)集成中心Exporter配置。
DeletePrometheusIntegration删除Prometheus实例集成中心Exporter实例删除Prometheus实例集成中心Exporter实例(仅支持aliyun-cs、ecs两种类型的实例)。
GetPrometheusIntegration获取Prometheus实例指定集成中心Exporter实例获取Prometheus实例(仅支持aliyun-cs、ecs两种类型的实例)指定集成中心Exporter实例。
ListPrometheusIntegration查询Prometheus实例集成中心Exporter实例列表查询Prometheus实例(仅支持aliyun-cs、ecs两种类型的实例)集成中心Exporter实例列表。
GetPrometheusInstance获取指定Prometheus实例信息获取指定Prometheus实例信息。
ListPrometheusInstanceByTagAndResourceGroupId根据标签和资源组查询Prometheus实例根据标签和资源组查询Prometheus实例。
CreatePrometheusInstance新建Prometheus实例新建Prometheus实例。
UpdatePrometheusGlobalView更新Prometheus for GlobalView聚合数据源更新Prometheus for GlobalView聚合数据源。

可观测可视化 Grafana 版

API标题API概述
ListGrafanaWorkspace获取Grafana工作区列表获取地域内Grafana工作区列表。

云拨测(新版)

API标题API概述
CreateTimingSyntheticTask创建定时拨测任务创建定时拨测任务(新版)。
UpdateTimingSyntheticTask更新定时拨测任务更新定时拨测任务。
StopTimingSyntheticTask停止定时拨测任务停止定时拨测任务。
StartTimingSyntheticTask启动定时拨测任务启动定时拨测任务。
DeleteTimingSyntheticTask删除定时拨测任务删除定时拨测任务。
GetSyntheticMonitors获取拨测点获取拨测点。
ListTimingSyntheticTasks获取定时拨测任务列表获取定时拨测任务列表。
GetTimingSyntheticTask获取拨测任务详情获取任务详情。

云拨测(旧版)

API标题API概述
CreateSyntheticTask创建或更新云拨测任务创建或更新云拨测定时任务。
GetSyntheticTaskMonitors获取拨测点信息获取拨测点信息。
SwitchSyntheticTaskStatus启停拨测任务启动或者停止定时拨测任务。
GetSyntheticTaskList获取拨测任务列表获取云拨测定时任务列表。
GetSyntheticTaskDetail获取定时拨测任务的详情根据任务ID获取定时拨测任务的详情。
DeleteSyntheticTask删除拨测任务删除云拨测定时任务。

告警管理(新版)

API标题API概述
CreateIntegration创建告警集成创建告警集成。
UpdateIntegration修改集成相关信息修改集成相关信息。
DeleteIntegrations删除指定告警集成删除指定告警集成。
ListIntegration查看集成列表详情查看集成列表详情。
CreateOrUpdateAlertRule创建或修改告警规则创建或修改告警规则。
DeleteAlertRule删除告警规则删除告警规则。
ListAlertEvents查询告警事件历史查询告警事件历史。
GetAlertRules获取已经创建的告警规则查询已经创建的告警规则。
CreateOrUpdateContact创建或修改联系人创建或者修改告警联系人。
SendTTSVerifyLink告警联系人发送手机号码验证为告警联系人发送手机号码验证短信。
DeleteContact删除告警联系人删除告警联系人。
DescribeContacts查询告警联系人列表查询告警联系人列表。
CreateOrUpdateContactGroup创建或修改告警联系人组创建或修改告警联系人组。
DeleteContactGroup删除告警联系人组删除告警联系人组。
DescribeContactGroups查询告警联系人分组信息查询告警联系人分组信息。
CreateOrUpdateIMRobot创建或更新IM机器人创建或更新IM机器人。
DeleteIMRobot删除IM机器人删除IM机器人。
DescribeIMRobots查询IM机器人列表查询IM机器人列表。
CreateOrUpdateWebhookContact创建或修改Webhook告警联系人创建或修改Webhook告警联系人。
DeleteWebhookContact删除Webhook告警联系人删除Webhook告警联系人。
DescribeWebhookContacts查询Webhook告警联系人列表查询Webhook告警联系人列表。
CreateOrUpdateEventBridgeIntegration创建或修改EventBridge通知集成创建或修改EventBridge通知集成。
DeleteEventBridgeIntegration删除EventBridge通知集成删除EventBridge通知集成。
ListEventBridgeIntegrations查询EventBridge通知集成信息查询EventBridge通知集成信息。
CreateOrUpdateNotificationPolicy新增及修改通知策略创建或更新通知策略。
DeleteNotificationPolicy删除通知策略根据通知策略ID删除通知策略。
ListNotificationPolicies查询通知策略信息通过指定条件查询通知策略信息。
CreateOrUpdateSilencePolicy新增及修改静默策略创建或修改静默策略。
DeleteSilencePolicy删除静默策略调用DeleteSilencePolicy接口根据静默策略ID删除静默策略。
ListEscalationPolicies查询升级策略信息调用ListEscalationPolicies接口查询升级策略信息。
ListOnCallSchedules查询排班策略调用ListOnCallSchedules接口查询排班策略信息。
GetOnCallSchedulesDetail查询排班策略信息调用GetOnCallSchedulesDetail接口查询排班策略信息。
ListSilencePolicies静默策略列表信息调用ListSilencePolicies接口查询静默策略列表信息。
ListAlerts查询告警发送历史调用ListAlerts接口查询告警发送历史。
BlockAlarmNotification屏蔽告警通知屏蔽告警通知,屏蔽后告警在指定的时间范围内不再发生通知。
ChangeAlarmSeverity修改告警等级修改告警等级。
CloseAlarm关闭告警关闭告警,请确保告警恢复后再关闭告警。如果告警一直处于触发状态,关闭告警后又会产生新的告警。
ClaimAlarm认领告警认领告警,配合升级策略使用。 在告警协同处理时可以,认领后表示该告警正在处理中。

Prometheus报警规则(旧版)

API标题API概述
CreatePrometheusAlertRule创建告警规则创建告警规则。
DeletePrometheusAlertRule删除告警规则删除Prometheus告警规则。
UpdatePrometheusAlertRule 更新告警规则调用UpdatePrometheusAlertRule接口更新Prometheus报警规则。
DescribePrometheusAlertRule查看告警规则查看Prometheus告警规则。
ListPrometheusAlertRules查看告警规则列表查看Prometheus告警规则列表。
ListPrometheusAlertTemplates查看告警模板列表调用ListPrometheusAlertTemplates接口查看Prometheus告警模板列表。

报警(旧版)

API标题API概述
CreateAlertContact创建报警联系人创建报警联系人。
CreateWebhook创建Webhook告警联系人调用CreateWebhook接口创建Webhook告警联系人。
CreateAlertContactGroup创建报警联系人分组调用CreateAlertContactGroup接口创建报警联系人分组。
CreateDispatchRule创建分派策略创建分派策略。
ListActivatedAlerts查询已经触发的告警列表调用ListActivatedAlerts接口查询已经触发的告警列表。
ImportAppAlertRules创建应用报警规则调用ImportAppAlertRules接口创建应用报警规则。
DeleteAlertRules删除报警规则调用DeleteAlertRules接口删除报警规则。
DeleteAlertContact删除报警联系人调用DeleteAlertContact接口删除报警联系人。
DeleteAlertContactGroup删除报警联系人分组调用DeleteAlertContactGroup接口删除报警联系人分组。
DeleteDispatchRule删除指定ID的通知策略加快删除指定ID的告警通知策略。
UpdateWebhook更新Webhook联系人调用UpdateWebhook接口修改Webhook告警联系人信息。
UpdateAlertContact更新报警联系人调用UpdateAlertContact接口更新报警联系人。
UpdateAlertContactGroup更新报警联系人分组调用UpdateAlertContactGroup接口更新报警联系人分组。
UpdateAlertRule更新监控告警规则调用UpdateAlertRule接口更新报警规则。
StartAlert启动报警规则调用StartAlert接口启动报警规则。
StopAlert停止报警规则调用StartAlert接口停止报警规则。
UpdateDispatchRule修改分派策略调用UpdateDispatchRule接口修改分派策略。
SearchAlertRules查询报警规则调用SearchAlertRules接口查询报警规则。
SearchAlertContact查询报警联系人调用SearchAlertContact接口查询报警联系人。
SearchAlertContactGroup查询报警联系人分组调用SearchAlertContactGroup接口查询报警联系人分组。
SearchAlertHistories查询报警规则的报警发送记录调用SearchAlertHistories接口查询报警规则的报警发送记录。
SearchEvents查询报警事件记录调用SearchEvents接口查询报警事件记录。
DescribeDispatchRule查询分派策略信息调用DescribeDispatchRule接口查询分派策略信息。
ListDispatchRule获取调度规则列表调用ListDispatchRule接口查询通知策略列表。

访问控制

API标题API概述
OpenArmsServiceSecondVersion开通ARMS开通ARMS下指定子产品的后付费功能。
OpenXtraceDefaultSLR开通可观测链路 OpenTelemetry 版服务关联角色开通可观测链路 OpenTelemetry 版服务关联角色AliyunServiceRoleForXtrace。
OpenArmsDefaultSLR开通ARMS服务关联角色开通ARMS服务关联角色AliyunServiceRoleForARMS。
ChangeResourceGroupARMS资源转组API修改资源所属资源组。
TagResources创建标签资源关系用于给ARMS资源实例打标签。
UntagResources删除标签资源关系用于删除ARMS资源实例标签。

其他

API标题API概述
GetCommercialStatus获取商业化状态获取商业化状态。
CheckCommercialStatus检查产品商业化状态检查产品的商业化开通状态。
QueryCommercialUsage查询可观测用量数据查询写入量数据,支持应用监控、可观测链路OpenTelemetry版、Prometheus、用户体验监控四大产品用量数据。
UpdateMetricDrop更新废弃指标列表更新废弃指标列表。
阿里云首页 应用实时监控服务ARMS 相关技术圈