OSS监控服务为您提供系统基本运行状态、性能以及计量等方面的监控数据指标，帮助您跟踪请求、分析使用情况、统计业务趋势，及时发现以及诊断系统的相关问题。本文介绍如何使用云监控服务提供的API或SDK查询OSS监控数据。
云监控服务SDK示例，请参见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时，表示查询账号级别下各个Bucket的指标数据。层级说明请参见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>");您可以访问云监控指标，查看OSS的所有指标信息。
非计量类指标
非计量类指标仅用于统计监控数据。
层级 | 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成功请求数 | 次数 | |
MirrorTraffic | 指定回源源站的正常请求流入流量 | 字节 | |
MirrorTrafficByStatus | 指定返回值和回源源站的请求流入流量 | 字节 | |
MirrorRequestTransferSpeed | 指定回源源站的正常请求平均传输速度 | 字节/秒 | |
MirrorRequestTransferSpeedByStatus | 指定返回值和回源源站的请求平均传输速度 | 字节/秒 | |
MirrorRequestCount | 指定回源源站的正常请求总数 | 次数 | |
MirrorRequestCountByStatus | 指定返回值和回源源站的请求总数 | 次数 | |
MirrorAverageLatency | 指定回源源站的正常请求平均延时 | 毫秒 | |
MirrorAverageLatencyByStatus | 指定返回值和回源源站的请求平均延时 | 毫秒 | |
MirrorRequestStatusRatio | 指定回源源站的状态码2xx、3xx、4xx、5xx所占总请求量的百分比 | % | |
MirrorRequestStatusCount | 指定回源源站的状态码2xx、3xx、4xx、5xx的请求数量 | 次数 |
计量类指标
查询以下Metric时如果指定了Dimensions，则表示查询的是指定Bucket的数据。如果未指定Dimensions，则表示查询账号级别下各个Bucket的数据。
为了与计费策略保持统一，计量指标的收集和展示存在一定的特殊性。更多信息，请参见计量指标相关说明。
Metric | 对应指标项名称 | 单位 |
MeteringStorageUtilization | 存储大小 | 字节 |
MeteringGetRequest | Get类请求数 | 次数 |
MeteringPutRequest | Put类请求数 | 次数 |
MeteringInternetTX | 公网流出计量流量 | 字节 |
MeteringCdnTX | CDN流出计量流量 | 字节 |
MeteringSyncRX | 跨区域复制流入计量流量 | 字节 |