Object Storage Service:Access monitoring data

Namespace

Set Namespace to acs_oss_dashboard to query OSS metrics.

DescribeMetricListRequest request = new DescribeMetricListRequest();
request.setNamespace("acs_oss_dashboard");

StartTime and EndTime

StartTime and EndTime define the query time range as a left-open, right-closed interval (StartTime, EndTime]. The interval cannot exceed 31 days, and only data from the past 31 days is available.

// Set the end time of the query range.
request.setEndTime("2019-05-13 11:06:27");
// Set the start time of the query range.
request.setStartTime("2019-05-13 10:20:27");

Dimensions

Dimensions filters the query to a specific bucket. Omit it to get account-level data aggregated across all buckets.

// Query monitoring data for a specific bucket.
request.setDimensions("{\"BucketName\":\"examplebucket\"}");

Period

Period sets the metric sampling interval in seconds:

• 60 — non-metering metrics (request counts, traffic, latency, error rates)

• 3600 — metering metrics (storage usage, billable GET/PUT request counts)

// Set the sampling interval for a non-metering metric.
request.setPeriod("60");

Metric

Metric specifies which metric to query. Pass the metric name from the tables below to setMetric(). To browse all available metrics, see the Metric list page.

// Set the metric name.
request.setMetric("<MetricName>");

Non-metering metrics (Period: 60s)

Non-metering metrics are available at two levels:

• Account level — aggregated across all buckets under your account. Omit Dimensions to query these.

• Bucket level — scoped to a single bucket. Set Dimensions to the target bucket name.

Metering metrics (Period: 3,600s)

Metering metrics reflect usage for billing purposes and follow different collection rules from non-metering metrics. Set Dimensions to query a specific bucket, or omit it to get account-level data. For collection rules and billing details, see Billable usage metrics.