All Products
Search

This Product

    Object Storage Service:Use CloudMonitor to monitor OSS metrics

    Document Center

    Object Storage Service:Use CloudMonitor to monitor OSS metrics

    Last Updated:Jun 23, 2026

    Use CloudMonitor to monitor data from Object Storage Service (OSS). This helps you track the usage and health of your OSS resources in near real-time. Promptly identifying and addressing issues such as traffic spikes and access errors ensures business stability.

    OSS reports monitoring data to CloudMonitor, which presents the data in two forms:

    • Metrics: The complete set of monitoring data that OSS reports to CloudMonitor. You can retrieve these metrics by calling CloudMonitor APIs or view them on the metric query page in the CloudMonitor console. Metrics are continuously added and updated as OSS evolves, such as queries per second (QPS) for resource pools.

    • Dashboards: Pre-built charts in the CloudMonitor console that display common metrics.

    View all OSS metrics

    The metric query pages in CloudMonitor list all OSS metrics and their definitions. The metrics are organized by product category and are available on the following two pages (namespaces):

    Metric query page (namespace)

    Scope

    OSS Metrics

    Metrics for object buckets, Table Buckets, Vector Buckets, and accelerators.

    OSS Resource Pool Metrics

    Metrics for resource pools.

    1. Go to the target metric query page. Visit the OSS Metrics page for object buckets, Table Buckets, Vector Buckets, or accelerators, and the OSS Resource Pool Metrics page for resource pools.

    2. Select the Basic CloudMonitor Metrics or Prometheus metrics tab.

    3. From the Product Category drop-down list, select a category such as object bucket, Table Bucket, Vector Bucket, or accelerator. You can also use the search box to perform a fuzzy search by metric name or description.

    4. In the metric list, view the details for each metric. The columns are described as follows:

      Column

      Description

      Metric name

      The name of the metric used when calling CloudMonitor APIs, such as Availability or AuthorizationErrorCount.

      Display name

      The display name of the metric, such as "Availability" or "Total Client Authorization Error Requests".

      Dimension

      The dimension used to filter metric data, such as userId (account), BucketName (bucket name), or Requester.

      Period

      The data collection interval for the metric, in seconds. For example, 60 or 3600.

      Statistics

      The aggregation method supported by the metric, such as Value.

      Unit

      The unit of the metric, such as B (bytes), count, ms (milliseconds), %, or bit/s.

    5. Once you have the name and dimension of a metric, you can use CloudMonitor APIs like DescribeMetricList or DescribeMetricLast to retrieve the corresponding metric data.

    View OSS dashboards

    Dashboards provide pre-built visualizations in the CloudMonitor console. They group common OSS metrics by monitoring scenario, so you can quickly view monitoring data without calling APIs. CloudMonitor provides the following OSS dashboards, organized by product category:

    1. Go to the CloudMonitor OSS dashboard page.

    2. In the upper-left corner, select a category from the Product Category drop-down list, such as Object Storage Service (OSS), Object Storage Service Vector Bucket, Object Storage Service Table Bucket, or Object Storage Service Resource Pool.

    3. From the Instance drop-down list, select the target resource, such as a bucket or resource pool.

    4. Select a monitoring scenario tab to view the corresponding dashboard. For example, a bucket in Object Storage Service (OSS) has the following tabs:

      Tab

      Description

      Service monitoring overview

      Provides an overview of core metrics, including availability/valid request rate, total/valid requests, traffic, and request status distribution.

      Request status details

      Displays charts for the distribution of requests by status code, such as 2xx, 4xx, and 5xx.

      Measurement Reference

      Displays charts for billing-related metrics, such as storage amount, traffic, and request counts, which can be used as a reference for usage and billing.

      Average latency

      Displays charts for the average latency of various request operations.

      Maximum latency

      Displays charts for the maximum latency of various request operations.

      Successful request operation category

      Displays charts for successful requests, categorized by operation type such as GetObject and PutObject.

      Requester

      Displays charts for access requests, categorized by requester.

      HDFS request

      Displays monitoring charts for requests to OSS made through the HDFS protocol.

    5. (Optional) Use the Time Range selector (1 Hour, 3 Hours, 6 Hours, 12 Hours, 1 Day, 3 Days, 7 Days, 14 Days, or Custom) at the top of the page to change the time period for the charts. Use the Items per row setting to adjust the arrangement of the charts.

    6. (Optional) Click Create Alert Rule or View Alert Rules to configure threshold-based alerts for metrics you want to monitor.

    Note

    The following sections describe some common metrics. For a complete list of all OSS metrics, see the metric query pages in CloudMonitor.

    View OSS bucket metrics

    1. On the CloudMonitor - Object Storage Service (OSS) page, select a bucket name.

    2. View the monitoring details for the OSS bucket.

      Note

      You can query data from the last 30 days by specifying a custom time range.

      Dimension

      Description

      Service monitoring overview

      Availability/Valid Request Rate, Total/Valid Requests, Traffic, and Request Status Distribution

      Request status details

      Server Error Requests, Server Error Request Rate, Network Error Requests, Network Error Request Rate, Client Error Requests, Client Error Request Rate, Valid Requests, and Valid Request Rate

      Measurement Reference

      Storage Size, Metered Traffic, and Billable Requests

      Average latency

      Average latency for GetObject, HeadObject, PutObject, PostObject, AppendObject, UploadPart, and UploadPartCopy requests

      Maximum latency

      Maximum latency for GetObject, HeadObject, PutObject, PostObject, AppendObject, UploadPart, and UploadPartCopy requests

      Successful request operation category

      Successful GetObject, HeadObject, PutObject, PostObject, AppendObject, UploadPart, UploadPartCopy, DeleteObject, and DeleteObjects requests

      Requester

      Note

      The Requester dimension metrics are generated only when a bucket is in dedicated mode or part of a resource pool.

      • Internet upload bandwidth for the specified bucket and Requester (BucketRequesterInternetRecvBandwidth)

      • Internet upload bandwidth throttling threshold for the specified bucket and Requester (BucketRequesterQosMaxExtranetUploadBandwidth)

      • Internet download bandwidth for the specified bucket and Requester (BucketRequesterInternetSendBandwidth)

      • Internet download bandwidth throttling threshold for the specified bucket and Requester (BucketRequesterQosMaxExtranetDownloadBandwidth)

      • Internal network upload bandwidth for the specified bucket and Requester (BucketRequesterIntranRecvBandwidth)

      • Internal network upload bandwidth throttling threshold for the specified bucket and Requester (BucketRequesterQosMaxIntranetUploadBandwidth)

      • Internal network download bandwidth for the specified bucket and Requester (BucketRequesterIntranSendBandwidth)

      • Internal network download bandwidth throttling threshold for the specified bucket and Requester (BucketRequesterQosMaxIntranetDownloadBandwidth)

      • Total upload bandwidth for the specified bucket and Requester (BucketRequesterRecvBandwidth)

      • Total upload bandwidth throttling threshold for the specified bucket and Requester (BucketRequesterQosMaxTotalUploadBandwidth)

      • Total download bandwidth for the specified bucket and Requester (BucketRequesterSendBandwidth)

      • Total download bandwidth throttling threshold for the specified bucket and Requester (BucketRequesterQosMaxTotalDownloadBandwidth)

    View OSS resource pool bandwidth

    1. Log on to the OSS Resource Pool page in the CloudMonitor console.

    2. View the bandwidth usage of the OSS resource pool.

      Dimension

      Description

      Bandwidth for a specified resource pool

      • Internet upload bandwidth for the resource pool (ResourcePoolInternetRecvBandwidth)

      • Internet upload bandwidth throttling threshold for the resource pool (ResourcePoolQosMaxExtranetUploadBandwidth)

      • Internet download bandwidth for the resource pool (ResourcePoolInternetSendBandwidth)

      • Internet download bandwidth throttling threshold for the resource pool (ResourcePoolQosMaxExtranetDownloadBandwidth)

      • Internal network upload bandwidth for the resource pool (ResourcePoolIntranRecvBandwidth)

      • Internal network upload bandwidth throttling threshold for the resource pool (ResourcePoolQosMaxIntranetUploadBandwidth)

      • Internal network download bandwidth for the resource pool (ResourcePoolIntranSendBandwidth)

      • Internal network download bandwidth throttling threshold for the resource pool (ResourcePoolQosMaxIntranetDownloadBandwidth)

      • Total upload bandwidth for the resource pool (ResourcePoolRecvBandwidth)

      • Total upload bandwidth throttling threshold for the resource pool (ResourcePoolQosMaxTotalUploadBandwidth)

      • Total download bandwidth for the resource pool (ResourcePoolSendBandwidth)

      • Total download bandwidth throttling threshold for the resource pool (ResourcePoolQosMaxTotalDownloadBandwidth)

      Bandwidth for a requester accessing a specified resource pool

      • Internet upload bandwidth for a requester accessing the specified resource pool (ResourcePoolRequesterInternetRecvBandwidth)

      • Internet upload bandwidth throttling threshold for a requester accessing the specified resource pool (ResourcePoolRequesterQosMaxExtranetUploadBandwidth)

      • Internet download bandwidth for a requester accessing the specified resource pool (ResourcePoolRequesterInternetSendBandwidth)

      • Internet download bandwidth throttling threshold for a requester accessing the specified resource pool (ResourcePoolRequesterQosMaxExtranetDownloadBandwidth)

      • Internal network upload bandwidth for a requester accessing the specified resource pool (ResourcePoolRequesterIntranRecvBandwidth)

      • Internal network upload bandwidth throttling threshold for a requester accessing the specified resource pool (ResourcePoolRequesterQosMaxIntranetUploadBandwidth)

      • Internal network download bandwidth for a requester accessing the specified resource pool (ResourcePoolRequesterIntranSendBandwidth)

      • Internal network download bandwidth throttling threshold for a requester accessing the specified resource pool (ResourcePoolRequesterQosMaxIntranetDownloadBandwidth)

      • Total upload bandwidth for a requester accessing the specified resource pool (ResourcePoolRequesterRecvBandwidth)

      • Total upload bandwidth throttling threshold for a requester accessing the specified resource pool (ResourcePoolRequesterQosMaxTotalUploadBandwidth)

      • Total download bandwidth for a requester accessing the specified resource pool (ResourcePoolRequesterSendBandwidth)

      • Total download bandwidth throttling threshold for a requester accessing the specified resource pool (ResourcePoolRequesterQosMaxTotalDownloadBandwidth)

      Bandwidth for a bucket within a specified resource pool

      • Internet upload bandwidth for a bucket in the resource pool (ResourcePoolBucketInternetRecvBandwidth)

      • Internet upload bandwidth throttling threshold for a bucket in the resource pool (ResourcePoolBucketQosMaxExtranetUploadBandwidth)

      • Internet download bandwidth for a bucket in the resource pool (ResourcePoolBucketInternetSendBandwidth)

      • Internet download bandwidth throttling threshold for a bucket in the resource pool (ResourcePoolBucketQosMaxExtranetDownloadBandwidth)

      • Internal network upload bandwidth for a bucket in the resource pool (ResourcePoolBucketIntranRecvBandwidth)

      • Internal network upload bandwidth throttling threshold for a bucket in the resource pool (ResourcePoolBucketQosMaxIntranetUploadBandwidth)

      • Internal network download bandwidth for a bucket in the resource pool (ResourcePoolBucketIntranSendBandwidth)

      • Internal network download bandwidth throttling threshold for a bucket in the resource pool (ResourcePoolBucketQosMaxIntranetDownloadBandwidth)

      • Total upload bandwidth for a bucket in the resource pool (ResourcePoolBucketRecvBandwidth)

      • Total upload bandwidth throttling threshold for a bucket in the resource pool (ResourcePoolBucketQosMaxTotalUploadBandwidth)

      • Total download bandwidth for a bucket in the resource pool (ResourcePoolBucketSendBandwidth)

      • Total download bandwidth throttling threshold for a bucket in the resource pool (ResourcePoolBucketQosMaxTotalDownloadBandwidth)

      Bandwidth for a BucketGroup within a specified resource pool

      • Internet upload bandwidth for a BucketGroup in the resource pool (ResourcePoolBucketGroupInternetRecvBandwidth)

      • Internet upload bandwidth throttling threshold for a BucketGroup in the resource pool (ResourcePoolBucketGroupQosMaxExtranetUploadBandwidth)

      • Internet download bandwidth for a BucketGroup in the resource pool (ResourcePoolBucketGroupInternetSendBandwidth)

      • Internet download bandwidth throttling threshold for a BucketGroup in the resource pool (ResourcePoolBucketGroupQosMaxExtranetDownloadBandwidth)

      • Internal network upload bandwidth for a BucketGroup in the resource pool (ResourcePoolBucketGroupIntranRecvBandwidth)

      • Internal network upload bandwidth throttling threshold for a BucketGroup in the resource pool (ResourcePoolBucketGroupQosMaxIntranetUploadBandwidth)

      • Internal network download bandwidth for a BucketGroup in the resource pool (ResourcePoolBucketGroupIntranSendBandwidth)

      • Internal network download bandwidth throttling threshold for a BucketGroup in the resource pool (ResourcePoolBucketGroupQosMaxIntranetDownloadBandwidth)

      • Total upload bandwidth for a BucketGroup in the resource pool (ResourcePoolBucketGroupRecvBandwidth)

      • Total upload bandwidth throttling threshold for a BucketGroup in the resource pool (ResourcePoolBucketGroupQosMaxTotalUploadBandwidth)

      • Total download bandwidth for a BucketGroup in the resource pool (ResourcePoolBucketGroupSendBandwidth)

      • Total download bandwidth throttling threshold for a BucketGroup in the resource pool (ResourcePoolBucketGroupQosMaxTotalDownloadBandwidth)

    • View resource pool bandwidth

      Click the Overview tab. Select a region and resource pool name to view its bandwidth usage.

    • View requester bandwidth in a resource pool

      Click the Requester tab. Select a region, a resource pool, and a requester UID to view the requester's bandwidth usage in the resource pool.

    • View bucket bandwidth in a resource pool

      Click the Bucket tab. Select a region, a resource pool, and a bucket name to view the bucket's bandwidth usage in the resource pool.

    • View BucketGroup bandwidth in a resource pool

      Click the BucketGroup tab. Select a region, a resource pool, and a BucketGroup name to view the BucketGroup's bandwidth usage in the resource pool.

    View OSS Vector Bucket metrics

    OSS Vector Bucket is integrated with CloudMonitor. In the Cloud Services Dashboard, you can select Object Storage Service Vector Bucket to view service quality and usage metrics on the Overview and Measurement Reference tabs.

    1. Log on to the CloudMonitor console. In the navigation pane on the left, choose Dashboard > Cloud Services Dashboard.

    2. On the Cloud Services Dashboard page, select Object Storage Service Vector Bucket from the product drop-down list. Then, select a region and the target Vector Bucket instance.

    3. View the monitoring details for the OSS Vector Bucket.

      Note

      The default data collection period is 1 hour. You can view trends over different time ranges, such as 1 hour, 3 hours, 6 hours, 12 hours, 1 day, 3 days, 7 days, or 14 days.

      Dimension

      Description

      BucketArn

      • Total requests

      • Vector query requests

      • Vector upload requests

      • Vector deletion requests

      • Server-side error requests

      • Total QPS

      • Vector query QPS

      • Vector upload QPS

      • Vector deletion QPS

      • Total inbound traffic

      • Total outbound traffic

      • Inbound traffic for vector uploads

      • Outbound traffic for vector queries

      • Total inbound bandwidth

      • Total outbound bandwidth

      • Vector store bucket ingress bandwidth for vector uploads (bit/s)

      • Outbound bandwidth for vector queries

      • Average server-side latency

      • SLA

      Bucket

      • Vector row count

      • Total vector storage

    • View service quality metrics

      Click the Overview tab. Select a region and a Vector Bucket to view service quality metrics for the BucketArn dimension, such as request count, QPS, bandwidth, average server-side latency, and SLA.

    • View usage metrics

      Click the Measurement Reference tab. Select a region and a Vector Bucket to view usage metrics for the Bucket dimension, such as vector row count and total vector storage.

    To receive notifications when a metric exceeds a threshold, click Create Alert Rule in the upper-right corner to configure a threshold-based alert rule.

    Related documents

    You can configure alert rules to monitor the health of your resources. When an alert rule is triggered, CloudMonitor automatically sends a notification. This helps you stay informed about resource status and handle exceptions promptly. For more information, see Use the alert service.