---
title: "Bucket metrics"
description: "Monitor Edge Network storage with per-bucket metrics: usage, request volume, bandwidth, file type breakdown, and top objects over 24h, 7d, and 30d periods."
url: "https://edge.network/docs/storage/metrics"
section: "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.

> [!NOTE]
> Metrics are available for all operations: S3 API calls, CLI commands, console 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

### 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:

```http
# 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:

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