# Ingest Azure Monitor Metrics

groundcover supports ingesting Azure Monitor metrics directly into our platform, allowing you to visualize them using dashboards and create alerts.

## Things to know <a href="#key-things-to-know" id="key-things-to-know"></a>

### Tenancy restrictions

The method below is relevant only for subscriptions in the same tenant as the managed BYOC set up by groundcover.

### **Ingestion interval**

The integration pulls data from Azure Monitor according to this interval. The lower the interval, the higher the polling rate and as a result, the overall costs will be higher. The interval can be altered in the Advanced Settings in the configuration wizard.

### **Data storage**

Data fetched is stored in the Victoria Metrics database, meaning metrics are queried via the Azure Monitor API only one time per data point.

### Supported services

groundcover can support the ingestion of every Azure service listed in the Azure [docs](https://learn.microsoft.com/en-us/azure/azure-monitor/reference/metrics-index).

## Setting up the integration

The integration setup is done directly through the App by following these steps:

1. Navigate to Settings > Integrations > Data Sources or following [this link](https://app.groundcover.com/settings/integrations/data-sources). Note that only users with Admin permissions can navigate to this page.
2. Select Microsoft Azure and follow the 3 steps in the wizard. Note that in order for the integration to work, a role assignment should be created, granting groundcover with permissions to poll metrics. To create a role assignment, please follow the guidelines in the next section.

### Create a Role Assignment

{% hint style="info" %}
The following steps requires the details of a dedicated managed identity to set up the integration.

Make sure it has been provided to you by the groundcover team
{% endhint %}

1. Go to the subscription where you want to collect metrics from.
2. Navigate to **Access Control (IAM)**.
3. Add a new role assignment
   * Click on **Add -> Add role assignment**.
   * Search and select the **Monitoring Reader** role.
   * Click **Next**.
   * In **Assign access to** choose **Managed identity.**
   * Click **Select members**.
   * From the groundcover subscription, in **Managed Identity** choose **User assigned managed identity** and select the integrations identity by the **integrations identity provided by groundcover.**
   * Select **Review + Assign**


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.groundcover.com/integrations/data-sources/azure/ingest-azure-monitor-metrics.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
