CloudMonitorは、OSS (Object Storage Service) のシステムステータス、パフォーマンス、および計測を監視するためのさまざまなメトリクスを提供します。 モニタリングメトリクスを使用して、リクエストの追跡、使用状況の分析、ビジネストレンドに関する統計の収集、システムの問題の特定と解決を可能にします。 このトピックでは、CloudMonitor APIまたはSDKを使用してOSSモニタリングデータをクエリする方法について説明します。
CloudMonitor SDKサンプルコードについては、「SDKリファレンス」をご参照ください。
スペース
Spaceパラメーターは、監視するクラウドサービスを指定します。 CloudMonitorがOSSのモニタリングに使用する名前空間は、acs_oss_dashboardです。
次のサンプルコードは、CloudMonitor SDK for Javaを使用してOSSをモニタリングするようにCloudMonitorを設定する方法の例を示しています。
DescribeMetricListRequest request = new DescribeMetricListRequest();
request.setNamespace("acs_oss_dashboard");StartTime と EndTime
StartTimeパラメーターとEndTimeパラメーターは、モニタリングデータを照会する時間範囲を指定します。 CloudMonitorは、左オープンおよび右クローズ (StartTime、EndTime) 間隔を使用して、データクエリの時間範囲を指定します。 開始時間と終了時間の間隔は31日を超えることはできません。 過去31日間に生成されたデータのみを照会できます。
次のサンプルコードは、CloudMonitor SDK for Javaを使用してデータクエリの時間範囲を指定する方法の例を示しています。
// Specify the end time based on which you want to query monitoring data.
request.setEndTime("2019-05-13 11:06:27");
// Specify the start time based on which you want to query monitoring data.
request.setStartTime("2019-05-13 10:20:27");ディメンション
Dimensionsパラメーターは、モニタリングデータを照会するバケットを指定します。 ディメンションを指定しない場合、バケットのアカウントレベルのメトリックデータが照会されます。 メトリックレベルの詳細については、「メトリック」をご参照ください。
次のサンプルコードは、CloudMonitor SDK for Javaを使用して特定のバケットのモニタリングデータをクエリする方法の例を示しています。
// Specify the bucket whose monitoring data you want to query.
request.setDimensions("{\"BucketName\":\"<yourBucketName>\"}");期間
Periodパラメーターは、指定されたメトリックが照会されるサイクルを指定します。 OSSメータリングメトリックのサイクルは3,600秒です。 他のOSSメトリックのサイクルは60秒です。 メトリックの詳細については、「メトリック」をご参照ください。
次のサンプルコードは、非メータリングメトリックを照会するためのPeriodパラメーターの指定方法の例を示しています。
request.setPeriod("60");メトリック
Metricパラメーターは、クエリするメトリックを指定します。 メトリックには、非メータリングメトリックとメータリングメトリックが含まれます。 次のサンプルコードは、CloudMonitor SDK for Javaを使用して特定のメトリックをクエリする方法の例を示しています。
// Specify the name of the metric.
request.setMetric("<MetricName>");OSSメトリックは、[メトリックリスト] ページで表示できます。
非計測メトリック
非計量メトリックは、使用計量情報を反映しないメトリックである。 次の表に、OSSの非メータリングメトリックを示します。
レベル | メトリック | 説明 | 単位 |
ユーザーレベル | ユーザー可用性 | 可用性。 | % |
UserRequestValidRate | 有効なリクエストの割合。 | % | |
UserTotalRequestCount | リクエストの合計数。 | なし | |
UserValidRequestCount | 有効なリクエストの数。 | なし | |
UserInternetSend | インターネット上のアウトバウンドトラフィック。 | バイト | |
UserInternetRecv | インターネット上のインバウンドトラフィック。 | バイト | |
UserIntranetSend | 内部ネットワーク上のアウトバウンドトラフィック。 | バイト | |
UserIntranetRecv | 内部ネットワーク上のインバウンドトラフィック。 | バイト | |
UserCdnSend | Alibaba Cloud CDNからのアウトバウンドトラフィック。 | バイト | |
UserCdnRecv | Alibaba Cloud CDNへのインバウンドトラフィック。 | バイト | |
UserSyncSend | クロスリージョンレプリケーション (CRR) を使用してソースバケットからターゲットバケットにデータをレプリケートするときに生成されるアウトバウンドトラフィック。 | バイト | |
UserSyncRecv | CRRを使用してソースバケットから宛先バケットにデータをレプリケートするときに生成されるインバウンドトラフィック。 | バイト | |
UserServerErrorCount | サーバーエラーが発生したリクエストの総数。 | なし | |
UserServerErrorRate | サーバーエラーが発生したリクエストの割合。 | % | |
UserNetworkErrorCount | ネットワークエラーが発生したリクエストの総数。 | なし | |
UserNetworkErrorRate | ネットワークエラーが発生したリクエストの割合。 | % | |
UserAuthorizationErrorCount | クライアントからの失敗した承認要求の総数。 | なし | |
UserAuthorizationErrorRate | クライアントからの承認リクエストの失敗の割合。 | % | |
UserResourceNotFoundErrorCount | リソースが存在しないためにクライアントから失敗したリクエストの総数。 | なし | |
UserResourceNotFoundErrorRate | リソースが存在しないためにクライアントから失敗したリクエストの割合。 | % | |
UserClientTimeoutErrorCount | クライアントのタイムアウトにより失敗したリクエストの総数。 | なし | |
UserClientOtherErrorRate | クライアントのタイムアウトにより失敗したリクエストの割合。 | % | |
UserClientOtherErrorCount | 他のクライアントのエラーが発生したリクエストの総数。 | なし | |
UserClientOtherErrorRate | 他のクライアントのエラーが発生したリクエストの割合。 | % | |
UserSuccessCount | 成功したリクエストの総数。 | なし | |
UserSuccessRate | 成功したリクエストの割合。 | % | |
UserRedirectCount | リダイレクト要求の総数。 | なし | |
UserRedirectRate | リダイレクト要求の割合。 | % | |
バケットレベル | Availability | 可用性。 | % |
RequestValidRate | 有効なリクエストの割合。 | % | |
TotalRequestCount | リクエストの合計数。 | なし | |
ValidRequestCount | 有効なリクエストの数。 | なし | |
InternetSend | インターネット上のアウトバウンドトラフィック。 | バイト | |
InternetRecv | インターネット上のインバウンドトラフィック。 | バイト | |
IntranetSend | 内部ネットワーク上のアウトバウンドトラフィック。 | バイト | |
IntranetRecv | 内部ネットワーク上のインバウンドトラフィック。 | バイト | |
InternetSendBandwidth | インターネット上のアウトバウンド帯域幅。 | bps | |
InternetRecvBandwidth | インターネット上のインバウンド帯域幅。 | bps | |
IntranetSendBandwidth | 内部ネットワーク上のアウトバウンド帯域幅。 | bps | |
イントラネットRecvBandwidth | 内部ネットワーク上のインバウンド帯域幅。 | bps | |
CdnSend | Alibaba Cloud CDNからのアウトバウンドトラフィック。 | バイト | |
CdnRecv | Alibaba Cloud CDNへのインバウンドトラフィック。 | バイト | |
SyncSend | CRRを使用してソースバケットから宛先バケットにデータをレプリケートするときに生成されるアウトバウンドトラフィック。 | バイト | |
SyncRecv | CRRを使用してソースバケットから宛先バケットにデータをレプリケートするときに生成されるインバウンドトラフィック。 | バイト | |
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 | 特定のHTTPステータスコードを持つ正当なリクエストに対する特定のオリジンからのインバウンドトラフィックの量。 | バイト | |
MirrorRequestTransferSpeed | 特定のオリジンに対する正当なリクエストの平均データ転送速度。 | バイト/秒 | |
MirrorRequestTransferSpeedByStatus | 特定のHTTPステータスコードを使用した、特定のオリジンへの正当なリクエストの平均データ転送速度。 | バイト/秒 | |
MirrorRequestCount | 特定のオリジンに対する正当なリクエストの総数。 | なし | |
MirrorRequestCountByStatus | 特定のHTTPステータスコードを持つ、特定のオリジンへの正当なリクエストの総数。 | なし | |
MirrorAverageLatency | 特定のオリジンに対する正当なリクエストの平均レイテンシ。 | ミリ秒 | |
MirrorAverageLatencyByStatus | 特定のHTTPステータスコードを持つ、特定のオリジンに対する正当なリクエストの平均レイテンシ。 | ミリ秒 | |
MirrorRequestStatusRatio | すべてのリクエストのうち、特定のオリジンへのHTTPステータスコード2xx、3xx、4xx、および5xxのリクエストの割合。 | % | |
MirrorRequestStatusCount | HTTPステータスコードが2xx、3xx、4xx、および5xxの特定のオリジンへのリクエストの総数。 | なし |
測定メトリック
次のメトリックをクエリするときにディメンションを指定すると、指定されたバケットのデータがクエリされます。 ディメンションを指定しない場合、バケットのアカウントレベルのデータが照会されます。
課金ルールに従って、メータリングメトリックは非メータリングメトリックとは異なる方法で収集および表示されます。 詳細については、「請求可能な使用状況メトリック」をご参照ください。
メトリック | 説明 | 単位 |
MeteringStorageUtilization | ストレージ使用率。 | バイト |
MeteringGetRequest | GET リクエストの数です。 | なし |
MeteringPutRequest | PUT リクエストの数です。 | なし |
MeteringInternetTX | インターネット上の従量送信トラフィック。 | バイト |
MeteringCdnTX | Alibaba Cloud CDNからの計測されたアウトバウンドトラフィック。 | バイト |
MeteringSyncRX | CRRを使用してソースバケットから宛先バケットにデータをレプリケートするときに生成される、従量課金されたインバウンドトラフィック。 | バイト |