Supported metrics for Microsoft.DocumentDB/DatabaseAccounts

The following table lists the metrics available for the Microsoft.DocumentDB/DatabaseAccounts resource type.

Table headings

Metric - The metric display name as it appears in the Azure portal.
Name in Rest API - Metric name as referred to in the REST API.
Unit - Unit of measure.
Aggregation - The default aggregation type. Valid values: Average, Minimum, Maximum, Total, Count.
Dimensions - Dimensions available for the metric.
Time Grains - Intervals at which the metric is sampled. For example, PT1M indicates that the metric is sampled every minute, PT30M every 30 minutes, PT1H every hour, and so on.
DS Export- Whether the metric is exportable to Azure Monitor Logs via Diagnostic Settings.

For information on exporting metrics, see Create diagnostic settings in Azure Monitor.

For information on metric retention, see Azure Monitor Metrics overview.

For a list of supported logs, see Supported log categories - Microsoft.DocumentDB/DatabaseAccounts

Category Metric Name in REST API Unit Aggregation Dimensions Time Grains DS Export
Requests Region Added

Region Added
AddRegion Count Count Region PT5M Yes
Requests Autoscaled RU

Autoscaled RU consumption with Per Region and Per Partition Autoscale
AutoscaledRU Count Maximum DatabaseName, CollectionName, PhysicalPartitionId, Region PT1M, PT5M, PT1H, P1D No
Requests Autoscale Max Throughput

Autoscale Max Throughput
AutoscaleMaxThroughput Count Maximum DatabaseName, CollectionName PT5M, PT1H No
Requests (deprecated) Available Storage

"Available Storage"will be removed from Azure Monitor at the end of September 2023. Cosmos DB collection storage size is now unlimited. The only restriction is that the storage size for each logical partition key is 20GB. You can enable PartitionKeyStatistics in Diagnostic Log to know the storage consumption for top partition keys. For more info about Cosmos DB storage quota, please check this doc /azure/cosmos-db/concepts-limits. After deprecation, the remaining alert rules still defined on the deprecated metric will be automatically disabled post the deprecation date.
AvailableStorage Bytes Total (Sum), Average CollectionName, DatabaseName, Region PT5M No
Requests Backup Mode Update

Backup Mode Update
BackupModeUpdate Count Count BackupMode PT5M Yes
Requests Periodic Backup Policy Interval Update

Periodic Backup Policy Interval Update
BackupPolicyIntervalUpdate Count Count BackupIntervalInHours PT5M Yes
Requests Periodic Backup Policy Redundancy Update

Periodic Backup Policy Redundancy Update
BackupPolicyRedundancyUpdate Count Count BackupRedundancy PT5M Yes
Requests Periodic Backup Policy Retention Update

Periodic Backup Policy Retention Update
BackupPolicyRetentionUpdate Count Count BackupRetentionIntervalInHours PT5M Yes
Requests Periodic Backup Policy Update

Periodic Backup Policy Update
BackupPolicyUpdate Count Count BackupPolicy PT5M Yes
Requests Cassandra Connection Closures

Number of Cassandra connections that were closed, reported at a 1 minute granularity
CassandraConnectionClosures Count Average, Minimum, Maximum, Total (Sum) APIType, Region, ClosureReason PT1M No
Requests Cassandra Connector Average ReplicationLatency

Cassandra Connector Average ReplicationLatency
CassandraConnectorAvgReplicationLatency MilliSeconds Average <none> PT5M No
Requests Cassandra Connector Replication Health Status

Cassandra Connector Replication Health Status
CassandraConnectorReplicationHealthStatus Count Count NotStarted, ReplicationInProgress, Error PT5M No
Requests Cassandra Keyspace Created

Cassandra Keyspace Created
CassandraKeyspaceCreate Count Count ResourceName, ApiKind, ApiKindResourceType, IsThroughputRequest, OperationType PT5M No
Requests Cassandra Keyspace Deleted

Cassandra Keyspace Deleted
CassandraKeyspaceDelete Count Count ResourceName, ApiKind, ApiKindResourceType, OperationType PT5M No
Requests Cassandra Keyspace Throughput Updated

Cassandra Keyspace Throughput Updated
CassandraKeyspaceThroughputUpdate Count Count ResourceName, ApiKind, ApiKindResourceType, IsThroughputRequest PT5M No
Requests Cassandra Keyspace Updated

