OSS监控服务为您提供系统基本运行状态、性能以及计量等方面的监控数据指标,帮助您跟踪请求、分析使用情况、统计业务趋势,及时发现以及诊断系统的相关问题。本文介绍如何使用云监控服务提供的API或SDK查询OSS监控数据。

说明 云监控服务SDK示例,请参见Java SDK使用手册

Space

Space用于指定监控的云服务。OSS监控服务使用的Namespace为acs_oss_dashboard

例如,通过Java SDK指定监控OSS服务的示例代码如下:
DescribeMetricListRequest request = new DescribeMetricListRequest();
request.setNamespace("acs_oss_dashboard");

StartTime和EndTime

StartTime和EndTime用于指定查询监控数据的时间范围。云监控的时间参数取值范围采用左开右闭的形式(StartTime, EndTime],即可以查询StartTime到EndTime之间的数据(包含EndTime的数据)。StartTime和EndTime的时间间隔不能大于31天,且无法查询31天以前的数据。

例如,通过Java SDK指定查询监控数据时间范围的示例代码如下:
//设置监控数据的结束时间。
request.setEndTime("2019-05-13 11:06:27");
//设置监控数据的开始时间。
request.setStartTime("2019-05-13 10:20:27");

Dimensions

Dimensions用于指定待查询的Bucket。不指定Dimensions时,表示查询用户层级数据。层级说明请参见Metric

例如,通过Java SDK查询Bucket数据的示例代码如下:
//填写待查询数据的Bucket名称。
request.setDimensions("{\"BucketName\":\"<yourBucketName>\"}");

Period

Period用于指定指标项的查询周期。OSS监控的计量类指标查询周期为3600s,其他所有指标的查询周期均为60s。各指标项的说明,请参见Metric

例如,通过Java SDK监控某个非计量类指标的示例代码如下:
request.setPeriod("60");

Metric

Metric用于指定查询的指标。Metric分为非计量类以及计量类指标。Java SDK代码示例如下:

//设置Metric名称。
request.setMetric("<MetricName>");

非计量类指标

非计量类指标仅用于统计监控数据。

