自定义监控上报数据

最近更新时间: 2025-04-01 17:27:12

1. 接口描述

接口请求域名: monitor.api3.gsesgpucloud.com。

默认接口请求频率限制:50次/秒。 默认单租户指标上限:100个。 单次上报最多 30 个指标/值对,请求返回错误时,请求中所有的指标/值均不会被保存。

上报的时间戳为期望保存的时间戳,建议构造整数分钟时刻的时间戳。 时间戳时间范围必须为当前时间到 300 秒前之间。 同一 IP 指标对的数据需按分钟先后顺序上报。

默认接口请求频率限制:50次/秒。

接口更新时间:2019-12-13 19:17:02。

接口只验签名不鉴权。

2. 输入参数

以下请求参数列表仅列出了接口请求参数和部分公共参数,完整公共参数列表见公共请求参数

参数名称 必选 允许NULL 类型 描述
Action String 公共参数,本接口取值:PutMonitorData
Version String 公共参数,本接口取值:2018-07-24
Region String 公共参数,地域信息可通过DescribeRegions接口查看产品支持的地域列表
AnnounceIp String 上报时自行指定的 IP
示例值:
AnnounceTimestamp Uint64 上报时自行指定的时间戳
示例值:
Metrics Array of MetricDatum 一组指标和数据
示例值:查看
AnnounceInstance String 上报时自行指定的 IP 或 产品实例ID
示例值:

3. 输出参数

参数名称 类型 描述
RequestId String 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。

4. 错误码

以下仅列出了接口业务逻辑相关的错误码,其他错误码详见公共错误码

错误码 描述
InvalidParameterValue 无效的参数值。
InternalError 内部错误。
InvalidParameter.InvalidParameterParam 参数错误。
InvalidParameter.InvalidParameter 参数错误。
InvalidParameter 参数错误。
InternalError.ExeTimeout 执行超时。
FailedOperation 操作失败。
MissingParameter 缺少参数错误。
UnknownParameter 未知参数错误。
UnauthorizedOperation 未授权操作。
UnsupportedOperation 操作不支持。
ResourceNotFound 资源不存在。
LimitExceeded 超过配额限制。
ResourceUnavailable 资源不可用。
FailedOperation 操作失败。
DryRunOperation DryRun 操作,代表请求将会是成功的,只是多传了 DryRun 参数。
LimitExceeded.MetricQuotaExceeded 指标数量达到配额限制,禁止含有未注册指标的请求。
FailedOperation.ServiceNotEnabled 服务未启用,开通服务后方可使用。