Skip to content

Commit 336967a

Browse files
committed
Add bandwidth note for Data/Tiler API to service usage meters
1 parent c2e575f commit 336967a

1 file changed

Lines changed: 25 additions & 16 deletions

File tree

articles/planetary-computer/service-usage-meters.md

Lines changed: 25 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -5,49 +5,53 @@ author: prasadko
55
ms.author: prasadkomma
66
ms.service: planetary-computer-pro
77
ms.topic: article
8-
ms.date: 10/13/2024
8+
ms.date: 02/11/2026
99
#customer intent: As a user, I want to understand the service usage meter structure for Microsoft Planetary Computer Pro so I can estimate usage.
1010
---
1111

1212
# Microsoft Planetary Computer Pro service usage meters
1313

14-
Microsoft Planetary Computer Pro offers a pay-as-you-go usage model. You're charged for the resources you consume, providing flexibility and control over your spending. This article details the usage meters for the different components of the service.
14+
Microsoft Planetary Computer Pro uses a pay-as-you-go pricing model. You pay for the resources you use, so you have flexibility and control over your spending. This article describes the usage meters for the different components of the service.
1515

1616
## Access usage metrics through the Azure portal
1717

18-
Detailed information about the utilization of your GeoCatalog resource is available in the Azure portal under **Monitoring**>**Metrics** in the resource view.
18+
You can find detailed information about the utilization of your GeoCatalog resource in the Azure portal under **Monitoring** > **Metrics** in the resource view.
1919