Cassandra Keyspace Updated
CassandraKeyspaceUpdate Count Count ResourceName, ApiKind, ApiKindResourceType, IsThroughputRequest, OperationType PT5M No
Requests Cassandra Request Charges

RUs consumed for Cassandra requests made
CassandraRequestCharges Count Total (Sum), Average, Minimum, Maximum APIType, DatabaseName, CollectionName, Region, OperationType, ResourceType PT1M No
Requests Cassandra Requests

Number of Cassandra requests made
CassandraRequests Count Count APIType, DatabaseName, CollectionName, Region, OperationType, ResourceType, ErrorCode PT1M No
Requests Cassandra Table Created

Cassandra Table Created
CassandraTableCreate Count Count ResourceName, ChildResourceName, ApiKind, ApiKindResourceType, IsThroughputRequest, OperationType PT5M No
Requests Cassandra Table Deleted

Cassandra Table Deleted
CassandraTableDelete Count Count ResourceName, ChildResourceName, ApiKind, ApiKindResourceType, OperationType PT5M No
Requests Cassandra Table Throughput Updated

Cassandra Table Throughput Updated
CassandraTableThroughputUpdate Count Count ResourceName, ChildResourceName, ApiKind, ApiKindResourceType, IsThroughputRequest PT5M No
Requests Cassandra Table Updated

Cassandra Table Updated
CassandraTableUpdate Count Count ResourceName, ChildResourceName, ApiKind, ApiKindResourceType, IsThroughputRequest, OperationType PT5M No
Requests ContinuousBackupMode Tier Update

ContinuousBackupMode Tier Update
ContinuousTierUpdate Count Count ContinuousBackupTier PT5M Yes
Requests Account Created

Account Created
CreateAccount Count Count <none> PT5M Yes
Requests Data Usage

Total data usage reported at 5 minutes granularity
DataUsage Bytes Total (Sum), Average, Maximum, Minimum CollectionName, DatabaseName, Region PT5M, PT15M, PT30M, PT1H No
Requests DedicatedGatewayAverageCPUUsage

Average CPU usage across dedicated gateway instances
DedicatedGatewayAverageCPUUsage Percent Average Region, MetricType PT5M No
Requests DedicatedGatewayAverageMemoryUsage

Average memory usage across dedicated gateway instances, which is used for both routing requests and caching data
DedicatedGatewayAverageMemoryUsage Bytes Average Region PT5M No
Requests DedicatedGatewayCPUUsage

CPU usage across dedicated gateway instances
DedicatedGatewayCPUUsage Percent Average, Maximum, Minimum Region, ApplicationType PT1M No
Requests DedicatedGatewayMaximumCPUUsage

Average Maximum CPU usage across dedicated gateway instances
DedicatedGatewayMaximumCPUUsage Percent Average, Maximum Region, MetricType PT5M No
Requests DedicatedGatewayMemoryUsage

Memory usage across dedicated gateway instances
DedicatedGatewayMemoryUsage Bytes Average, Maximum, Minimum Region, ApplicationType PT1M No
Requests DedicatedGatewayRequests

Requests at the dedicated gateway
DedicatedGatewayRequests Count Count DatabaseName, CollectionName, CacheExercised, OperationName, Region, CacheHit PT1M Yes
Requests Account Deleted

Account Deleted
DeleteAccount Count Count <none> PT5M Yes
Requests Document Count

Total document count reported at 5 minutes, 1 hour and 1 day granularity
DocumentCount Count Total (Sum), Average CollectionName, DatabaseName, Region PT5M, PT1H, P1D No
Requests Document Quota

Total storage quota reported at 5 minutes granularity
DocumentQuota Bytes Total (Sum), Average CollectionName, DatabaseName, Region PT5M No
Requests Gremlin Database Created

Gremlin Database Created
GremlinDatabaseCreate Count Count ResourceName, ApiKind, ApiKindResourceType, IsThroughputRequest, OperationType PT5M No
Requests Gremlin Database Deleted

Gremlin Database Deleted
GremlinDatabaseDelete Count Count ResourceName, ApiKind, ApiKindResourceType, OperationType PT5M No
Requests Gremlin Database Throughput Updated

Gremlin Database Throughput Updated
GremlinDatabaseThroughputUpdate Count Count ResourceName, ApiKind, ApiKindResourceType, IsThroughputRequest PT5M No
Requests Gremlin Database Updated

Gremlin Database Updated
GremlinDatabaseUpdate Count Count ResourceName, ApiKind, ApiKindResourceType, IsThroughputRequest, OperationType PT5M No
Requests Gremlin Graph Created

Gremlin Graph Created
GremlinGraphCreate Count Count ResourceName, ChildResourceName, ApiKind, ApiKindResourceType, IsThroughputRequest, OperationType PT5M No
Requests Gremlin Graph Deleted

Gremlin Graph Deleted
GremlinGraphDelete Count Count ResourceName, ChildResourceName, ApiKind, ApiKindResourceType, OperationType PT5M No
Requests Gremlin Graph Throughput Updated

Gremlin Graph Throughput Updated
GremlinGraphThroughputUpdate Count Count ResourceName, ChildResourceName, ApiKind, ApiKindResourceType, IsThroughputRequest PT5M No
Requests Gremlin Graph Updated

Gremlin Graph Updated
GremlinGraphUpdate Count Count ResourceName, ChildResourceName, ApiKind, ApiKindResourceType, IsThroughputRequest, OperationType PT5M No
Requests Gremlin Request Charges

Request Units consumed for Gremlin requests made
GremlinRequestCharges Count Total (Sum), Average, Minimum, Maximum APIType, DatabaseName, CollectionName, Region PT1M No
Requests Gremlin Requests

Number of Gremlin requests made
GremlinRequests Count Count APIType, DatabaseName, CollectionName, Region, ErrorCode PT1M No
Requests Index Usage

Total index usage reported at 5 minutes granularity
IndexUsage Bytes Total (Sum), Average, Maximum, Minimum CollectionName, DatabaseName, Region PT5M, PT15M, PT30M, PT1H No
Requests IntegratedCacheEvictedEntriesSize

Size of the entries evicted from the integrated cache
IntegratedCacheEvictedEntriesSize Bytes Average Region PT5M No
Requests IntegratedCacheItemExpirationCount

Number of items evicted from the integrated cache due to TTL expiration
IntegratedCacheItemExpirationCount Count Average Region, CacheEntryType PT5M No
Requests IntegratedCacheItemHitRate

Number of point reads that used the integrated cache divided by number of point reads routed through the dedicated gateway with eventual consistency
IntegratedCacheItemHitRate Percent Average Region, CacheEntryType PT5M No
Requests IntegratedCacheQueryExpirationCount

Number of queries evicted from the integrated cache due to TTL expiration
IntegratedCacheQueryExpirationCount Count Average Region, CacheEntryType PT5M No
Requests IntegratedCacheQueryHitRate

Number of queries that used the integrated cache divided by number of queries routed through the dedicated gateway with eventual consistency
IntegratedCacheQueryHitRate Percent Average Region, CacheEntryType PT5M No
Requests Materialized View Catchup Gap In Minutes

Maximum time difference in minutes between data in source container and data propagated to materialized view
MaterializedViewCatchupGapInMinutes Count Maximum Region, TargetContainerName, BuildType PT1M No
Requests Materialized Views Builder Average CPU Usage

Average CPU usage across materialized view builder instances, which are used for populating data in materialized views
MaterializedViewsBuilderAverageCPUUsage Percent Average Region, MetricType PT5M No
Requests Materialized Views Builder Average Memory Usage

Average memory usage across materialized view builder instances, which are used for populating data in materialized views
MaterializedViewsBuilderAverageMemoryUsage Bytes Average Region PT5M No
Requests Materialized Views Builder Maximum CPU Usage

Average Maximum CPU usage across materialized view builder instances, which are used for populating data in materialized views
MaterializedViewsBuilderMaximumCPUUsage Percent Average, Maximum Region, MetricType PT5M No
Requests Metadata Requests

Count of metadata requests. Cosmos DB maintains system metadata collection for each account, that allows you to enumerate collections, databases, etc, and their configurations, free of charge.
MetadataRequests Count Count DatabaseName, CollectionName, Region, StatusCode, Role PT1M No
Requests Mongo Collection Created

Mongo Collection Created
MongoCollectionCreate Count Count ResourceName, ChildResourceName, ApiKind, ApiKindResourceType, IsThroughputRequest, OperationType PT5M No
Requests Mongo Collection Deleted

Mongo Collection Deleted
MongoCollectionDelete Count Count ResourceName, ChildResourceName, ApiKind, ApiKindResourceType, OperationType PT5M No
Requests Mongo Collection Throughput Updated

