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用于指定查询的指标。Java SDK代码示例如下：
//设置Metric名称。
request.setMetric("<MetricName>");
Metric分为非计量类以及计量类指标两大类：
- 非计量类指标
层级 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 跨区域复制流入计量流量 字节