2020
[![Screenshot of the Azure portal showing the Metrics blade for a GeoCatalog resource.](./media/service-usage-metrics.png)](./media/service-usage-metrics.png#lightbox)
2121

2222
## Service usage meters
2323

24-
Usage of the service is measured with the following dimensions:
24+
The service measures usage by using the following dimensions:
2525

2626
| Meter | Measured Units | Description |
2727
|----------------------------|---------------------------|------------------------------------------------------------------------------------------------------------|
2828
| **Geospatial Storage** | GiB-month | Ingested data stored after any cloud-optimization and compression. |
29-
| **Geospatial Data Operations** | 10K operations | Storage read / metadata retrieval operations (search, list, item/asset metadata access). |
29+
| **Geospatial Data Operations** | 10K operations | Storage read and metadata retrieval operations, such as search, list, and item or asset metadata access. |
3030
| **Ingestion & Transformation** | vCPU-hour | Compute consumed transforming data into cloud-optimized formats (for example COG generation) and ingesting data into GeoCatalog. |
3131
| **Bandwidth** | GiB | Data transferred out of the Azure region hosting the GeoCatalog resource. |
3232

33-
All meters are calculated using binary gigabytes (GiB), where 1 GiB equals 1,073,741,824 bytes.
33+
All meters use binary gigabytes (GiB), where 1 GiB equals 1,073,741,824 bytes.
3434

3535
### Geospatial Storage
3636

37-
Measured in GiB-month of data stored in your GeoCatalog (original plus derived / optimized forms). Includes any cloud-optimized representations generated by the platform.
37+
The service measures GiB-month of data stored in your GeoCatalog, including original data and derived or optimized forms. This measurement includes any cloud-optimized representations that the platform generates.
3838

39-
### Geospatial Data Operations
39+
Geospatial storage metrics can take up to six hours to reflect additions or deletions to stored data.
4040

41-
Operations are read operations for data that is stored in the managed storage inside a GeoCatalog resource. Common patterns include:
41+
### Geospatial data operations
42+
43+
These operations are read operations for data that the managed storage inside a GeoCatalog resource stores. Common patterns include:
4244
* Use the SAS API to read stored assets.
4345
* Use the Data API to render a tile based on managed data.
46+
* [Ingest new data](./ingestion-overview.md) into a GeoCatalog (this operation happens once).
4447

45-
Use of the [STAC API](./stac-overview.md) for querying or searching a catalog isn't considered a read operation.
48+
Use of the [STAC API](./stac-overview.md) for querying or searching a catalog isn't a read operation.
4649

50+
It can take up to two hours for geospatial data operations metrics to reflect new operations.
4751

48-
### Ingestion & Transformation
52+
### Ingestion and transformation
4953

50-
A virtual CPU (vCPU) hour reflects how much processing power the service spent on your ingestion job. While data is being ingested and transformed, Microsoft Planetary Computer Pro tracks the CPU time consumed by the workers that run your job inside its managed environment. It adds up every second of CPU usage from those workers, converts the total into hours, and reports that number as vCPU-hours for billing.
54+
A virtual CPU (vCPU) hour reflects how much processing power the service spends on your ingestion job. While the service ingests and transforms data, Microsoft Planetary Computer Pro tracks the CPU time the workers consume as they run your job inside its managed environment. The service adds up every second of CPU usage from those workers, converts the total into hours, and reports that number as vCPU-hours for billing.
5155

5256
To estimate your vCPU-hours, choose a data type similar to the one you plan to ingest:
5357

@@ -58,20 +62,25 @@ To estimate your vCPU-hours, choose a data type similar to the one you plan to i
5862
| Aerial Orthomosaic | Non-COG | Orthorectified GeoTIFF mosaic; Three bands (RGB); large tiles | 0.20 |
5963
| [National Aerial Imagery Program](./data-visualization-samples.md#the-national-agriculture-imagery-program-collection-configuration) | COG | Cloud Optimized GeoTIFF; Four bands (RGB + NIR) | 0.030 |
6064

61-
To estimate your vCPU-hours, select a data type that's similar to the one you plan on ingesting, and multiply the **Representative vCPU-hours/GiB** value by the number of gigabytes of data you intend to ingest.
65+
To estimate your vCPU-hours, select a data type that's similar to the one you plan to ingest, and multiply the **Representative vCPU-hours/GiB** value by the number of gigabytes of data you intend to ingest.
6266

63-
**Example:** Suppose you're ingesting 250 GiB of [National Aerial Imagery Program](./data-visualization-samples.md#the-national-agriculture-imagery-program-collection-configuration) (NAIP) data already in Cloud Optimized GeoTIFF (COG) format. Using the representative value of 0.030 vCPU/GiB from the table:
67+
**Example:** Suppose you're ingesting 250 GiB of [National Aerial Imagery Program](./data-visualization-samples.md#the-national-agriculture-imagery-program-collection-configuration) (NAIP) data already in Cloud Optimized GeoTIFF (COG) format. Use the representative value of 0.030 vCPU/GiB from the table:
6468

6569
250 GiB × 0.030 vCPU/GiB = 7.5 vCPU-hours
6670

71+
The ingestion and transformation metric can take up to 2 hours to reflect new activity from ingestion.
6772

6873
### Bandwidth
6974

70-
Bandwidth is measured in GiB of data that leave the GeoCatalog’s Azure region. This meter increments alongside read [operations](#geospatial-data-operations) whenever data moves to another Azure region or outside of Azure.
75+
You measure bandwidth in GiB of data that leave the GeoCatalog’s Azure region. This meter increments alongside read [operations](#geospatial-data-operations) whenever data moves to another Azure region or outside of Azure when using the SAS API to read data directly from GeoCatalog managed storage.
76+
77+
> [!NOTE]
78+
> Use of the Data/Tiler API doesn't result in any bandwidth usage.
79+
7180

7281
## Cost management
7382

74-
Azure provides tools to help you monitor and manage your spending. You can use [Microsoft Cost Management and Billing](/azure/cost-management-billing/cost-management-billing-overview) to track your Microsoft Planetary Computer Pro usage and costs, set budgets, and receive alerts.
83+
Azure provides tools to help you monitor and manage your spending. Use [Microsoft Cost Management and Billing](/azure/cost-management-billing/cost-management-billing-overview) to track your Microsoft Planetary Computer Pro usage and costs, set budgets, and receive alerts.
7584

7685
## Next steps
7786

0 commit comments

Comments
 (0)