Mongo Collection Throughput Updated
MongoCollectionThroughputUpdate Count Count ResourceName, ChildResourceName, ApiKind, ApiKindResourceType, IsThroughputRequest PT5M No
Requests Mongo Collection Updated

Mongo Collection Updated
MongoCollectionUpdate Count Count ResourceName, ChildResourceName, ApiKind, ApiKindResourceType, IsThroughputRequest, OperationType PT5M No
Requests Mongo Database Deleted

Mongo Database Deleted
MongoDatabaseDelete Count Count ResourceName, ApiKind, ApiKindResourceType, OperationType PT5M No
Requests Mongo Database Throughput Updated

Mongo Database Throughput Updated
MongoDatabaseThroughputUpdate Count Count ResourceName, ApiKind, ApiKindResourceType, IsThroughputRequest PT5M No
Requests Mongo Database Created

Mongo Database Created
MongoDBDatabaseCreate Count Count ResourceName, ApiKind, ApiKindResourceType, OperationType PT5M No
Requests Mongo Database Updated

Mongo Database Updated
MongoDBDatabaseUpdate Count Count ResourceName, ApiKind, ApiKindResourceType, OperationType PT5M No
Requests Mongo Request Charge

Mongo Request Units Consumed
MongoRequestCharge Count Total (Sum), Average, Maximum DatabaseName, CollectionName, Region, CommandName, ErrorCode, Status PT1M Yes
Requests Mongo Requests

Number of Mongo Requests Made
MongoRequests Count Count DatabaseName, CollectionName, Region, CommandName, ErrorCode, Status PT1M Yes
Requests Normalized RU Consumption

Max RU consumption percentage per minute
NormalizedRUConsumption Percent Maximum, Average CollectionName, DatabaseName, Region, PartitionKeyRangeId, CollectionRid, PhysicalPartitionId, OfferOwnerRid PT1M, PT5M, PT1H, P1D No
Requests Region Offlined

Region Offlined
OfflineRegion Count Count Region, StatusCode, Role, OperationName PT1M No
Requests Region Onlined

Region Onlined
OnlineRegion Count Count Region, StatusCode, Role, OperationName PT1M No
Requests Physical Partition Count

Physical Partition Count
PhysicalPartitionCount Count Maximum CollectionName, DatabaseName, IsSharedThroughputOffer, OfferOwnerRid, Region PT5M Yes
Requests Physical Partition Size

Physical Partition Size in bytes
PhysicalPartitionSizeInfo Bytes Maximum, Average CollectionName, DatabaseName, PhysicalPartitionId, OfferOwnerRid, Region PT1M, PT5M, PT1H, P1D No
Requests Physical Partition Throughput

Physical Partition Throughput
PhysicalPartitionThroughputInfo Count Maximum CollectionName, DatabaseName, PhysicalPartitionId, OfferOwnerRid, Region PT5M, PT1H, P1D No
Requests Provisioned Throughput

Provisioned Throughput
ProvisionedThroughput Count Maximum DatabaseName, CollectionName, Region PT5M, PT1H, P1D No
Requests Region Failed Over

Region Failed Over
RegionFailover Count Count <none> PT5M Yes
Requests Region Removed

Region Removed
RemoveRegion Count Count Region PT5M Yes
Requests P99 Replication Latency

P99 Replication Latency across source and target regions for geo-enabled account
ReplicationLatency MilliSeconds Minimum, Maximum, Average SourceRegion, TargetRegion PT1M Yes
Requests (deprecated) Server Side Latency

"Server Side Latency" will be removed from Azure Monitor at the end of August 2025. Please use "Server Side Latency Direct" and "Server Side Latency Gateway" to monitor the latency instead. For more info about latency metrics, please refer to this /azure/cosmos-db/monitor-server-side-latency.
ServerSideLatency MilliSeconds Average, Minimum, Maximum, Total (Sum) DatabaseName, CollectionName, Region, ConnectionMode, OperationType, PublicAPIType PT1M, PT5M, PT1H, P1D No
Requests Server Side Latency Direct

Server Side Latency in Direct Connection Mode
ServerSideLatencyDirect MilliSeconds Average, Minimum, Maximum, Total (Sum) DatabaseName, CollectionName, Region, ConnectionMode, OperationType, PublicAPIType, APIType, IsExternal PT1M, PT5M, PT1H, P1D No
Requests Server Side Latency Gateway

