Oracle Cloud Infrastructure Documentation

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, the number of objects being stored, and the size of any objects included in incomplete parts of a multipart upload. For more information, see Overview of Object Storage and Using Multipart Uploads.

Prerequisites

  • IAM policies: To monitor resources, you must be given the required type of access in a An IAM document that specifies who has what type of access to your resources. It is used in different ways: to mean an individual statement written in the policy language; to mean a collection of statements in a single, named "policy" document (which has an Oracle Cloud ID (OCID) assigned to it); and to mean the overall body of policies your organization uses to control access to resources. 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 A collection of related resources that can be accessed only by certain groups that have been given permission by an administrator in your organization. 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 table 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 elicit no metric data.

Each metric includes the following dimensions:

resourceID
The An Oracle-assigned unique ID called an Oracle Cloud Identifier (OCID). This ID is included as part of the resource's information in both the Console and API. of the bucket to which the metric applies.
resourceDisplayName
The name of the A logical container for storing objects..
tier
The current storage tier of the Any type of data, regardless of content type, is stored as an object. The object is composed of the object itself and metadata about the object. Each object is stored in a bucket.: standard or archived.

 

Metric Metric Display Name Unit Description Dimensions
StoredBytes Bucket Size bytes The size of the bucket, excluding any multipart upload parts that have not been discarded (aborted) or committed.

resourceID

resourceDisplayName

tier

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.
UncommittedParts Incomplete MultiPart Upload Size bytes

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

Tip: You must create a custom query to see this metric. See To view UncommittedParts in a chart.

Using the Console

To view default metric charts for a single bucket
To view default metric charts by tier
To view UncommittedParts in a chart

Using the API

Use the following APIs for monitoring: