本章內容為OpenAPI(或者Cloud Monitor提供的SDK)查詢OSS監控服務指標數據的使用提供相關參數依據。
關於Project
OSS監控服務指標項的數據都使用相同的Project名稱:acs_oss。
使用Java SDK設定程式碼範例如下:
QueryMetricRequest request = new QueryMetricRequest();
request.setProject("acs_oss");
關於StartTime和EndTime
Cloud Monitor的時間參數取值範圍採用左開右閉的形式,即(StartTime, EndTime],即StartTime的數據不會被查詢到,而EndTime的數據會被查詢到。
另外,Cloud Monitor數據保留時間為31天,設定的StartTime和EndTime的時間間距不能大於31天,並且不能夠查詢31天以前的數據。
其他時間參數資訊詳見Cloud MonitorAPI參考。
使用Java SDK設定程式碼範例如下:
request.setStartTime("2016-05-15 08:00:00");
request.setEndTime("2015-05-15 09:00:00");
關於Dimensions
OSS監控服務根據用戶使用場景,將監控項分為用戶和Bucket兩個不同的層級進行監控。針對不同的層級監控數據的訪問,Dimensions不同:
- 用戶層級數據不需要設定Dimensions。
- Bucket層級數據的Dimensions設定為:
{"BucketName": "your_bucket_name"}
其中,your_bucket_name為屬於該用戶的某個需要查詢的Bucket名稱。
注意,Dimenisons是一個JSON字元串,OSS監控指標的Dimensions只有一對Key-Value。
使用Java SDK設定程式碼範例如下:request.setDimensions("{\"BucketName\":\"your_bucket_name\"}");
關於Period
OSS監控指標除了計量指標,其他所有的指標的彙總粒度均為60s。計量指標的彙總粒度為3600s。
使用Java SDK設定程式碼範例如下:
request.setPeriod("60");
關於Metric
OSS監控指標參考中詳細介紹的各項指標項對應的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 | 用戶層級重新導向請求佔比 | % | 用戶層級 |
Availability | 可用性 | % | Bucket層級 |
RequestValidRate | 有效請求率 | % | Bucket層級 |
TotalRequestCount | 總請求數 | 次數 | Bucket層級 |
ValidRequestCount | 有效請求數 | 次數 | Bucket層級 |
InternetSend | 公網流出流量 | 位元組 | Bucket層級 |
InternetRecv | 公網流入流量 | 位元組 | Bucket層級 |
IntranetSend | 內網流出流量 | 位元組 | Bucket層級 |
IntranetRecv | 內網流入流量 | 位元組 | Bucket層級 |
CdnSend | cdn流出流量 | 位元組 | Bucket層級 |
CdnRecv | cdn流入流量 | 位元組 | Bucket層級 |
SyncSend | 跨區域複製流出流量 | 位元組 | Bucket層級 |
SyncRecv | 跨區域複製流入流量 | 位元組 | Bucket層級 |
ServerErrorCount | 服務端錯誤請求總數 | 次數 | Bucket層級 |
ServerErrorRate | 服務端錯誤請求佔比 | % | Bucket層級 |
NetworkErrorCount | 網路錯誤請求總數 | 次數 | Bucket層級 |
NetworkErrorRate | 網路錯誤請求佔比 | % | Bucket層級 |
AuthorizationErrorCount | 客戶端授權錯誤請求總數 | 次數 | Bucket層級 |
AuthorizationErrorRate | 客戶端授權錯誤請求佔比 | % | Bucket層級 |
ResourceNotFoundErrorCount | 客戶端資源不存在錯誤請求總數 | 次數 | Bucket層級 |
ResourceNotFoundErrorRate | 客戶端資源不存在錯誤請求佔比 | % | Bucket層級 |
ClientTimeoutErrorCount | 客戶端逾時錯誤請求總數 | 次數 | Bucket層級 |
ClientOtherErrorRate | 客戶端逾時錯誤請求佔比 | % | Bucket層級 |
ClientOtherErrorCount | 客戶端其他錯誤請求總數 | 次數 | Bucket層級 |
ClientOtherErrorRate | 客戶端其他錯誤請求佔比 | % | Bucket層級 |
SuccessCount | 成功請求總數 | 次數 | Bucket層級 |
SuccessRate | 成功請求佔比 | % | Bucket層級 |
RedirectCount | 重新導向請求總數 | 次數 | Bucket層級 |
RedirectRate | 重新導向請求佔比 | % | Bucket層級 |
GetObjectE2eLatency | GetObject請求平均E2E延時 | 毫秒 | Bucket層級 |
GetObjectServerLatency | GetObject請求平均伺服器延時 | 毫秒 | Bucket層級 |
MaxGetObjectE2eLatency | GetObject請求最大E2E延時 | 毫秒 | Bucket層級 |
MaxGetObjectServerLatency | GetObject請求最大伺服器延時 | 毫秒 | Bucket層級 |
HeadObjectE2eLatency | HeadObject請求平均E2E延時 | 毫秒 | Bucket層級 |
HeadObjectServerLatency | HeadObject請求平均伺服器延時 | 毫秒 | Bucket層級 |
MaxHeadObjectE2eLatency | HeadObject請求最大E2E延時 | 毫秒 | Bucket層級 |
MaxHeadObjectServerLatency | HeadObject請求最大伺服器延時 | 毫秒 | Bucket層級 |
PutObjectE2eLatency | PutObject請求平均E2E延時 | 毫秒 | Bucket層級 |
PutObjectServerLatency | PutObject請求平均伺服器延時 | 毫秒 | Bucket層級 |
MaxPutObjectE2eLatency | PutObject請求最大E2E延時 | 毫秒 | Bucket層級 |
MaxPutObjectServerLatency | PutObject請求最大伺服器延時 | 毫秒 | Bucket層級 |
PostObjectE2eLatency | PostObject請求平均E2E延時 | 毫秒 | Bucket層級 |
PostObjectServerLatency | PostObject請求平均伺服器延時 | 毫秒 | Bucket層級 |
MaxPostObjectE2eLatency | PostObject請求最大E2E延時 | 毫秒 | Bucket層級 |
MaxPostObjectServerLatency | PostObject請求最大伺服器延時 | 毫秒 | Bucket層級 |
AppendObjectE2eLatency | AppendObject請求平均E2E延時 | 毫秒 | Bucket層級 |
AppendObjectServerLatency | AppendObject請求平均伺服器延時 | 毫秒 | Bucket層級 |
MaxAppendObjectE2eLatency | AppendObject請求最大E2E延時 | 毫秒 | Bucket層級 |
MaxAppendObjectServerLatency | AppendObject請求最大伺服器延時 | 毫秒 | Bucket層級 |
UploadPartE2eLatency | UploadPart請求平均E2E延時 | 毫秒 | Bucket層級 |
UploadPartServerLatency | UploadPart請求平均伺服器延時 | 毫秒 | Bucket層級 |
MaxUploadPartE2eLatency | UploadPart請求最大E2E延時 | 毫秒 | Bucket層級 |
MaxUploadPartServerLatency | UploadPart請求最大伺服器延時 | 毫秒 | Bucket層級 |
UploadPartCopyE2eLatency | UploadPartCopy請求平均E2E延時 | 毫秒 | Bucket層級 |
UploadPartCopyServerLatency | UploadPartCopy請求平均伺服器延時 | 毫秒 | Bucket層級 |
MaxUploadPartCopyE2eLatency | UploadPartCopy請求最大E2E延時 | 毫秒 | Bucket層級 |
MaxUploadPartCopyServerLatency | UploadPartCopy請求最大伺服器延時 | 毫秒 | Bucket層級 |
GetObjectCount | GetObject成功請求數 | 次數 | Bucket層級 |
HeadObjectCount | HeadObject成功請求數 | 次數 | Bucket層級 |
PutObjectCount | PutObject成功請求數 | 次數 | Bucket層級 |
PostObjectCount | PostObject成功請求數 | 次數 | Bucket層級 |
AppendObjectCount | AppendObject成功請求數 | 次數 | Bucket層級 |
UploadPartCount | UploadPart成功請求數 | 次數 | Bucket層級 |
UploadPartCopyCount | UploadPartCopy成功請求數 | 次數 | Bucket層級 |
DeleteObjectCount | DeleteObject成功請求數 | 次數 | Bucket層級 |
DeleteObjectsCount | DeleteObjects成功請求數 | 次數 | Bucket層級 |
計量類指標的Metric如下表所示,注意彙總粒度為3600s。
Metric | 對應指標項名稱 | 單位 | 層級 |
---|---|---|---|
MeteringStorageUtilization | 儲存大小 | 位元組 | 若設定Dimensions,則為Bucket層級;如果不設定,那麼返回的指標為整個用戶層級數據。 |
MeteringGetRequest | Get類請求數 | 次數 | 若設定Dimensions,則為Bucket層級;如果不設定,那麼返回的指標為整個用戶層級數據。 |
MeteringPutRequest | Put類請求數 | 次數 | 若設定Dimensions,則為Bucket層級;如果不設定,那麼返回的指標為整個用戶層級數據。 |
MeteringInternetTX | 公網流出計量流量 | 位元組 | 若設定Dimensions,則為Bucket層級;如果不設定,那麼返回的指標為整個用戶層級數據。 |
MeteringCdnTX | cdn流出計量流量 | 位元組 | 若設定Dimensions,則為Bucket層級;如果不設定,那麼返回的指標為整個用戶層級數據。 |
MeteringSyncRX | 跨區域複製流入計量流量 | 位元組 | 若設定Dimensions,則為Bucket層級;如果不設定,那麼返回的指標為整個用戶層級數據。 |
使用Java SDK設定程式碼範例如下:
request.setMetric("UserAvailability");