Bucket metrics

Overview#

Every bucket includes a Metrics tab that provides insights into how your storage is being used. Metrics are recorded in real time and aggregated into hourly data points for charting.

Available metrics#

• Storage usage: total bytes stored and object count over time. Track how your bucket grows and identify storage trends.
• Request volume: count of GET, PUT, and DELETE operations. Understand access patterns and peak usage times.
• Egress (downloads): bytes transferred out of your bucket. Track bandwidth consumption from downloads and CDN fetches.
• Ingress (uploads): bytes transferred into your bucket. Monitor upload activity and data ingest rates.

Time periods#

View metrics for different time ranges using the period selector:

File type distribution#

The metrics dashboard shows a breakdown of storage by content type, helping you understand what types of files are consuming space:

• Images: JPEG, PNG, GIF, WebP, SVG
• Video: MP4, WebM, MOV, AVI
• Audio: MP3, WAV, OGG, FLAC
• Documents: PDF, DOC, XLS, PPT
• Archives: ZIP, TAR, GZ, RAR
• Data: JSON, XML, CSV

File types are determined by the Content-Type header set during upload.

Top objects#

See which objects are most frequently accessed. This helps identify:

• Hot content: files that should be cached or served via CDN
• Cost drivers: objects consuming the most bandwidth
• Access patterns: unusual activity that may indicate issues

Accessing metrics#

Console#

1. Navigate to Storage in your console.
2. Click on a bucket to open it.
3. Select the Metrics tab.
4. Use the period selector (24h / 7d / 30d) to change the time range.

API#

Metrics are also available via the API for programmatic access:

# Get hourly metrics (last 7 days)
GET /api/storage/buckets/:name/metrics?hours=168

# Get aggregate summary (last 24 hours)
GET /api/storage/buckets/:name/metrics/summary?hours=24

# Get top 10 most accessed objects
GET /api/storage/buckets/:name/metrics/top-objects?limit=10

# Get file type distribution
GET /api/storage/buckets/:name/metrics/file-types

Use cases#

• Capacity planning: monitor storage growth trends over 30 days to predict when you’ll need to adjust quotas or optimise content.
• Bandwidth optimisation: identify high-bandwidth objects that could benefit from CDN caching or compression to reduce bandwidth consumption.
• Performance monitoring: track request patterns to identify traffic spikes and ensure your application scales appropriately.
• Security auditing: review access patterns to detect unusual download activity that might indicate unauthorised access.

Data retention#

Metrics data is retained based on granularity: