Object Storage Metrics

You can monitor the health, capacity, and performance of your buckets and objects by using metrics, alarms, and notifications.

This topic describes the metrics emitted by the metric namespace oci_objectstorage (the Object Storage service).

Resources include buckets and objects.

Overview of the Object Storage Service Metrics

Object Storage can store an unlimited amount of unstructured data of any content type, including analytic data and rich content, like images and videos. The Object Storage service metrics help you measure the amount of storage you're using. You can also use these metrics to monitor the performance of requests in terms of latency and utilization as measured by counts of requests made per bucket.

Required IAM Policy

To monitor resources, you must be given the required type of access in a policy  written by an administrator, whether you're using the Console or the REST API with an SDK, CLI, or other tool. The policy must give you access to the monitoring services as well as the resources being monitored. If you try to perform an action and get a message that you don’t have permission or are unauthorized, confirm with your administrator the type of access you've been granted and which compartment  you should work in. For more information on user authorizations for monitoring, see the Authentication and Authorization section for the related service: Monitoring or Notifications.

Available Metrics: oci_objectstorage

The metrics listed in the following tables are automatically available for any buckets you create. You do not need to enable monitoring on the resource to get these metrics. However, you must have an object stored in a bucket to get any metrics. Buckets with no objects emit no metric data.

Note

Valid alarm intervals depend on the frequency at which the metric is emitted. Be sure to set alarm intervals equal to or greater than the frequency at which the metrics are emitted. You can find the emit frequency for each metric in the Default Metrics and Custom Query Metrics tables.

Each metric includes the following dimensions :

RESOURCEID
The OCID  of the bucket to which the metric applies.
RESOURCEDISPLAYNAME
The name of the bucket .
TIER
The storage tier (standard or archive) where the object  resides.

Default Metrics

The following default metric charts are available for each Object Storage bucket from the bucket details page. See To view default metric charts for a bucket.

Metric Metric Display Name Unit

Description/ Emit Frequency

Dimensions
ObjectCount Number of Objects count

The count of objects in the bucket, excluding any multipart upload parts that have not been discarded (aborted) or committed.

Emit frequency: every hour

resourceID

resourceDisplayName

tier

 
StoredBytes Bucket Size bytes

The size of the bucket, excluding any multipart upload parts that have not been discarded (aborted) or committed.

Emit frequency: every hour

Custom Query Metrics

The following custom query metric charts are available using Metrics Explorer. See To view custom query metric charts using Metrics Explorer.

Metric Metric Display Name Unit

Description/ Emit Frequency

Dimensions
AllRequests All Requests Count count

The total number of all HTTP requests made in a bucket.

Emit frequency: every 100 ms

resourceID

resourceDisplayName

ClientErrors Client Side Error Count count

The total number of 4xx errors for requests made in a bucket.

Emit frequency: every 100 ms

EnabledOLM Enabled Object Lifecycle Management count

Indicates whether a bucket has any executable Object Lifecycle Management policies configured. EnabledOLM emits:

  • 1 if there are policies configured
  • 0 if there are no policies configured

Emit frequency: every 3 hours

FirstByteLatency First Byte Latency Time time (ms)

The per-request time measured from the time Object Storage receives the complete request to when Object Storage returns the first byte of the response.

Emit frequency: every 100 ms

PostRequests PostObject Request Count count

The total number of HTTP Post requests made in a bucket.

Emit frequency: every 100 ms

PutRequests PutObject Request Count count

The total number of PutObject requests made in a bucket.

Emit frequency: every 100 ms

TotalRequestLatency Overall Latency Time time (ms)

The per-request time from the first byte received by Object Storage to the last byte sent from Object Storage.

Emit frequency: every 100 ms

UncommittedParts Incomplete MultiPart Upload Size bytes

The size of any multipart upload parts that have not been discarded (aborted) or committed.

Emit frequency: every hour

resourceID

resourceDisplayName

tier

Using the Console

To view default metric charts for a bucket
  1. Open the navigation menu. Under Core Infrastructure, click Object Storage.
  2. Choose the Compartment that contains the bucket you want to view, and then click the bucket's name.
  3. In the Resources menu, click Metrics.

    The Metrics page displays a default set of charts for the current bucket.

For more information about monitoring metrics and using alarms, see Monitoring Overview. For information about notifications for alarms, see Notifications Overview.

To view default metric charts by dimension
  1. Open the navigation menu. Under Solutions and Platform, go to Monitoring and click Service Metrics.
  2. For Metric Namespace, select oci_objectstorage.

  3. For Dimensions, click Add.

  4. For Dimension Name, select a dimension and then select a Dimension Value.

    Add more dimensions as needed.

  5. Click Done.

    The Service Metrics page displays a default set of charts for the selected metric namespace and dimension. For more information about the emitted metrics, see the foregoing table. You can also use the Monitoring service to create custom queries.

For more information about monitoring metrics and using alarms, see Monitoring Overview. For information about notifications for alarms, see Notifications Overview.

To view custom query metric charts using Metrics Explorer
  1. Open the navigation menu. Under Solutions and Platform, go to Monitoring and click Metrics Explorer.

    The Metrics Explorer page displays an empty chart with fields to build a query.

  2. Select a compartment.
  3. From Metric Namespace, select oci_objectstorage.
  4. From Metric Name, select a metric.
  5. (Optional) Refine your query.

    For instructions, see To create a query.

  6. Click Update Chart.

    The chart shows the results of your new query. You can optionally add more queries by clicking Add Query below the chart.

For more information about monitoring metrics and using alarms, see Monitoring Overview. For information about notifications for alarms, see Notifications Overview.