The Azure Cosmos DB integration collects platform metrics and diagnostic logs from your Request Unit (RU) based Azure Cosmos DB accounts. Once enabled, the SigNoz agent discovers Cosmos DB account resources in your monitored resource groups and configures telemetry collection.
This integration collects platform metrics for the Microsoft.DocumentDB/databaseAccounts resource type — the RU-based Azure Cosmos DB account.
Getting started
Connect your Azure subscription first. See Azure One-Click Integrations for setup instructions.
Once connected:
- In SigNoz, navigate to Integrations > Microsoft Azure.
- Select Cosmos DB from the left panel.
- Toggle Log Collection and Metric Collection on.
The agent deploys the necessary Event Hubs and diagnostic settings in the background. Data starts flowing within a few minutes. Navigate to Dashboards and open the Azure Cosmos DB Overview dashboard to confirm metrics are appearing.
What's collected
Logs
| Name | Path | Type |
|---|---|---|
| Resource ID | resources.azure.resource.id | string |
Key metrics
The table below lists representative metrics; see the Data Collected tab in the integration for the complete list, including per-API request metrics.
| Metric name | Unit | Type |
|---|---|---|
azure_totalrequests_count | Count | Gauge |
azure_totalrequestunits_total | Count | Sum |
azure_normalizedruconsumption_maximum | Percent | Gauge |
azure_provisionedthroughput_maximum | Count | Gauge |
azure_autoscalemaxthroughput_maximum | Count | Gauge |
azure_datausage_total | Bytes | Sum |
azure_indexusage_total | Bytes | Sum |
azure_documentquota_total | Bytes | Sum |
azure_documentcountv2_total | Count | Sum |
azure_serversidelatencydirect_average | Milliseconds | Gauge |
azure_serversidelatencygateway_average | Milliseconds | Gauge |
azure_replicationlatency_average | Milliseconds | Gauge |
azure_serviceavailability_average | Percent | Gauge |
Dashboards
The integration includes a pre-built Azure Cosmos DB dashboard. Pre-built dashboards are locked and cannot be edited. To customize, use Export JSON from the dashboard menu and import it as a new dashboard.
Key panels include:
- Total requests and total request units (RU)
- Normalized RU consumption and provisioned throughput
- Data usage, index usage, and document quota
- Document count
- Server-side latency (direct) and service availability
Next steps
- Create alerts to get notified on RU saturation, latency spikes, or availability drops
- Build custom dashboards to correlate database metrics with application performance
Get Help
If you need help with the steps in this topic, please reach out to us on SigNoz Community Slack. If you are a SigNoz Cloud user, please use in product chat support located at the bottom right corner of your SigNoz instance or contact us at cloud-support@signoz.io.
