Storage

Bucket Metrics

Track storage usage, request patterns, and bandwidth consumption for each bucket in real-time.

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.

Metrics are available for all operations: S3 API calls, CLI commands, control panel actions, and CDN origin fetches.

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:

Period	Data Points	Best For
24h	24 hourly points	Recent activity, troubleshooting
7d	168 hourly points	Weekly patterns, trend analysis
30d	720 hourly points	Monthly overview, capacity planning

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

Control Panel

Navigate to Storage in your control panel
Click on a bucket to open it
Select the Metrics tab
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 optimize content.

Cost Optimization

Identify high-bandwidth objects that could benefit from CDN caching or compression to reduce egress costs.

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

Data Retention

Metrics data is retained based on granularity:

Granularity	Retention
Hourly data points	90 days
Top objects statistics	Rolling (updated on each access)
File type distribution	Real-time (calculated from current objects)