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 | 跨區域復制流入計量流量 | 字節 |