Overview
Terrafloww Marketplace provides detailed usage metrics to help you understand how your data is being consumed. These metrics are valuable for:- Monitoring data access patterns
- Tracking resource consumption
- Planning capacity and costs
- Understanding user engagement
Metrics Available
Aggregate Counters
| Metric | Description |
|---|---|
total_assets_queried | Number of COG files accessed |
total_tiles_queried | Number of image tiles retrieved |
total_network_transfer_bytes | Compressed bytes transferred |
total_network_transfer_bytes_uncompressed | Full tile size (before clipping) |
total_network_transfer_bytes_uncompressed_used | Actual bytes used (clipped AOI) |
total_area_crs_units | Total area queried in CRS units |
Per-Asset Metrics
For each asset accessed, you can see:- Scene ID and URL (href)
- Band name and index
- Tile count
- Bytes transferred (compressed and uncompressed)
- AOI area covered
Viewing Metrics
Dashboard
Access your usage metrics from the Marketplace dashboard:- Navigate to your organization’s datasets
- Select a dataset
- Click the Metrics tab
Filtering Options
Filter metrics by:| Filter | Description |
|---|---|
start / end | Time range (RFC3339 format) |
dataset_id | Specific dataset |
token_id | Specific API token |
status | Request status (success, error) |
bucket | Time aggregation (1h, 1d, etc.) |
Time Buckets
Available time bucket sizes for aggregation:1m- 1 minute5m- 5 minutes1h- 1 hour1d- 1 day
Metrics for Dataset Owners
As a dataset owner, you can see:Your Usage
Metrics for your own organization’s data consumption
Global Usage
Aggregated metrics from all consumers of your published datasets
[!NOTE] Global metrics are automatically enabled for published datasets, allowing owners to see total consumption across all organizations using their data.
Transfer Size Estimation
Metrics include detailed transfer size calculations:- Compressed bytes - Actual network transfer (merged segment ranges)
- Uncompressed used bytes - Pixels within the clipped AOI
- Uncompressed bytes - Full tile data before clipping
(tile_height × tile_width) × bytes_per_sample