Microsoft Azure Cosmos DB

Overview

Azure Cosmos DB is a globally distributed, multi-model database service that supports document, key-value, wide-column, and graph databases.

Use the Datadog Azure integration to collect metrics from Cosmos DB.

Setup

Installation

If you haven’t already, set up the Microsoft Azure integration first. There are no other installation steps.

Data Collected

Metrics

azure.cosmosdb.add_region
(count)
Region Added
azure.cosmosdb.autoscale_max_throughput
(count)
Autoscale Max Throughput
azure.cosmosdb.available_storage
(gauge)
Total available storage reported at 5 minutes granularity per region
Shown as byte
azure.cosmosdb.cassandra_connection_closures
(count)
The number of Cassandra connections that were closed
Shown as connection
azure.cosmosdb.cassandra_connector_avg_replication_latency
(count)
Cassandra Connector Average Replication Latency
Shown as millisecond
azure.cosmosdb.cassandra_connector_replication_health_status
(count)
Cassandra Connector Replication Health Status
azure.cosmosdb.cassandra_keyspace_create
(count)
Cassandra Keyspace Created
azure.cosmosdb.cassandra_keyspace_delete
(count)
Cassandra Keyspace Deleted
azure.cosmosdb.cassandra_keyspace_throughput_update
(count)
Cassandra Keyspace Throughput Updated
azure.cosmosdb.cassandra_keyspace_update
(count)
Cassandra Keyspace Updated
azure.cosmosdb.cassandra_request_charges
(count)
RUs consumed for Cassandra requests made
azure.cosmosdb.cassandra_requests
(count)
The number of Cassandra requests made
Shown as request
azure.cosmosdb.cassandra_table_create
(count)
Cassandra table created
Shown as table
azure.cosmosdb.cassandra_table_delete
(count)
Cassandra Table Deleted
Shown as table
azure.cosmosdb.cassandra_table_throughput_update
(count)
Cassandra Table Throughput Updated
azure.cosmosdb.cassandra_table_update
(count)
Cassandra Table Updated
Shown as table
azure.cosmosdb.count
(gauge)
Count of Cosmos DB
azure.cosmosdb.status
(gauge)
Status of Cosmos DB (deprecated)
azure.cosmosdb.create_account
(count)
Account Created
azure.cosmosdb.data_usage
(gauge)
Total data usage reported at 5 minutes granularity per region
Shown as byte
azure.cosmosdb.dedicated_gateway_average_cpu_usage
(gauge)
The average CPU usage across dedicated gateway instances
Shown as percent
azure.cosmosdb.dedicated_gateway_average_memory_usage
(gauge)
The average memory usage across dedicated gateway instances, which is used for both routing requests and caching data
Shown as byte
azure.cosmosdb.dedicated_gateway_maximum_cpu_usage
(gauge)
The average Maximum CPU usage across dedicated gateway instances
Shown as percent
azure.cosmosdb.dedicated_gateway_requests
(count)
Dedicated Gateway Requests
Shown as request
azure.cosmosdb.delete_account
(count)
Account Deleted
azure.cosmosdb.document_count
(count)
Total document count reported at 5 minutes granularity per region.
Shown as document
azure.cosmosdb.document_quota
(gauge)
Total storage quota reported at 5 minutes granularity per region.
Shown as byte
azure.cosmosdb.gremlin_database_create
(count)
Gremlin Database Created
azure.cosmosdb.gremlin_database_delete
(count)
Gremlin Database Deleted
azure.cosmosdb.gremlin_database_throughput_update
(count)
Gremlin Database Throughput Updated
azure.cosmosdb.gremlin_database_update
(count)
Gremlin Database Updated
azure.cosmosdb.gremlin_graph_create
(count)
Gremlin Graph Created
azure.cosmosdb.gremlin_graph_delete
(count)
Gremlin Graph Deleted
azure.cosmosdb.gremlin_graph_throughput_update
(count)
Gremlin Graph Throughput Updated
azure.cosmosdb.gremlin_graph_update
(count)
Gremlin Graph Updated
azure.cosmosdb.index_usage
(gauge)
Total Index usage reported at 5 minutes granularity per region
Shown as byte
azure.cosmosdb.integrated_cache_evicted_entries_size
(count)
Size of the entries evicted from the integrated cache
Shown as byte
azure.cosmosdb.integrated_cache_item_expiration_count
(count)
The number of items evicted from the integrated cache due to TTL expiration
azure.cosmosdb.integrated_cache_item_hit_rate
(rate)
The number of point reads that used the integrated cache divided by the number of point reads routed through the dedicated gateway with eventual consistency
Shown as percent
azure.cosmosdb.integrated_cache_query_expiration_count
(count)
The number of queries evicted from the integrated cache due to TTL expiration
azure.cosmosdb.integrated_cache_query_hit_rate
(rate)
The number of queries that used the integrated cache divided by the number of queries routed through the dedicated gateway with eventual consistency
Shown as percent
azure.cosmosdb.metadata_requests
(count)
Count of metadata requests. Cosmos DB maintains system metadata collection for each account that allows you to enumerate collections databases etc and their configurations.
Shown as request
azure.cosmosdb.mongo_collection_create
(count)
Mongo Collection Created
azure.cosmosdb.mongo_collection_delete
(count)
Mongo Collection Deleted
azure.cosmosdb.mongo_collection_throughput_update
(count)
Mongo Collection Throughput Updated
azure.cosmosdb.mongo_collection_update
(count)
Mongo Collection Updated
azure.cosmosdb.mongo_database_delete
(count)
Mongo Database Deleted
azure.cosmosdb.mongo_database_throughput_update
(count)
Mongo Database Throughput Updated
azure.cosmosdb.mongodb_database_create
(count)
Mongo Database Created
azure.cosmosdb.mongodb_database_update
(count)
Mongo Database Updated
azure.cosmosdb.mongo_request_charge
(count)
Mongo Request Units Consumed
azure.cosmosdb.mongo_requests
(count)
The number of Mongo requests made
Shown as request
azure.cosmosdb.normalized_ru_consumption
(count)
Max RU consumption percentage per minute
Shown as percent
azure.cosmosdb.provisioned_throughput
(count)
Provisioned Throughput
azure.cosmosdb.region_failover
(count)
Region Failed Over
azure.cosmosdb.remove_region
(count)
Region Removed
azure.cosmosdb.replication_latency
(count)
P99 Replication Latency across source and target regions for geo-enabled accounts
Shown as millisecond
azure.cosmosdb.server_side_latency
(count)
Server Side Latency
Shown as millisecond
azure.cosmosdb.service_availability
(count)
Account requests availability at one hour, day, or month granularity
Shown as percent
azure.cosmosdb.sql_container_create
(count)
Sql Container Created
azure.cosmosdb.sql_container_delete
(count)
Sql Container Deleted
azure.cosmosdb.sql_container_throughput_update
(count)
Sql Container Throughput Updated
azure.cosmosdb.sql_container_update
(count)
Sql Container Updated
azure.cosmosdb.sql_database_create
(count)
Sql Database Created
azure.cosmosdb.sql_database_delete
(count)
Sql Database Deleted
azure.cosmosdb.sql_database_throughput_update
(count)
Sql Database Throughput Updated
azure.cosmosdb.sql_database_update
(count)
Sql Database Updated
azure.cosmosdb.table_table_create
(count)
AzureTable Table Created
azure.cosmosdb.table_table_delete
(count)
AzureTable Table Deleted
azure.cosmosdb.table_table_throughput_update
(count)
AzureTable Table Throughput Updated
azure.cosmosdb.table_table_update
(count)
AzureTable Table Updated
azure.cosmosdb.total_requests
(count)
The number of requests made
Shown as request
azure.cosmosdb.total_request_units
(count)
Request Units consumed
azure.cosmosdb.update_account_keys
(count)
Account Keys Updated
azure.cosmosdb.update_account_network_settings
(count)
Account Network Settings Updated
azure.cosmosdb.update_account_replication_settings
(count)
Account Replication Settings Updated
azure.cosmosdb.update_diagnostics_settings
(count)
Account Diagnostic Settings Updated
azure.documentdb_cassandraclusters.cassandra_cache_capacity
(gauge)
Cache capacity in bytes.
Shown as byte
azure.documentdb_cassandraclusters.cassandra_cache_entries
(gauge)
Total number of cache entries.
azure.documentdb_cassandraclusters.cassandra_cache_hit_rate
(gauge)
All time cache hit rate.
Shown as percent
azure.documentdb_cassandraclusters.cassandra_cache_hits
(count)
Total number of cache hits.
azure.documentdb_cassandraclusters.cassandra_cache_miss_latency_histogram
(count)
Histogram of cache miss latency (in microseconds).
azure.documentdb_cassandraclusters.cassandra_cache_miss_latency_p99
(gauge)
p99 Latency of misses.
azure.documentdb_cassandraclusters.cassandra_cache_requests
(count)
Total number of cache requests.
azure.documentdb_cassandraclusters.cassandra_cache_size
(gauge)
Total size of occupied cache; in bytes.
Shown as byte
azure.documentdb_cassandraclusters.cassandra_client_auth_failure
(count)
Number of failed client authentication requests.
azure.documentdb_cassandraclusters.cassandra_client_auth_success
(count)
Number of successful client authentication requests.
azure.documentdb_cassandraclusters.cassandra_client_request_condition_not_met
(count)
Number of transaction preconditions did not match current values.
azure.documentdb_cassandraclusters.cassandra_client_request_contention_histogram
(count)
How many contended reads/writes were encountered.
azure.documentdb_cassandraclusters.cassandra_client_request_contention_histogram_p99
(gauge)
p99 How many contended writes were encountered.
azure.documentdb_cassandraclusters.cassandra_client_request_failures
(count)
Number of transaction failures encountered.
azure.documentdb_cassandraclusters.cassandra_client_request_latency_histogram
(count)
Histogram of client request latency (in microseconds).
azure.documentdb_cassandraclusters.cassandra_client_request_latency_p99
(gauge)
p99 Latency.
azure.documentdb_cassandraclusters.cassandra_client_request_timeouts
(count)
Number of timeouts encountered.
azure.documentdb_cassandraclusters.cassandra_client_request_unfinished_commit
(count)
Number of transactions that were committed on write.
azure.documentdb_cassandraclusters.cassandra_commit_log_waiting_on_commit_latency_histogram
(count)
Histogram of the time spent waiting on CL fsync (in microseconds); for Periodic this is only occurs when the sync is lagging its sync interval.
azure.documentdb_cassandraclusters.cassandra_cql_prepared_statements_executed
(count)
Number of prepared statements executed.
azure.documentdb_cassandraclusters.cassandra_cql_regular_statements_executed
(count)
Number of non prepared statements executed.
azure.documentdb_cassandraclusters.cassandra_jvm_gc_count
(gauge)
Total number of collections that have occurred.
azure.documentdb_cassandraclusters.cassandra_jvm_gc_time
(gauge)
Approximate accumulated collection elapsed time.
Shown as millisecond
azure.documentdb_cassandraclusters.cassandra_table_all_memtables_live_data_size
(gauge)
Total amount of live data stored in the memtables (2i and pending flush memtables included) that resides off-heap; excluding any data structure overhead.
azure.documentdb_cassandraclusters.cassandra_table_all_memtables_off_heap_size
(gauge)
Total amount of data stored in the memtables (2i and pending flush memtables included) that resides off-heap.
azure.documentdb_cassandraclusters.cassandra_table_bloom_filter_disk_space_used
(gauge)
Disk space used by bloom filter (in bytes).
Shown as byte
azure.documentdb_cassandraclusters.cassandra_table_bloom_filter_false_positives
(gauge)
Number of false positives on table's bloom filter.
azure.documentdb_cassandraclusters.cassandra_table_bloom_filter_false_ratio
(gauge)
False positive ratio of table's bloom filter.
Shown as percent
azure.documentdb_cassandraclusters.cassandra_table_bloom_filter_off_heap_memory_used
(gauge)
Off-heap memory used by bloom filter.
azure.documentdb_cassandraclusters.cassandra_table_bytes_flushed
(count)
Total number of bytes flushed since server [re]start.
Shown as byte
azure.documentdb_cassandraclusters.cassandra_table_cas_commit
(count)
Latency of paxos commit round.
azure.documentdb_cassandraclusters.cassandra_table_cas_commit_p99
(gauge)
p99 Latency of paxos commit round.
azure.documentdb_cassandraclusters.cassandra_table_cas_prepare
(count)
Latency of paxos prepare round.
azure.documentdb_cassandraclusters.cassandra_table_cas_prepare_p99
(gauge)
p99 Latency of paxos prepare round.
azure.documentdb_cassandraclusters.cassandra_table_cas_propose
(count)
Latency of paxos propose round.
azure.documentdb_cassandraclusters.cassandra_table_cas_propose_p99
(gauge)
p99 Latency of paxos propose round.
azure.documentdb_cassandraclusters.cassandra_table_col_update_time_delta_histogram
(count)
Column update time delta on this table.
azure.documentdb_cassandraclusters.cassandra_table_col_update_time_delta_histogram_p99
(gauge)
p99 Column update time delta on this table.
azure.documentdb_cassandraclusters.cassandra_table_compaction_bytes_written
(count)
Total number of bytes written by compaction since server [re]start.
Shown as byte
azure.documentdb_cassandraclusters.cassandra_table_compression_metadata_off_heap_memory_used
(gauge)
Off-heap memory used by compression meta data.
azure.documentdb_cassandraclusters.cassandra_table_compression_ratio
(gauge)
Current compression ratio for all SSTables.
Shown as percent
azure.documentdb_cassandraclusters.cassandra_table_coordinator_read_latency
(count)
Coordinator read latency for this table.
azure.documentdb_cassandraclusters.cassandra_table_coordinator_read_latency_p99
(gauge)
p99 Coordinator read latency for this table.
azure.documentdb_cassandraclusters.cassandra_table_coordinator_scan_latency
(count)
Coordinator range scan latency for this table.
azure.documentdb_cassandraclusters.cassandra_table_coordinator_scan_latency_p99
(gauge)
p99 Coordinator range scan latency for this table.
azure.documentdb_cassandraclusters.cassandra_table_dropped_mutations
(count)
Number of dropped mutations on this table.
azure.documentdb_cassandraclusters.cassandra_table_estimated_column_count_histogram
(count)
Estimated number of columns.
azure.documentdb_cassandraclusters.cassandra_table_estimated_column_count_histogram_p99
(gauge)
p99 Estimated number of columns.
azure.documentdb_cassandraclusters.cassandra_table_estimated_partition_count
(gauge)
Approximate number of keys in table.
azure.documentdb_cassandraclusters.cassandra_table_estimated_partition_size_histogram
(count)
Histogram of estimated partition size.
Shown as byte
azure.documentdb_cassandraclusters.cassandra_table_estimated_partition_size_histogram_p99
(gauge)
p99 Estimated partition size (in bytes).
Shown as byte
azure.documentdb_cassandraclusters.cassandra_table_index_summary_off_heap_memory_used
(gauge)
Off-heap memory used by index summary.
azure.documentdb_cassandraclusters.cassandra_table_key_cache_hit_rate
(gauge)
Key cache hit rate for this table.
Shown as percent
azure.documentdb_cassandraclusters.cassandra_table_live_disk_space_used
(count)
Disk space used by SSTables belonging to this table (in bytes).
Shown as byte
azure.documentdb_cassandraclusters.cassandra_table_live_scanned_histogram
(count)
Live cells scanned in queries on this table.
azure.documentdb_cassandraclusters.cassandra_table_live_scanned_histogram_p99
(gauge)
p99 Live cells scanned in queries on this table.
azure.documentdb_cassandraclusters.cassandra_table_live_sstable_count
(gauge)
Number of SSTables on disk for this table.
azure.documentdb_cassandraclusters.cassandra_table_max_partition_size
(gauge)
Size of the largest compacted partition (in bytes).
Shown as byte
azure.documentdb_cassandraclusters.cassandra_table_mean_partition_size
(gauge)
Size of the average compacted partition (in bytes).
Shown as byte
azure.documentdb_cassandraclusters.cassandra_table_memtable_columns_count
(gauge)
Total number of columns present in the memtable.
azure.documentdb_cassandraclusters.cassandra_table_memtable_off_heap_size
(gauge)
Total amount of data stored in the memtable that resides off-heap; including column related overhead and partitions overwritten.
azure.documentdb_cassandraclusters.cassandra_table_memtable_on_heap_size
(gauge)
Total amount of data stored in the memtable that resides on-heap; including column related overhead and partitions overwritten.
azure.documentdb_cassandraclusters.cassandra_table_memtable_switch_count
(count)
Number of times flush has resulted in the memtable being switched out.
azure.documentdb_cassandraclusters.cassandra_table_min_partition_size
(gauge)
Size of the smallest compacted partition (in bytes).
Shown as byte
azure.documentdb_cassandraclusters.cassandra_table_pending_compactions
(gauge)
Estimate of number of pending compactions for this table.
azure.documentdb_cassandraclusters.cassandra_table_pending_flushes
(count)
Estimated number of flush tasks pending for this table.
azure.documentdb_cassandraclusters.cassandra_table_percent_repaired
(gauge)
Percent of table data that is repaired on disk.
Shown as percent
azure.documentdb_cassandraclusters.cassandra_table_range_latency
(count)
Local range scan latency for this table.
azure.documentdb_cassandraclusters.cassandra_table_range_latency_p99
(gauge)
p99 Local range scan latency for this table.
azure.documentdb_cassandraclusters.cassandra_table_read_latency
(count)
Local read latency for this table.
azure.documentdb_cassandraclusters.cassandra_table_read_latency_p99
(gauge)
p99 Local read latency for this table.
azure.documentdb_cassandraclusters.cassandra_table_row_cache_hit
(count)
Number of table row cache hits.
azure.documentdb_cassandraclusters.cassandra_table_row_cache_hit_out_of_range
(count)
Number of table row cache hits that do not satisfy the query filter; thus went to disk.
azure.documentdb_cassandraclusters.cassandra_table_row_cache_miss
(count)
Number of table row cache misses.
azure.documentdb_cassandraclusters.cassandra_table_speculative_retries
(count)
Number of times speculative retries were sent for this table.
azure.documentdb_cassandraclusters.cassandra_table_sstables_per_read_histogram
(count)
Number of sstable data files accessed per single partition read. SSTables skipped due to Bloom Filters; min-max key or partition index lookup are not taken into account.
azure.documentdb_cassandraclusters.cassandra_table_sstables_per_read_histogram_p99
(gauge)
p99 Number of sstable data files accessed per single partition read. SSTables skipped due to Bloom Filters; min-max key or partition index lookup are not taken into account.
azure.documentdb_cassandraclusters.cassandra_table_tombstone_scanned_histogram
(count)
Tombstones scanned in queries on this table.
azure.documentdb_cassandraclusters.cassandra_table_tombstone_scanned_histogram_p99
(gauge)
p99 Tombstones scanned in queries on this table.
azure.documentdb_cassandraclusters.cassandra_table_total_disk_space_used
(count)
Total disk space used by SSTables belonging to this table; including obsolete ones waiting to be GC'd.
azure.documentdb_cassandraclusters.cassandra_table_view_lock_acquire_time
(count)
Time taken acquiring a partition lock for materialized view updates on this table.
azure.documentdb_cassandraclusters.cassandra_table_view_lock_acquire_time_p99
(gauge)
p99 Time taken acquiring a partition lock for materialized view updates on this table.
azure.documentdb_cassandraclusters.cassandra_table_view_read_time
(count)
Time taken during the local read of a materialized view update.
azure.documentdb_cassandraclusters.cassandra_table_view_read_time_p99
(gauge)
p99 Time taken during the local read of a materialized view update.
azure.documentdb_cassandraclusters.cassandra_table_waiting_on_free_memtable_space
(count)
Time spent waiting for free memtable space; either on- or off-heap.
azure.documentdb_cassandraclusters.cassandra_table_waiting_on_free_memtable_space_p99
(gauge)
p99 Time spent waiting for free memtable space; either on- or off-heap.
azure.documentdb_cassandraclusters.cassandra_table_write_latency
(count)
Local write latency for this table.
azure.documentdb_cassandraclusters.cassandra_table_write_latency_p99
(gauge)
p99 Local write latency for this table.
azure.documentdb_cassandraclusters.cassandra_thread_pools_active_tasks
(gauge)
Number of tasks being actively worked on by this pool.
azure.documentdb_cassandraclusters.cassandra_thread_pools_currently_blocked_tasks
(count)
Number of tasks that are currently blocked due to queue saturation but on retry will become unblocked.
azure.documentdb_cassandraclusters.cassandra_thread_pools_max_pool_size
(gauge)
The maximum number of threads in this pool.
azure.documentdb_cassandraclusters.cassandra_thread_pools_pending_tasks
(gauge)
Number of queued tasks queued up on this pool.
azure.documentdb_cassandraclusters.cassandra_thread_pools_total_blocked_tasks
(count)
Number of tasks that were blocked due to queue saturation.
azure.documentdb_cassandraclusters.count
(gauge)
Count of Cassandra clusters
azure.documentdb_cassandraclusters.status
(gauge)
Status of Cassandra clusters (deprecated)

Events

The Azure Cosmos DB integration does not include any events.

Service Checks

The Azure Cosmos DB integration does not include any service checks.

Troubleshooting

Need help? Contact Datadog support.

Further Reading

Additional helpful documentation, links, and articles: