---
title: "Bucket Metrics"
description: "Monitor storage usage, request volume, and bandwidth for your Edge Storage buckets."
url: https://edge.network/docs/storage/metrics/
---

# Bucket Metrics

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

[Back to Docs](https://edge.network/docs) [Need help?](https://edge.network/support)