Object Storage Metrics
Learn about the metrics generated by the Object Storage service.
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 granted 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, contact the administrator to find out what type of access you were granted and which compartment you need to work in. For more information about user authorizations for monitoring, see IAM Policies.
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.
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
|
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 Using the Console.
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
|
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.
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
|