Skip to navigation

Object Storage metrics are the numbers that show how your buckets are used: how much data they hold, how many objects, how much is downloaded, and how many requests succeed or fail. They help you spot a runaway upload job, a public file being downloaded far more than expected, or errors in your app — before they show up on your bill.

When to use which view

You want to know…Look at
Totals for all your buckets this billing monthThe panel at the top of the Object Storage page
What one bucket is doing over the last day or weekThe bucket’s Metrics tab
The same numbers in a script or dashboardGET /object-storage/buckets/{bucket_name}/metrics
What you’ll be chargedBilling and the Pricing page

How it works

  1. IBEE records each request to your buckets and each change to what they store.
  2. Request and download figures are processed every 15 minutes and shown up to about 45 minutes before now, so the latest hour can look incomplete.
  3. The Metrics tab shows the last 24 hours or 7 days, with Data through … telling you how recent the data is.

Before you begin

  • A bucket with some activity. See Upload Your First Object.
  • Access to the bucket in the portal, or a platform API token with object-storage.read.

View a bucket’s metrics

1

Open the bucket

In Object Storage, click the bucket’s name.

2

Open the Metrics tab

Click Metrics. Choose Last 24 hours or Last 7 days.

3

Read the cards and charts

The cards show totals for the range; the charts show Data Retrieved from Origin, Operations (total, Class A, Class B) and Request outcomes (successful and failed) over time.

CardMeaning
Current StorageHow much the bucket stores now
Object CountHow many objects it holds
Data Retrieved from OriginBytes downloaded from the bucket
Class A OperationsWrites, lists and deletes (for example uploads)
Class B OperationsReads (downloads and HEAD requests)
Total OperationsAll requests
Successful Requests / Failed RequestsRequests that worked, and ones that returned an error

The Settings → General tab also shows Total Objects and Storage Used for the bucket.

Organization totals

The panel at the top of the Object Storage page shows, across all buckets:

FigureMeaning
BucketsNumber of buckets
ObjectsNumber of objects
Storage UsedTotal stored
Bandwidth EgressData downloaded in the current billing month

The bucket list below shows each bucket’s SIZE.

Get metrics with the API

curl "https://api.ibee.ai/v1/object-storage/buckets/my-bucket/metrics?range=24h&workspace_id=YOUR-WORKSPACE-ID" \
-H "Authorization: Bearer $IBEE_API_TOKEN"

range is 24h or 7d. The response has totals (current_storage_bytes, object_count, data_retrieved_bytes, class_a_operations, class_b_operations, total_operations, successful_requests, failed_requests), a list of points over time, data_through (the time the figures are complete up to, in 15-minute steps), and coverage_complete.

Verify

Upload a small file and download it once. Within about an hour, Object Count goes up by one and Class A Operations and Class B Operations each go up.

What to watch for

PatternLikely causeWhat to do
Current Storage keeps growingA job uploading without cleaning up, or many versions in an Object Lock bucketAdd a lifecycle rule for temporary prefixes.
Data Retrieved from Origin much higher than expectedA public bucket or link is being downloaded a lotPut the CDN in front, or turn off Public Access if it isn’t needed.
Many Class A OperationsMany small uploads, lists or deletesBatch uploads; don’t list the bucket in a loop.
Failed Requests risingExpired links, wrong keys, or a revoked credentialCheck your app’s error messages against Using the S3 API → Troubleshooting.

Limits and timing

Value
RangesLast 24 hours, last 7 days
Processing intervalEvery 15 minutes
DelayRequest and download figures stop about 45 minutes before now
Organization totalsCurrent billing month

Troubleshooting

You seeWhat it meansWhat to do
The last hour looks emptyRecent data isn’t processed yetCheck Data through …; wait an hour.
Metrics show nothing for a new bucketNo requests yet, or they’re still being processedUpload and download a file, then wait about an hour.
Storage in the list differs from your local folder sizeObject Storage counts each object’s bytes; your computer counts disk blocksSmall differences are normal.
The numbers differ from your invoiceBilling counts each object’s largest size during the month, and applies the free allowanceSee Pricing.