Server Side Latency in Gateway Connection Mode
ServerSideLatencyGateway MilliSeconds Average, Minimum, Maximum, Total (Sum) DatabaseName, CollectionName, Region, ConnectionMode, OperationType, PublicAPIType, APIType, IsExternal PT1M, PT5M, PT1H, P1D No
Requests Service Availability

Account requests availability at one hour, day or month granularity
ServiceAvailability Percent Minimum, Average, Maximum IsExternal PT1H No
Requests Sql Container Created

Sql Container Created
SqlContainerCreate Count Count ResourceName, ChildResourceName, ApiKind, ApiKindResourceType, IsThroughputRequest, OperationType PT5M No
Requests Sql Container Deleted

Sql Container Deleted
SqlContainerDelete Count Count ResourceName, ChildResourceName, ApiKind, ApiKindResourceType, OperationType PT5M No
Requests Sql Container Throughput Updated

Sql Container Throughput Updated
SqlContainerThroughputUpdate Count Count ResourceName, ChildResourceName, ApiKind, ApiKindResourceType, IsThroughputRequest PT5M No
Requests Sql Container Updated

Sql Container Updated
SqlContainerUpdate Count Count ResourceName, ChildResourceName, ApiKind, ApiKindResourceType, IsThroughputRequest, OperationType PT5M No
Requests Sql Database Created

Sql Database Created
SqlDatabaseCreate Count Count ResourceName, ApiKind, ApiKindResourceType, IsThroughputRequest, OperationType PT5M No
Requests Sql Database Deleted

Sql Database Deleted
SqlDatabaseDelete Count Count ResourceName, ApiKind, ApiKindResourceType, OperationType PT5M No
Requests Sql Database Throughput Updated

Sql Database Throughput Updated
SqlDatabaseThroughputUpdate Count Count ResourceName, ApiKind, ApiKindResourceType, IsThroughputRequest PT5M No
Requests Sql Database Updated

Sql Database Updated
SqlDatabaseUpdate Count Count ResourceName, ApiKind, ApiKindResourceType, IsThroughputRequest, OperationType PT5M No
Requests AzureTable Table Created

AzureTable Table Created
TableTableCreate Count Count ResourceName, ApiKind, ApiKindResourceType, IsThroughputRequest, OperationType PT5M No
Requests AzureTable Table Deleted

AzureTable Table Deleted
TableTableDelete Count Count ResourceName, ApiKind, ApiKindResourceType, OperationType PT5M No
Requests AzureTable Table Throughput Updated

AzureTable Table Throughput Updated
TableTableThroughputUpdate Count Count ResourceName, ApiKind, ApiKindResourceType, IsThroughputRequest PT5M No
Requests AzureTable Table Updated

AzureTable Table Updated
TableTableUpdate Count Count ResourceName, ApiKind, ApiKindResourceType, IsThroughputRequest, OperationType PT5M No
Requests Total Requests

Number of requests made
TotalRequests Count Count DatabaseName, CollectionName, Region, StatusCode, OperationType, Status, CapacityType, PriorityLevel, ConnectionMode, IsExternal PT1M No
Requests Total Requests (Preview)

Number of SQL requests
TotalRequestsPreview Count Count DatabaseName, CollectionName, Region, StatusCode, OperationType, Status, PriorityLevel, IsExternal PT1M No
Requests Total Request Units

SQL Request Units consumed
TotalRequestUnits Count Total (Sum), Average, Maximum DatabaseName, CollectionName, Region, StatusCode, OperationType, Status, CapacityType, PriorityLevel PT1M Yes
Requests Total Request Units (Preview)

Request Units consumed with CapacityType
TotalRequestUnitsPreview Count Total (Sum), Average, Maximum DatabaseName, CollectionName, Region, StatusCode, OperationType, Status, CapacityType, PriorityLevel PT1M No
Requests Account Keys Updated

Account Keys Updated
UpdateAccountKeys Count Count KeyType PT5M Yes
Requests Account Network Settings Updated

Account Network Settings Updated
UpdateAccountNetworkSettings Count Count <none> PT5M Yes
Requests Account Replication Settings Updated

Account Replication Settings Updated
UpdateAccountReplicationSettings Count Count <none> PT5M Yes
Requests Account Diagnostic Settings Updated

Account Diagnostic Settings Updated
UpdateDiagnosticsSettings Count Count DiagnosticSettingsName, ResourceGroupName PT5M No

Next steps