Understanding Azure Cosmos DB Free Tier

Azure Cosmos DB free tier give us 1000 RU/s and 25 GB of storage.

I created a database with one container, added some data to it and executed some queries. Looking at the insights, I can see this:

Does that mean I used 99.68 RUs out of the 1000 RUs from the free tier? Are those 1000 RUs in a month?

Solution 1:

Does that mean I used 99.68 RUs out of the 1000 RUs from the free tier?

It means that you used 99.68 request units in total. It is unclear over what time period you used these but even if that was all in one second this is well within the 1,000 RU/S limit.

Are those 1000 RUs in a month?

No. When you remember that RU/s is "Request Units per Second" this doesn't make sense. It is an ongoing allowance and based on RU provisioned (whether manually or via auto scale) not RU used.

I imagine that you may be concerned that you have already used 10% of your free allowance? This is absolutely not the case. For a container provisioned at 1,000 RU/s you can use 1,000 RU for each second and the allowance starts fresh each second. Any historic request units used have no importance here.

In terms of actual request units the free account means that potentially you could use 2,592,000,000 per month without paying any extra if you were somehow able to keep the collection constantly processing operations worth 1,000 request units every second in that month.

If you exceed the limits for the free tier by provisioning more than 1,000 RU/s you will be billed accordingly at hour granularity.

With the free account if you are concerned about additional charges you should probably steer clear of autoscale as the minimum autoscale range that can be configured is 400-4,000 RU/s and these RUs are charged at a 50% premium.

With the free account you can provision without charge up to 1,000 RU/s via fixed provisioning across all containers and databases in the account - with fixed provisioning you are charged based on what you provisioned rather than what you used (the system will throttle you if your usage would exceed provisioned limit).