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. You can also use these metrics to monitor the performance of requests in terms of latency, and utilization as measured by counts of various types of requests made per bucket.

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 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.

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 archive.

Default Metrics

Default metrics are available on buckets in default charts.

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.

Custom Query Metrics

The following metrics are only available from a custom query. See To view Object Storage metrics with a custom query.

Metric Metric Display Name Unit Description Dimensions
UncommittedParts Incomplete MultiPart Upload Size bytes

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

resourceID

resourceDisplayName

tier

GetRequests GetObject Request Count count The total number of GetObject requests made in a bucket. resourceID

resourceDisplayName

HeadRequests HeadObject Request Count count The total number of HeadObject requests made in a bucket.
DeleteRequests DeleteObject Request Count count The total number of DeleteObject requests made in a bucket.
PutRequests PutObject Request Count count The total number of PutObject requests made in a bucket.
ListRequests ListObjects Request Count count The total number of ListObjects requests made in a bucket.
RenameRequests RenameObject Request Count count The total number of RenameObject requests made in a bucket.
PostRequests Post Object Request Count count The total number of HTTP Post requests made in a bucket.
ClientErrors Client Side Error Count count The total number of 4xx errors for requests made in a bucket.
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.
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.
AllRequests All Request Count count The total number of all HTTP requests made in a bucket.
CopyRequests Copy Object Request Count count The total number of CopyObject requests made in a bucket.
ArchiveRequests Archive Object Request Count count The total number of ArchiveObject requests made in a bucket. To archive objects, you must configure an Object Lifecycle policy. See Using Object Lifecycle Management.

Using the Console

To view default metric charts for a bucket
To view default metric charts by dimension
To view Object Storage metrics with a custom query

Using the API

For information about using the API and signing requests, see REST APIs and Security Credentials. For information about SDKs, see Software Development Kits and Command Line Interface.

Use the following APIs for monitoring: