Настройка Управление Azure для Grafana MCP для агентов Azure AI Foundry

В этой статье показано, как настроить конечную точку Управление Azure для Grafana MCP в агенте Azure AI Foundry. После настройки агент может использовать средства MCP для запроса ресурсов Azure, метрик, журналов и панелей мониторинга с помощью рабочей области Управление Azure для Grafana.

Необходимые условия

• Подписка Azure с разрешением на создание ресурсов Azure и управление ими.
• Управляемая рабочая область Azure Grafana. Если вам нужно создать такую, см. Краткое руководство: создание рабочей области Управление Azure для Grafana.
• Проект Azure AI Foundry, в котором можно создать агент.
• Разрешение на назначение ролей управления доступом на основе ролей Azure (RBAC) в ресурсе Управление Azure для Grafana.
• Настроенный источник данных Grafana для рабочих нагрузок, которые требуется запрашивать агент (например, Azure Monitor для Resource Graph, метрик и журналов). Инструкции по настройке см. в разделе "Настройка источников данных".

Получите конечную точку Управление Azure для Grafana

При настройке средства в Foundry используется имя узла конечной точки.

1. В портале Azure откройте ресурс Управление Azure для Grafana.

2. На странице обзора скопируйте значение конечной точки . Например: my-grafana-<id>.<region>.grafana.azure.com.

   

Предоставьте проекту Foundry доступ к Управление Azure для Grafana

Проект Azure AI Foundry использует управляемое удостоверение для доступа к средствам и источникам данных.

1. На портале Azure откройте ресурс Управление Azure для Grafana.

2. Выберите элемент управления доступом (IAM)>Добавить>Добавить назначение роли.

3. Назначьте одну из этих ролей управляемому удостоверению проекта Foundry:

   • Администратор Grafana
   • Редактор Grafana
   • Средство просмотра Grafana

   Выберите наименьшую привилегированную роль, которая удовлетворяет вашему сценарию.

Чтобы найти правильный субъект, выполните следующие действия.

1. Откройте проект Foundry на портале Azure.
2. Используйте управляемую идентификацию, показанную в разделе Identity.

Создание агента в Azure AI Foundry

1. Откройте Azure AI Foundry и перейдите к проекту.

2. Выберите Агенты>+ Создать нового агента.

3. Выберите модель, которая поддерживает вызов инструментов. В этом примере мы используем gpt-5.1.

4. Введите имя и описание агента.

   

Добавьте инструмент MCP Grafana, управляемый через Azure

1. В конфигурации агента перейдите в раздел "Сервис".

2. Нажмите кнопку +Добавить инструмент.

3. Выберите каталог, а затем выберите Управление Azure для Grafana.

   

4. Настройте параметры средства:

   Setting	Ценность
   хост рабочей области	Имя узла конечной точки управляемой Grafana в Azure. Введите только имя узла. Не включайте https:// или /api/azure-mcp.
   Аутентификация	Microsoft Entra
   Тип	Управляемая идентичность проекта
   Публика	Аудитория Управление Azure для Grafana:6f2d169c-08f3-4a4c-a982-bcaf2d038c45

   

Проверка примера

После сохранения конфигурации средства проверьте настройку из чата агента.

1. Откройте панель чата для агента.

2. Отправьте запрос на подключение, например список всех подписок Azure, доступных с помощью Управление Azure для Grafana MCP.

3. Убедитесь, что ответ содержит специфические данные инструмента, а не общий ответ модели.

   

Примеры подсказок

Вы можете использовать любой из приведённых ниже примеров запросов.

• List all Azure Managed Grafana instances in my subscriptions.
• Show me all virtual machines in resource group <resource-group-name>.
• Find all storage accounts with public access enabled.

Устранение неполадок с проверкой

Если проверка завершается ошибкой:

• Проверьте, что управляемая идентичность имеет роль Grafana в ресурсе Управление Azure для Grafana.
• Убедитесь, что значение имени хоста рабочего пространства — только имя хоста Grafana.
• Убедитесь, что аудитория 6f2d169c-08f3-4a4c-a982-bcaf2d038c45.
• Убедитесь, что источник данных Grafana, необходимый запросу, существует и может получить доступ к целевой области Azure.
• Проверьте задержку распространения RBAC и повторите попытку через несколько минут.

Общие рекомендации по токенам и пример использования API см. в статье Проверка подлинности в API плоскости данных Управление Azure для Grafana с помощью Microsoft Entra ID.

Очистите ресурсы

Если вы создали ресурсы только для этого теста, удалите доступ и ресурсы, чтобы избежать текущих расходов.

1. Удалите назначение тестовой роли из ресурса Управление Azure для Grafana:

   1. Откройте управление доступом (IAM) в ресурсе Управление Azure для Grafana.
   2. Выберите Назначения ролей.
   3. Найдите назначение управляемой идентичности проекта Foundry и удалите его.

2. В Azure AI Foundry удалите средство Управление Azure для Grafana из агента или удалите агент тестирования.

3. При необходимости удалите тестовые ресурсы, такие как проект Foundry и рабочую область Управление Azure для Grafana, если они были созданы только для этого пошагового руководства.

Дальнейшие действия

• Дополнительные сведения о удаленной конечной точке MCP см. в разделе "Настройка удаленного сервера MCP Управление Azure для Grafana".
• Ознакомьтесь с примерами панелей мониторинга в разделе "Создание панелей мониторинга для приложений GenAI".
• Ознакомьтесь с более подробными рекомендациями по токенам в статье Проверка подлинности в API уровня данных Управление Azure для Grafana с помощью Microsoft Entra ID.