Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Сервер протокола контекста модели Azure (MCP) позволяет управлять ресурсами Azure Monitor и рабочими книгами с помощью запросов на естественном языке. Вы можете запрашивать рабочие области Log Analytics, анализировать операционные данные, отслеживать работоспособность ресурсов, получать метрики производительности, управлять веб-тестами доступности, оркестрацией рабочих процессов инструментирования и управлять рабочими книгами Azure Monitor.
Azure Monitor помогает повысить доступность и производительность приложений и служб. Он предоставляет комплексное решение для сбора, анализа и выполнения данных телеметрии из облачных и локальных сред.
Рабочие книги предоставляют гибкий холст для анализа данных и создания насыщенных визуальных отчетов на портале Azure. Они позволяют использовать несколько источников данных из разных Azure и объединять их в унифицированные интерактивные интерфейсы. Рабочие книги позволяют объединять различные виды визуализаций и анализов, что делает их отличными для свободного исследования. Дополнительные сведения см. в документации рабочих книг Azure Monitor.
Замечание
Параметры средств: Средства сервера MCP Azure определяют параметры данных, необходимых для выполнения задач. Некоторые из этих параметров относятся к каждому инструменту и описаны ниже. Другие параметры являются глобальными и общими для всех инструментов. Дополнительные сведения см. в разделе "Параметры средства".
Журнал действий: получение журналов действий
Выводит список журналов действий Azure Monitor для указанного ресурса Azure за определенное количество прошлых часов. Это средство помогает понять журнал развертывания ресурсов, изменения конфигурации и шаблоны доступа. Он возвращает события журнала действий, включающие метку времени, имя операции, состояние и сведения о вызывающем объекте. Используйте результаты для исследования неудачных развертываний, непредвиденных изменений или проблем с доступом.
Примеры запросов:
- Список журналов действий за последние 720 часов для ресурса webapp-prod.
| Параметр | Обязательно или необязательно | Description |
|---|---|---|
| Имя ресурса | Обязательно | Имя ресурса Azure для получения журналов действий. |
| Уровень событий | Необязательно | Уровень извлекаемых журналов действий. Допустимые уровни: Critical, Error, Informational, Verbose. Warning Если это не указано, возвращает все уровни. |
| Hours | Необязательно | Количество часов до текущего момента, за которые необходимо получить журналы действий. |
| Тип ресурса | Необязательно | Тип ресурса Azure (например, 'Microsoft.Storage/storageAccounts'). Укажите это только в случае необходимости, чтобы разграничить между несколькими ресурсами с одинаковыми названиями. |
| Верх | Необязательно | Максимальное количество извлекаемых журналов действий. |
Подсказки по аннотированию инструмента:
Разрушительный: ❌ | Идемпотент: ✅ | Открытый мир: ❌ | Только для чтения: ✅ | Секрет: ❌ | Требуется локальный: ❌
Веб-тесты: создание или обновление веб-теста
Часть инструментов протокола контекста модели (MCP), этот инструмент создает или обновляет стандартный веб-тест в Azure Monitor для проверки доступности конечных точек. Вы указываете параметры мониторинга, такие как URL-адрес, частота, расположения и ожидаемые ответы. Если тест не существует, это средство создает его; в противном случае он обновляет существующий тест с новыми параметрами.
Примеры запросов:
- Создайте новый стандартный веб-тест с ресурсом "webtest-prod-availability" в группе ресурсов "rg-prod-monitoring" и свяжите его с компонентом AppInsights "/subscriptions/12345678-1234-1234-1234-123456789abc/resourceGroups/rg-ai/providers/microsoft.insights/components/appinsights-prod".
- Обновите существующий стандартный веб-тест для ресурса "webtest-prod-availability" в группе ресурсов "rg-prod-monitoring", чтобы подключить его к компоненту AppInsights "/subscriptions/12345678-1234-1234-1234-123456789abc/resourceGroups/rg-ai/providers/microsoft.insights/components/appinsights-prod".
| Параметр | Обязательно или необязательно | Description |
|---|---|---|
| Группа ресурсов | Обязательно | Имя группы ресурсов Azure. |
| Ресурс Webtest | Обязательно | Имя ресурса для выполнения веб-теста. |
| Компонент Appinsights | Необязательно | Идентификатор ресурса компонента Application Insights, который необходимо связать с веб-тестом. |
| Описание | Необязательно | Краткое описание веб-теста. |
| Enabled | Необязательно | Включена ли веб-проверка. |
| Ожидаемый код состояния | Необязательно | Ожидаемый код состояния HTTP. |
| Следуйте перенаправлениям | Необязательно | Следовать ли HTTP перенаправлениям. |
| Периодичность | Необязательно | Частота тестирования в секундах. Поддерживаемые значения: 300, 600, 900. |
| Headers | Необязательно | Заголовки HTTP, которые необходимо включить в запрос, как пары KEY=VALUE, разделённые запятыми. |
| HTTP-команда | Необязательно | Метод HTTP, используемый, например get или post. |
| Игнорировать код состояния | Необязательно | Следует ли игнорировать проверку кода состояния. |
| Местоположение | Необязательно | Расположение, в котором создается ресурс веб-теста. Это должно соответствовать расположению компонента Application Insights. |
| Анализ запросов | Необязательно | Следует ли анализировать зависимые запросы. |
| Текст запроса | Необязательно | Содержимое для отправки с запросом. |
| URL-адрес запроса | Необязательно | Абсолютный URL-адрес для тестирования. |
| Повторная попытка включена | Необязательно | Включена ли повторная попытка. |
| Проверка SSL | Необязательно | Нужно ли проверять SSL-сертификаты. |
| Проверка времени существования SSL | Необязательно | Количество дней для проверки времени существования SSL-сертификата. |
| Тайм-аут | Необязательно | Время ожидания запроса в секундах. Поддерживаемые значения: 30, 60, 90, 120. |
| Имя веб-теста | Необязательно | Имя теста в ресурсе веб-теста. |
| Расположения веб-теста | Необязательно | Разделенный запятыми список расположений для запуска теста. Расположение относится к тегу геолокации для тестов доступности. |
Подсказки по аннотированию инструмента:
Разрушительный: ✅ | Идемпотент: ✅ | Открытый мир: ❌ | Только для чтения: ❌ | Секрет: ❌ | Требуется локальный: ❌
Веб-тесты: получение веб-теста
Это средство получает сведения о конкретном веб-тесте или перечисляет все веб-тесты. При указании ресурса Webtest этот инструмент возвращает подробные сведения для этого веб-теста. Если ресурс Webtest не указан, этот инструмент возвращает список всех веб-тестов в подписке, а список можно отфильтровать по группе ресурсов.
Примеры запросов:
- Получить сведения о веб-тесте ресурса 'webtest-prod' в моей подписке, в группе ресурсов 'rg-monitoring'.
- "Перечислить все ресурсы веб-теста в моей подписке".
- Перечислите все ресурсы веб-тестов в моей подписке в группе ресурсов "rg-prod".
| Параметр | Обязательно или необязательно | Description |
|---|---|---|
| Ресурс Webtest | Необязательно | Имя ресурса для выполнения веб-теста. |
Подсказки по аннотированию инструмента:
Разрушительный: ❌ | Идемпотент: ✅ | Открытый мир: ❌ | Только для чтения: ✅ | Секрет: ❌ | Требуется локальный: ❌
Log Analytics: Список рабочих областей
Этот инструмент отображает рабочие пространства Log Analytics в подписке. Он извлекает имя, идентификатор, расположение и другие ключевые свойства каждой рабочей области. Ее можно использовать для идентификации рабочих областей перед запросом к журналам или проверке параметров рабочей области.
Примеры запросов:
- Список рабочих областей Log Analytics в моей подписке.
- "Отображение рабочих областей Log Analytics".
- Получите рабочие пространства Log Analytics в моей подписке.
Подсказки по аннотированию инструмента:
Разрушительный: ❌ | Идемпотент: ✅ | Открытый мир: ❌ | Только для чтения: ✅ | Секрет: ❌ | Требуется локальный: ❌
Log Analytics: список таблиц
Это средство содержит список всех таблиц в рабочей области Log Analytics. Например, перечислите таблицы в рабочей области "prod-law" в группе ресурсов "rg-monitoring", чтобы предварительно просмотреть доступные столбцы и типы данных. Он возвращает имена таблиц и схемы, используемые для создания запросов языка запросов Kusto (KQL). Вы можете фильтровать по типу таблицы, например, CustomLog или AzureMetrics.
Примеры запросов:
- Список всех таблиц в рабочей области Log Analytics "prod-law" типа таблицы CustomLog в группе ресурсов "rg-prod".
- Показать таблицы типа 'AzureMetrics' для рабочей области 'f1b2c3d4-5678-90ab-cdef-1234567890ab' в группе ресурсов 'rg-monitoring'.
| Параметр | Обязательно или необязательно | Description |
|---|---|---|
| Имя рабочей области | Необязательно | Идентификатор или имя рабочей области Log Analytics. Это может быть уникальный идентификатор (GUID) или отображаемое имя рабочей области. |
Подсказки по аннотированию инструмента:
Разрушительный: ❌ | Идемпотент: ✅ | Открытый мир: ❌ | Только для чтения: ✅ | Секрет: ❌ | Требуется локальный: ❌
Log Analytics: Получение типов таблиц
В этом средстве протокола контекста модели (MCP) перечислены доступные типы таблиц в рабочей области Azure Log Analytics. Он возвращает имена типов таблиц. Эти имена можно использовать при написании запросов к журналам Azure Monitor.
Примеры запросов:
- Перечислить все доступные типы таблиц в рабочей области Log Analytics с именем 'prod-law-01' в группе ресурсов 'rg-prod'.
- Какие типы таблиц доступны в рабочей области Log Analytics с именем "analytics-workspace" в группе ресурсов "rg-logs"?
| Параметр | Обязательно или необязательно | Description |
|---|---|---|
| Группа ресурсов | Обязательно | Имя группы ресурсов Azure, содержащей рабочую область. |
| Имя рабочей области | Обязательно | Имя или идентификатор рабочей области Log Analytics. Вы можете использовать GUID рабочей области или отображаемое имя. |
Подсказки по аннотированию инструмента:
Разрушительный: ❌ | Идемпотент: ✅ | Открытый мир: ❌ | Только для чтения: ✅ | Секрет: ❌ | Требуется локальный: ❌
Log Analytics. Запрос журналов рабочей области
Запросите журналы во всей области рабочей среды Log Analytics, используя язык запросов Kusto (KQL). Это средство выполняет запросы на уровне рабочей области, возвращающие журналы во всех ресурсах и таблицах в рабочей области. Это средство является частью средств протокола контекста модели (MCP). Например, можно попросить: "Показать все ошибки в моей рабочей области", "что произошло в моей рабочей области за последние 24 часа", "список неудачных запросов в рабочей области".
Примеры запросов:
- Отображение журналов с запросом "errors" из таблицы Syslog в рабочей области Log Analytics "my-workspace" в группе ресурсов "rg-prod".
| Параметр | Обязательно или необязательно | Description |
|---|---|---|
| Запрос | Обязательно | Запрос на языке запросов Kusto (KQL) для выполнения в рабочей области Log Analytics. Вы можете использовать предопределенные запросы по имени: recent отображает самые последние журналы, упорядоченные по TimeGenerated; errors отображает журналы уровня ошибок, упорядоченные timeGenerated. Или укажите пользовательский запрос KQL. |
| Группа ресурсов | Обязательно | Имя группы ресурсов Azure, содержащей рабочую область. |
| Имя таблицы | Обязательно | Имя таблицы, запрашиваемой в рабочей области. |
| Имя рабочей области | Обязательно | Идентификатор или имя рабочей области Log Analytics. Вы можете указать глобальный уникальный идентификатор (GUID) или отображаемое имя рабочей области. |
| Hours | Необязательно | Количество часов, назад от которых будет выполнен запрос с настоящего момента. |
| Ограничение | Необязательно | Максимальное количество отображаемых результатов. |
Подсказки по аннотированию инструмента:
Разрушительный: ❌ | Идемпотент: ✅ | Открытый мир: ❌ | Только для чтения: ✅ | Секрет: ❌ | Требуется локальный: ❌
Log Analytics. Запрос журналов ресурсов
Запрос журналов диагностики и действий для определенного ресурса Azure в рабочей области Log Analytics с помощью языка запросов Kusto (KQL). Это средство фильтрует результаты по указанному ресурсу и выполняет предоставленный запрос KQL к выбранной таблице. Например, попросите: "Показать журналы для ресурса 'app-monitor' за последние 24 часа."
Примеры запросов:
- Показать журналы с запросом "последние" для идентификатора ресурса "/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/rg-prod/providers/Microsoft.Compute/virtualMachines/my-vm" в таблице "AzureDiagnostics".
| Параметр | Обязательно или необязательно | Description |
|---|---|---|
| Запрос | Обязательно | Запрос KQL для выполнения в рабочей области Log Analytics. Вы можете использовать заранее определённые запросы по имени: recent показывает самые последние логи, упорядоченные по TimeGenerated; errors показывает логи уровня ошибок, упорядоченные по TimeGenerated. В противном случае укажите пользовательский запрос KQL. |
| Идентификатор ресурса | Обязательно | Идентификатор Azure ресурса для запроса. Пример: /subscriptions/<sub>/resourceGroups/<rg>/providers/Microsoft.OperationalInsights/workspaces/<ws>. |
| Имя таблицы | Обязательно | Имя таблицы, запрашиваемой в рабочей области. |
| Hours | Необязательно | Количество часов, назад от которых будет выполнен запрос с настоящего момента. |
| Ограничение | Необязательно | Максимальное количество отображаемых результатов. |
Подсказки по аннотированию инструмента:
Разрушительный: ❌ | Идемпотент: ✅ | Открытый мир: ❌ | Только для чтения: ✅ | Секрет: ❌ | Требуется локальный: ❌
Состояние: получить состояние сущностей
Это средство извлекает состояние работоспособности и последние события работоспособности для определенной сущности в модели работоспособности Azure Monitor. Средство "Протокол контекста модели" (MCP) сообщает о работоспособности на уровне приложения на основе пользовательских моделей работоспособности, а не базовой доступности ресурсов. Для базовой доступности ресурсов используйте средство Azure Работоспособность ресурсов или azmcp_resourcehealth_availability-status_get. Чтобы запросить журналы в рабочей области Log Analytics, используйте azmcp_monitor_workspace_log_query. Чтобы запросить журналы для определенного ресурса Azure, используйте azmcp_monitor_resource_log_query.
Примеры запросов:
- Показать состояние работоспособности сущности "order-service" с помощью модели работоспособности "app-health-v1" в группе ресурсов "rg-prod".
| Параметр | Обязательно или необязательно | Description |
|---|---|---|
| Наименование сущности | Обязательно | Сущность для получения здоровья. |
| Модель состояния | Обязательно | Название модели состояния, для которой требуется получить работоспособность. |
| Группа ресурсов | Обязательно | Имя группы ресурсов Azure. Эта группа ресурсов является логическим контейнером для Azure ресурсов. |
Подсказки по аннотированию инструмента:
Разрушительный: ❌ | Идемпотент: ✅ | Открытый мир: ❌ | Только для чтения: ✅ | Секрет: ❌ | Требуется локальный: ❌
Метрики: метрики запросов
Запрос метрик в Azure Monitor для ресурса. Это средство возвращает данные временных рядов для указанных метрик, помогая анализировать производительность ресурсов и доступность. Это средство является частью средств протокола контекста модели (MCP).
Примеры запросов:
- "Анализ тенденций производительности и времени отклика для ресурса Application Insights "appinsights-prod" с помощью метрик "requests/duration" и пространства имен метрик "microsoft.insights/components".
- "Проверьте метрику доступности "availabilityResults/availabilityPercentage" для ресурса Application Insights "appinsights-staging" с помощью пространства имен метрик microsoft.insights/components?"
- Получение метрики "requests/duration" с агрегированием "Среднее" и интервалом "PT1M" для ресурса appinsights-prod с помощью пространства имен метрик "microsoft.insights/components".
- Исследуйте частоту ошибок и неудачные запросы для ресурса Application Insights "appinsights-prod", используя метрики "requests/failed,exceptions/count" и пространство имен метрик "microsoft.insights/components".
- Запрос метрики "requests/count" для типа ресурса "Microsoft.Insights/components", ресурса "appinsights-qa", с пространством имен метрик "microsoft.insights/components" и интервалом "PT5M".
- "Какова частота запросов в секунду с использованием метрики "requests/count" с агрегированием "Count" для ресурса Application Insights "appinsights-prod" и пространства имен метрик "microsoft.insights/components"?"
| Параметр | Обязательно или необязательно | Description |
|---|---|---|
| Имена метрик | Обязательно | Имена метрик для запроса, разделенные запятыми. |
| Пространство имен метрик | Обязательно | Пространство имён метрик для выполнения запроса. Получите это значение из средства azmcp-monitor-metrics-definitions. |
| Имя ресурса | Обязательно | Имя ресурса Azure для запроса метрик. |
| Агрегация | Необязательно | Тип агрегирования, используемый, например среднее, максимальное, минимальное, общее или число. |
| Время окончания | Необязательно | Время окончания запроса в формате ISO (например, 2023-01-01T00:00:00Z). По умолчанию сейчас. |
| Фильтр | Необязательно | Фильтр OData для применения к запросу метрик. |
| Interval | Необязательно | Интервал времени для точек данных (например, PT1H в течение 1 часа в PT5M течение 5 минут). |
| Максимальное количество контейнеров | Необязательно | Максимальное количество временных корзин для возвращения. Значение по умолчанию — 50. |
| Тип ресурса | Необязательно | Тип ресурса Azure (например, Microsoft.Storage/storageAccounts, Microsoft.Compute/virtualMachines). Если это не указано, средство пытается определить тип из имени ресурса. |
| Время начала | Необязательно | Время начала запроса в формате ISO (например, 2023-01-01T00:00:00Z). Значение по умолчанию — 24 часа назад. |
Подсказки по аннотированию инструмента:
Разрушительный: ❌ | Идемпотент: ✅ | Открытый мир: ❌ | Только для чтения: ✅ | Секрет: ❌ | Требуется локальный: ❌
Метрики: список определений метрик
В этом средстве перечислены определения метрик для ресурса Azure. Он возвращает метаданные для каждой метрики, включая пространства имен, описания и типы агрегирования, чтобы определить, какие метрики следует запрашивать для ресурса.
Примеры запросов:
- Получите определения метрик для имени ресурса «app-insights-prod».
- Вывести определения метрик для ресурса с именем "mystorageacct" и типом "Microsoft.Storage/storageAccounts" в пространстве имен метрик "Storage".
- Показать определения метрик для имени ресурса 'vm-prod-01' с поисковой строкой 'CPU' и ограничением '20'.
| Параметр | Обязательно или необязательно | Description |
|---|---|---|
| Имя ресурса | Обязательно | Имя ресурса Azure для запроса метрик. |
| Ограничение | Необязательно | Максимальное количество возвращаемых определений метрик. По умолчанию 10. |
| Пространство имен метрик | Необязательно | Пространство имён метрик для выполнения запроса. Получите это значение из средства azmcp-monitor-metrics-definitions. |
| Тип ресурса | Необязательно | Тип ресурса Azure (например, Microsoft.Storage/storageAccounts, Microsoft.Compute/virtualMachines). Если он не указан, средство пытается определить тип ресурса из имени ресурса. |
| Строка поиска | Необязательно | Строка для фильтрации определений метрик. Фильтр выполняет сопоставление без учета регистра по именам и описаниям метрик. |
Подсказки по аннотированию инструмента:
Разрушительный: ❌ | Идемпотент: ✅ | Открытый мир: ❌ | Только для чтения: ✅ | Секрет: ❌ | Требуется локальный: ❌
Инструментирование: получить учебный ресурс
Это средство выводит список всех доступных учебных ресурсов для инструментирования Azure Monitor или получает содержимое определенного ресурса по указанному пути. По умолчанию средство возвращает все пути к ресурсам. Если указать путь, средство возвращает полное содержимое ресурса. Чтобы инструментировать приложение, используйте средство orchestrator-start.
Примеры запросов:
- Получите учебный ресурс по интеграции по адресу "onboarding/get-started.md".
- Покажите мне содержимое ресурса для обучения Azure Monitor по пути "onboarding/quickstart.md".
- Извлеките содержимое учебного файла ресурса Azure Monitor по пути "samples/instrumentation-guide.html".
- Список всех учебных ресурсов для введения в Azure Monitor.
- "Показать мне все пути ресурсов обучения для Azure Monitor инструментирования".
- Какие ресурсы обучения доступны для введения инструментирования в Azure Monitor?
| Параметр | Обязательно или необязательно | Description |
|---|---|---|
| Путь | Необязательно | Маршрут к учебному ресурсу. |
Подсказки по аннотированию инструмента:
Разрушительный: ❌ | Идемпотент: ✅ | Открытый мир: ❌ | Только для чтения: ✅ | Секрет: ❌ | Требуется локальный: ✅
Инструментирование: запуск оркестрации
Начните здесь с инструментов протокола MCP, использующих Azure Monitor. Это средство анализирует рабочую область и возвращает первое действие для выполнения. После выполнения действия вызовите orchestrator-next, чтобы продолжить. Следуйте в точности действию в поле instruction.
Примеры запросов:
- Начните оркестрацию инструментирования в Azure Monitor для рабочего пути "/home/dev/workspace-monitoring".
- Анализируйте путь рабочей области "/src/projects/my-app-workspace" и верните первый шаг инструментирования Azure Monitor.
- Начните внедрение Azure Monitor для проекта по пути к рабочей области "/workspace/my-app" и дайте мне первый шаг.
| Параметр | Обязательно или необязательно | Description |
|---|---|---|
| Путь к рабочей области | Обязательно | Абсолютный путь к папке рабочей области. |
Подсказки по аннотированию инструмента:
Разрушительный: ❌ | Идемпотент: ❌ | Открытый мир: ❌ | Только для чтения: ❌ | Секрет: ❌ | Требуется локальный: ✅
Инструментирование: продолжение оркестрации
Перейдите к следующей операции инструментирования после завершения текущей операции.
Это инструмент является частью комплекта протоколов контекста модели (Model Context Protocol, MCP).
После выполнения точного instruction из предыдущего ответа запустите этот инструмент, чтобы получить следующее действие.
Ожидаемый рабочий процесс:
- Вы получаете действие от orchestrator-start или orchestrator-next.
- Вы выполняете поле
instructionточно. - Чтобы получить следующее действие, запустите этот инструмент с кратким
Completion note.
Возвращает: следующее действие для выполнения или complete статус, когда все шаги выполнены.
Примеры запросов:
- После завершения предыдущего шага инструментирования Azure Monitor получите следующее действие для идентификатора сеанса 'session-abc123' с примечанием о завершении «Добавлен UseAzureMonitor() в Program.cs».
- "Получите следующее действие подключения для идентификатора сеанса "workspace/session-2026" с примечанием о завершении "Ran dotnet add package Microsoft. ApplicationInsights'".
- "После завершения предыдущего шага инструментирования верните следующий шаг для идентификатора сеанса "session-789xyz" с примечанием о завершении "Обновлено appsettings.json, чтобы включить Application Insights".
| Параметр | Обязательно или необязательно | Description |
|---|---|---|
| Примечание о завершении | Обязательно | Одно предложение, описывающее выполняемое действие, например: "Выполнена команда dotnet add package" или "Добавлено UseAzureMonitor() в Program.cs". |
| Идентификатор сеанса | Обязательно | Путь к рабочей области, возвращённый в виде sessionId из orchestrator-start. |
Подсказки по аннотированию инструмента:
Разрушительный: ❌ | Идемпотент: ❌ | Открытый мир: ❌ | Только для чтения: ❌ | Секрет: ❌ | Требуется локальный: ✅
Инструментарий: Отправка браунфилд-анализа
Отправляет результаты анализа кода браунфилда после orchestrator-start возврата состояния analysis_needed. Это средство входит в рабочий процесс протокола контекста модели (MCP). Перед вызовом этого средства необходимо проверить исходные файлы рабочей области и заполнить шаблон анализа. После успешного выполнения этого средства, продолжайте с orchestrator-next.
Примеры запросов:
- Отправить результаты анализа кода brownfield в формате JSON '{"serviceOptions":null,"initializers":null,"processors":null,"clientUsage":null,"sampling":{"found":false,"hasCustomSampling":false},"telemetryPipeline":null,"logging":null}' в сеанс инструментирования Azure Monitor "workspace-7a3b" после того как был сделан запрос на анализ.
- "Продолжить оркестрацию миграции, отправив результаты JSON "{"serviceOptions":{"found":true,"details":"AddApplicationInsightsTelemetry used"},"initializers":[],"процессоры":[],"clientUsage":null,"выборка":{"found":false", hasCustomSampling":false},"telemetryPipeline":null,"logging":null}" для сеанса "sess-01234".
- "Отправка завершенного анализа телеметрии браунфилда в виде выводов JSON "{"serviceOptions":null,"initializers":null,"процессоры":null,"clientUsage":{"found":true}"выборка":{"выборка":{"found":false,"hasCustomSampling":false},"telemetryPipeline":null,"logging":{"found":true}}" для подключения сеанса "session-9f3b".
| Параметр | Обязательно или необязательно | Description |
|---|---|---|
| Результаты JSON | Обязательно | Объект JSON с результатами анализа браунфилда. Обязательные свойства: serviceOptions (результаты анализа вызова AddApplicationInsightsTelemetry(), null если не найдено), инициализаторы (результаты инициализатора телеметрии из анализа реализаций ITelemetryInitializer или IConfigureOptions<TelemetryConfiguration>, null, если не найдено), процессоры (результаты обработчика телеметрии из анализа реализаций ITelemetryProcessor, null, если не найдено), clientUsage (результаты использования TelemetryClient из анализа использования TelemetryClient, null, если не найдено), выборка (результаты пользовательской конфигурации выборки, null, если не настраиваемая выборка), telemetryPipeline (результаты использования пользовательских ITelemetryChannel или TelemetrySinks, null, если не найдено), logging (явный поставщик ведения журнала и результаты фильтрации, null, если не найдено). Для разделов, которые не существуют в базе кода, передайте пустой объект по умолчанию, например найденный: false или hasCustomSampling: falseвместо null. |
| Идентификатор сеанса | Обязательно | Путь к рабочей области, возвращенный как sessionId из orchestrator-start. |
Подсказки по аннотированию инструмента:
Разрушительный: ❌ | Идемпотент: ❌ | Открытый мир: ❌ | Только для чтения: ❌ | Секрет: ❌ | Требуется локальный: ✅
Инструменты: Отправка выбранных улучшений
Отправьте выбранное пользователем улучшение после возвращения статуса orchestrator-startenhancement_available. Введите варианты улучшения пользователю, а затем вызовите это средство с выбранными ключами улучшения. Вы можете выбрать несколько улучшений, передав список, разделенный запятыми, например redis,processors. После успешного выполнения этого средства, продолжайте с orchestrator-next.
Примеры запросов:
- Отправьте ключи улучшения 'redis, processors' для сеанса инструментирования Azure Monitor с идентификатором 'workspaces/my-app/session-abc123'.
- Продолжайте усовершенствование инструментирования, отправляя ключи расширения "redis" на идентификатор сеанса "workspaces/prod-app/session-789".
- Отправить выбранные ключи улучшения 'entityframework,otlp' для идентификатора сеанса подключения 'workspaces/onboard/session-456'.
| Параметр | Обязательно или необязательно | Description |
|---|---|---|
| Ключи улучшения | Обязательно | Один или несколько ключей улучшения, разделенные запятыми (например, redis, , redis,processorsentityframework,otlp). |
| Идентификатор сеанса | Обязательно | Путь к рабочей области, возвращенный как sessionId из orchestrator-start. |
Подсказки по аннотированию инструмента:
Разрушительный: ❌ | Идемпотент: ❌ | Открытый мир: ❌ | Только для чтения: ❌ | Секрет: ❌ | Требуется локальный: ✅
Рабочие книги: Список рабочих книг
Поиск рабочих книг Azure с использованием Resource Graph для быстрых запросов метаданных. Это средство помогает обнаруживать, фильтровать и подсчитывать книги в разных областях.
Он возвращает метаданные книги, включая id, name, location и category, а также метки времени. По умолчанию он не возвращает полное содержимое книги (serializedData) — используйте для этого средство отображения или задайте Output format равным full.
По умолчанию поисковый запрос ориентирован на рабочие книги в текущем контексте Azure (клиент или подписка). Можно использовать Resource group для явного указания области поиска. По умолчанию инструмент возвращает общее количество на стороне сервера. Максимальное количество возвращаемых результатов — 50, при максимальном верхнем пределе в 1000; измените это с помощью Max results. Выберите Output format как summary для минимальных токенов или full для полного serializedData вывода.
Примеры запросов:
- Покажите мне все рабочие книги в группе ресурсов «monitoring-rg».
- Перечислить общие рабочие книги в группе ресурсов "prod-rg".
- Какие рабочие книги были изменены после 2024-01-15 в группе ресурсов «analytics-rg»?
| Параметр | Обязательно или необязательно | Description |
|---|---|---|
| Группа ресурсов | Необязательно | Имя группы ресурсов Azure для области поиска. |
| Категория | Необязательно | Фильтруйте рабочие книги по категориям (например, workbook, sentinel, TSG). Если это не указано, возвращаются все категории. |
| Включить общее число | Необязательно | Включать общее количество всех соответствующих рабочих книг в ответе (по умолчанию: true). |
| Kind | Необязательно | Фильтрация рабочих книг по типу (например, shared, user). Если не указано, возвращаются все типы. |
| Максимальное количество результатов | Необязательно | Максимальное количество возвращаемых результатов (по умолчанию: 50, максимум: 1000). |
| Изменено после | Необязательно | Фильтровать книги, измененные после этой даты (в формате ISO 8601, например, 2024-01-15). |
| Имя содержит | Необязательно | Отфильтруйте рабочие книги, в которых отображаемое имя содержит этот текст (без учета регистра). |
| Формат выходных данных | Необязательно | Формат выходных данных: summary (только идентификатор и имя, минимальные маркеры), standard (метаданные без содержимого, по умолчанию) full (включается serializedData). |
| Исходный идентификатор | Необязательно | Фильтрация рабочих книг по идентификатору исходного ресурса (например, /subscriptions/abc123/resourceGroups/prod/providers/Microsoft.Insights/components/myapp). Если не указано, возвращаются все рабочие тетради. |
Подсказки по аннотированию инструмента:
Разрушительный: ❌ | Идемпотент: ✅ | Открытый мир: ❌ | Только для чтения: ✅ | Секрет: ❌ | Требуется локальный: ❌
Рабочие книги: показать детали рабочей книги
Извлечение полной информации о рабочей книге с помощью API Azure Resource Manager (ARM), включая содержимое serializedData. Эта команда позволяет получить определение всей рабочей книги, включая JSON визуализации.
Он возвращает полные свойства рабочей книги, serializedData, теги и ETag. Вы можете предоставить несколько Workbook IDs для пакетных операций. Команда отчитывается о частичных сбоях для отдельных книг Excel. Для повышения производительности сначала используйте средство списка для обнаружения книг, а затем используйте отображение для определенных книг.
Примеры запросов:
- "Показать мне сведения о книге с идентификатором ресурса "/subscriptions/abc123/resourceGroups/monitoring/providers/Microsoft. Insights/workbooks/a0a0a0a0-bbbb-cccc-ddd-e1e1e1e1e1e1e1'".
- Получить полное определение книги "/subscriptions/xyz789/resourceGroups/prod-rg/providers/Microsoft.Insights/workbooks/b1b1b1b1-cccc-dddd-eeee-f2f2f2f2f2f2".
| Параметр | Обязательно или необязательно | Description |
|---|---|---|
| Идентификаторы рабочей книги | Обязательно | Идентификаторы ресурсов Azure для извлечения рабочих тетрадей. Поддерживает несколько значений для пакетных операций. |
Подсказки по аннотированию инструмента:
Разрушительный: ❌ | Идемпотент: ✅ | Открытый мир: ❌ | Только для чтения: ✅ | Секрет: ❌ | Требуется локальный: ❌
Рабочие книги: создание рабочей книги
Создайте новую книгу в указанной группе ресурсов и подписке. Вы можете задать отображаемое имя и сериализованный контент JSON для книги. Эта команда возвращает сведения о созданной книге после успешного завершения.
Примеры запросов:
- Создайте новую книгу под названием "Панель мониторинга производительности" в группе ресурсов "monitoring-rg" с сериализованным содержимым для базового ноутбука.
- Создайте книгу под названием "Обзор инфраструктуры" в группе ресурсов "prod-rg" с содержимым, показывающим метрики виртуальных машин.
| Параметр | Обязательно или необязательно | Description |
|---|---|---|
| Отображаемое имя | Обязательно | Отображаемое имя рабочей книги. |
| Группа ресурсов | Обязательно | Имя группы ресурсов Azure, содержащей книгу. |
| Сериализованное содержимое | Обязательно | Сериализованное содержимое JSON рабочей тетради. |
| Исходный идентификатор | Необязательно | Идентификатор связанного ресурса для рабочей тетради. По умолчанию это azure monitor. |
Подсказки по аннотированию инструмента:
Разрушительный: ✅ | Идемпотент: ❌ | Открытый мир: ❌ | Только для чтения: ❌ | Секрет: ❌ | Требуется локальный: ❌
Рабочие книги: обновить рабочую книгу
Обновите свойства существующей рабочей книги Azure, добавив новые шаги, изменив содержимое или сменив отображаемое имя. Это действие возвращает обновленные сведения о рабочей книге. Вам нужен идентификатор ресурса книги, и вы можете указать либо новое сериализованное содержимое, либо новое отображаемое имя.
Примеры запросов:
- Обновите рабочую книгу '/subscriptions/abc123/resourceGroups/monitoring-rg/providers/Microsoft.Insights/workbooks/a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1' с отображаемым именем "Ежемесячный отчет".
- Измените сериализованное содержимое рабочей книги "/subscriptions/xyz789/resourceGroups/prod-rg/providers/Microsoft.Insights/workbooks/b1b1b1b1-cccc-dddd-eeee-f2f2f2f2f2f2", чтобы включить новую диаграмму метрик.
| Параметр | Обязательно или необязательно | Description |
|---|---|---|
| Идентификатор рабочей книги | Обязательно | Идентификатор ресурса Azure рабочей книги для обновления. |
| Отображаемое имя | Необязательно | Отображаемое имя рабочей книги. |
| Сериализованное содержимое | Необязательно | Сериализованное содержимое рабочей книги JSON. |
Подсказки по аннотированию инструмента:
Разрушительный: ✅ | Идемпотент: ✅ | Открытый мир: ❌ | Только для чтения: ❌ | Секрет: ❌ | Требуется локальный: ❌
Рабочие книги: Удалить рабочие книги
Удалите одну или несколько рабочих книг по их идентификаторам ресурсов в Azure. Эта команда выполняет мягкое удаление рабочих книг, сохраняя их в течение 90 дней. При необходимости их можно восстановить из корзины на портале Azure.
Для пакетных операций можно указать несколько Workbook IDs значений. Команда сообщает о частичных сбоях для каждой рабочей книги, что гарантирует, что отдельные сбои не влияют на всю пакетную операцию.
Дополнительные сведения см. в статье Управление рабочими книгами в Azure Monitor.
Примеры запросов:
- Удалите книгу с идентификатором ресурса "/subscriptions/abc123/resourceGroups/monitoring/providers/Microsoft.Insights/workbooks/a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1".
- Удалите книги с идентификаторами ресурсов "/subscriptions/xyz789/resourceGroups/prod-rg/providers/Microsoft.Insights/workbooks/b1b1b1b1-cccc-dddd-eeee-f2f2f2f2f2f2" и "/subscriptions/def456/resourceGroups/analytics-rg/providers/Microsoft.Insights/workbooks/c2c2c2c2-dddd-eeee-ffff-a3a3a3a3a3a3".
| Параметр | Обязательно или необязательно | Description |
|---|---|---|
| Идентификаторы рабочей книги | Обязательно | Идентификаторы ресурсов Azure рабочих книг для удаления. Поддерживает несколько значений для пакетных операций. |
Подсказки по аннотированию инструмента:
Разрушительный: ✅ | Идемпотент: ✅ | Открытый мир: ❌ | Только для чтения: ❌ | Секрет: ❌ | Требуется локальный: ❌