层级 Metric 对应指标项名称 单位
用户层级 UserAvailability 可用性 %
UserRequestValidRate 有效请求率 %
UserTotalRequestCount 总请求数 次数
UserValidRequestCount 有效请求数 次数
UserInternetSend 公网流出流量 字节
UserInternetRecv 公网流入流量 字节
UserIntranetSend 内网流出流量 字节
UserIntranetRecv 内网流入流量 字节
UserCdnSend CDN流出流量 字节
UserCdnRecv CDN流入流量 字节
UserSyncSend 跨区域复制流出流量 字节
UserSyncRecv 跨区域复制流入流量 字节
UserServerErrorCount 服务端错误请求总数 次数
UserServerErrorRate 服务端错误请求占比 %
UserNetworkErrorCount 网络错误请求总数 次数
UserNetworkErrorRate 网络错误请求占比 %
UserAuthorizationErrorCount 客户端授权错误请求总数 次数
UserAuthorizationErrorRate 客户端授权错误请求占比 %
UserResourceNotFoundErrorCount 客户端资源不存在错误请求总数 次数
UserResourceNotFoundErrorRate 客户端资源不存在错误请求占比 %
UserClientTimeoutErrorCount 客户端超时错误请求总数 次数
UserClientOtherErrorRate 客户端超时错误请求占比 %
UserClientOtherErrorCount 客户端其他错误请求总数 次数
UserClientOtherErrorRate 客户端其他错误请求占比 %
UserSuccessCount 成功请求总数 次数
UserSuccessRate 成功请求占比 %
UserRedirectCount 重定向请求总数 次数
UserRedirectRate 重定向请求占比 %
Bucket层级 Availability 可用性 %
RequestValidRate 有效请求率 %
TotalRequestCount 总请求数 次数
ValidRequestCount 有效请求数 次数
InternetSend 公网流出流量 字节
InternetRecv 公网流入流量 字节
IntranetSend 内网流出流量 字节
IntranetRecv 内网流入流量 字节
InternetSendBandwidth 公网流出带宽 bps
InternetRecvBandwidth 公网流入带宽 bps
IntranetSendBandwidth 内网流出带宽 bps
IntranetRecvBandwidth 内网流入带宽 bps
CdnSend CDN流出流量 字节
CdnRecv CDN流入流量 字节
SyncSend 跨区域复制流出流量 字节
SyncRecv 跨区域复制流入流量 字节
ServerErrorCount 服务端错误请求总数 次数
ServerErrorRate 服务端错误请求占比 %
NetworkErrorCount 网络错误请求总数 次数
NetworkErrorRate 网络错误请求占比 %
AuthorizationErrorCount 客户端授权错误请求总数 次数
AuthorizationErrorRate 客户端授权错误请求占比 %
ResourceNotFoundErrorCount 客户端资源不存在错误请求总数 次数
ResourceNotFoundErrorRate 客户端资源不存在错误请求占比 %
ClientTimeoutErrorCount 客户端超时错误请求总数 次数
ClientTimeoutErrorRate 客户端超时错误请求占比 %
ClientOtherErrorCount 客户端其他错误请求总数 次数
ClientOtherErrorRate 客户端其他错误请求占比 %
SuccessCount 成功请求总数 次数
SuccessRate 成功请求占比 %
RedirectCount 重定向请求总数 次数
RedirectRate 重定向请求占比 %
GetObjectE2eLatency GetObject请求平均E2E延时 毫秒
GetObjectServerLatency GetObject请求平均服务器延时 毫秒
MaxGetObjectE2eLatency GetObject请求最大E2E延时 毫秒
MaxGetObjectServerLatency GetObject请求最大服务器延时 毫秒
HeadObjectE2eLatency HeadObject请求平均E2E延时 毫秒
HeadObjectServerLatency HeadObject请求平均服务器延时 毫秒
MaxHeadObjectE2eLatency HeadObject请求最大E2E延时 毫秒
MaxHeadObjectServerLatency HeadObject请求最大服务器延时 毫秒
PutObjectE2eLatency PutObject请求平均E2E延时 毫秒
PutObjectServerLatency PutObject请求平均服务器延时 毫秒
MaxPutObjectE2eLatency PutObject请求最大E2E延时 毫秒
MaxPutObjectServerLatency PutObject请求最大服务器延时 毫秒
PostObjectE2eLatency PostObject请求平均E2E延时 毫秒
PostObjectServerLatency PostObject请求平均服务器延时 毫秒
MaxPostObjectE2eLatency PostObject请求最大E2E延时 毫秒
MaxPostObjectServerLatency PostObject请求最大服务器延时 毫秒
AppendObjectE2eLatency AppendObject请求平均E2E延时 毫秒
AppendObjectServerLatency AppendObject请求平均服务器延时 毫秒
MaxAppendObjectE2eLatency AppendObject请求最大E2E延时 毫秒
MaxAppendObjectServerLatency AppendObject请求最大服务器延时 毫秒
UploadPartE2eLatency UploadPart请求平均E2E延时 毫秒
UploadPartServerLatency UploadPart请求平均服务器延时 毫秒
MaxUploadPartE2eLatency UploadPart请求最大E2E延时 毫秒
MaxUploadPartServerLatency UploadPart请求最大服务器延时 毫秒
UploadPartCopyE2eLatency UploadPartCopy请求平均E2E延时 毫秒
UploadPartCopyServerLatency UploadPartCopy请求平均服务器延时 毫秒
MaxUploadPartCopyE2eLatency UploadPartCopy请求最大E2E延时 毫秒
MaxUploadPartCopyServerLatency UploadPartCopy请求最大服务器延时 毫秒
GetObjectCount GetObject成功请求数 次数
HeadObjectCount HeadObject成功请求数 次数
PutObjectCount PutObject成功请求数 次数
PostObjectCount PostObject成功请求数 次数
AppendObjectCount AppendObject成功请求数 次数
UploadPartCount UploadPart成功请求数 次数
UploadPartCopyCount UploadPartCopy成功请求数 次数
DeleteObjectCount DeleteObject成功请求数 次数
DeleteObjectsCount DeleteObjects成功请求数 次数

计量类指标

查询以下Metric时如果指定了Dimensions,则表示查询的是Bucket层级的数据。如果未指定Dimensions,则表示查询的是用户层级的数据。

说明 为了与计费策略保持统一,计量指标的收集和展示存在一定的特殊性。更多信息,请参见计量指标相关说明
Metric 对应指标项名称 单位
MeteringStorageUtilization 存储大小 字节
MeteringGetRequest Get类请求数 次数
MeteringPutRequest Put类请求数 次数
MeteringInternetTX 公网流出计量流量 字节
MeteringCdnTX CDN流出计量流量 字节
MeteringSyncRX 跨区域复制流入计量流量 字节