本章內容為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");