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. Valid range: 60 -1440 minutes. |
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. Valid range: 8 - 720 hours. |
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 |