Ferramentas do MCP Server Azure para Azure Monitor e Workbooks

O Servidor MCP (Model Context Protocol) do Azure permite gerenciar recursos do Azure Monitor e Workbooks com prompts de linguagem natural. Você pode consultar espaços de trabalho do Log Analytics, analisar dados operacionais, monitorar a integridade dos recursos, obter métricas de desempenho, gerenciar testes da Web de disponibilidade, orquestrar fluxos de trabalho de instrumentação e gerenciar pastas de trabalho do Azure Monitor.

Azure Monitor ajuda a maximizar a disponibilidade e o desempenho de seus aplicativos e serviços. Ele fornece uma solução abrangente para coletar, analisar e agir sobre telemetria de seus ambientes locais e de nuvem.

As pastas de trabalho fornecem uma tela flexível para análise de dados e a criação de relatórios visuais avançados no portal Azure. Eles permitem que você toque em várias fontes de dados de toda Azure e combine-as em experiências interativas unificadas. As pastas de trabalho permitem combinar vários tipos de visualizações e análises, tornando-as excelentes para a exploração de formas livres. Para obter mais informações, consulte documentação de pastas de trabalho do Azure Monitor.

Observação

parâmetros Tool: as ferramentas do servidor MCP Azure definem parâmetros para os dados necessários para concluir tarefas. Alguns desses parâmetros são específicos para cada ferramenta e estão documentados aqui. Outros parâmetros são globais e compartilhados por todas as ferramentas. Para obter mais informações, consulte parâmetros de ferramenta.

Registro de Atividades: Obter registros de atividades

Lista os logs de atividades do Azure Monitor para um recurso do Azure especificado nas últimas determinadas horas. Essa ferramenta ajuda você a entender o histórico de implantação de recursos, as alterações de configuração e os padrões de acesso. Ele retorna eventos de log de atividades que incluem data e hora, nome da operação, status e informações do chamador. Use os resultados para investigar implantações com falha, alterações inesperadas ou problemas de acesso.

Os prompts de exemplo incluem:

  • "Liste os logs de atividades para as últimas '720' horas para o recurso 'webapp-prod'."
Parâmetro Obrigatório ou opcional Description
Nome do recurso Obrigatório O nome do recurso Azure para o qual recuperar logs de atividades.
Nível de evento Opcional O nível de logs de atividade a serem recuperados. Os níveis válidos são: Critical, , Error, Informational, Verbose, Warning. Se não for fornecido, retornará todos os níveis.
Hours Opcional O número de horas antes de agora para recuperar logs de atividades.
Tipo de recurso Opcional O tipo do recurso Azure (por exemplo, 'Microsoft.Storage/storageAccounts'). Forneça isso somente se necessário para desambiguar entre vários recursos com o mesmo nome.
Top Opcional O número máximo de logs de atividade a serem recuperados.

Dicas de anotação da ferramenta:

Destrutivo Idempotent Mundo Aberto Somente leitura Secret Local Obrigatório
❌ ✅ ❌ ✅ ❌ ❌

Testes na Web: criar ou atualizar o teste da Web

Parte das ferramentas do Protocolo de Contexto de Modelo (MCP), esta ferramenta cria ou atualiza um teste web padrão no Azure Monitor para verificar a disponibilidade do endpoint. Especifique as configurações de monitoramento, como a URL, a frequência, os locais e as respostas esperadas. Se o teste não existir, essa ferramenta o criará; caso contrário, ele atualiza o teste existente com as novas configurações.

Os prompts de exemplo incluem:

  • "Crie um novo Teste Web Standard com o recurso webtest 'webtest-prod-availability' no grupo de recursos 'rg-prod-monitoring' e associe-o ao componente AppInsights '/subscriptions/12345678-1234-1234-1234-123456789abc/resourceGroups/rg-ai/providers/microsoft.insights/components/appinsights-prod'."
  • "Atualize um Teste Web Standard existente para o recurso webtest 'webtest-prod-availability' no grupo de recursos 'rg-prod-monitoring' para vinculá-lo ao componente AppInsights '/subscriptions/12345678-1234-1234-1234-123456789abc/resourceGroups/rg-ai/providers/microsoft.insights/components/appinsights-prod'."
Parâmetro Obrigatório ou opcional Description
Grupo de recursos Obrigatório O nome do grupo de recursos Azure.
Recurso webtest Obrigatório O nome do recurso Teste Web no qual operar.
Componente Appinsights Opcional O ID do recurso do componente Application Insights a ser associado ao teste web.
Descrição Opcional Uma breve descrição do teste da Web.
Habilitado Opcional Se o teste da Web está habilitado.
Código de status esperado Opcional Código de status HTTP esperado.
Seguir redirecionamentos Opcional Se deseja seguir redirecionamentos HTTP.
Frequência Opcional Frequência de teste em segundos. Valores com suporte: 300, 600, 900.
Headers Opcional Cabeçalhos HTTP a serem incluídos na solicitação, como pares KEY=VALUE separados por vírgulas.
Verbo HTTP Opcional Método HTTP a ser usado, por exemplo, GET ou POST.
Ignorar código de status Opcional Se deve ignorar a validação do código de status.
Localidade Opcional O local onde o recurso de teste da Web é criado. Isso deve corresponder ao local do componente do Application Insights.
Analisar solicitações Opcional Se as solicitações dependentes devem ser analisadas.
Corpo da solicitação Opcional O corpo a ser enviado com a requisição.
URL da solicitação Opcional A URL absoluta a ser testada.
Repetição ativada Opcional Se as novas tentativas estão habilitadas.
Verificação de SSL Opcional Se os certificados SSL devem ser validados.
Verificação de tempo de vida do SSL Opcional Número de dias para verificar o tempo de vida do certificado SSL.
Tempo Limite Opcional Tempo limite da solicitação em segundos. Valores com suporte: 30, 60, 90, 120.
Nome do teste da Web Opcional O nome do teste dentro do recurso de teste da Web.
Locais de webtest Opcional Lista separada por vírgulas de locais de onde executar o teste. A localização refere-se à etiqueta de geolocalização populacional para testes de disponibilidade.
Webtest Opcional Configuração de teste da Web.

Dicas de anotação da ferramenta:

Destrutivo Idempotent Mundo Aberto Somente leitura Secret Local Obrigatório
✅ ✅ ❌ ❌ ❌ ❌

Testes da Web: obtenha o teste da Web

Essa ferramenta obtém detalhes de um teste da Web específico ou lista todos os testes da Web. Quando você especifica o recurso Webtest, essa ferramenta retorna informações detalhadas para esse teste na Web. Quando você não especifica o recurso webtest, essa ferramenta retorna uma lista de todos os testes da Web na assinatura e você pode filtrar a lista por grupo de recursos.

Os prompts de exemplo incluem:

  • "Obtenha detalhes do Teste Web para o recurso webtest 'webtest-prod' na minha assinatura, no grupo de recursos 'rg-monitoring'."
  • "Listar todos os recursos de teste da Web na minha assinatura."
  • Liste todos os recursos de Teste Web na minha assinatura no grupo de recursos 'rg-prod'.
Parâmetro Obrigatório ou opcional Description
Recurso webtest Opcional O nome do recurso Teste Web no qual operar.

Dicas de anotação da ferramenta:

Destrutivo Idempotent Mundo Aberto Somente leitura Secret Local Obrigatório
❌ ✅ ❌ ✅ ❌ ❌

Log Analytics: Listar espaços de trabalho

Essa ferramenta lista espaços de trabalho do Log Analytics em uma assinatura. Recupera o nome, a identificação, a localização e outras propriedades principais de cada workspace. Você pode usá-lo para identificar espaços de trabalho antes de consultar os seus logs ou examinar as configurações dos espaços de trabalho.

Os prompts de exemplo incluem:

  • "Liste os workspaces da análise de logs na minha assinatura."
  • "Exiba meus workspaces da análise de logs."
  • "Obtenha os Log Analytics workspaces na minha assinatura."

Dicas de anotação da ferramenta:

Destrutivo Idempotent Mundo Aberto Somente leitura Secret Local Obrigatório
❌ ✅ ❌ ✅ ❌ ❌

Log Analytics: Listar tabelas

Essa ferramenta lista todas as tabelas em um Log Analytics workspace. Por exemplo, liste tabelas no workspace 'prod-law' no grupo de recursos 'rg-monitoring' para visualizar colunas e tipos de dados disponíveis. Ele retorna nomes de tabela e esquemas que você usa para criar consultas KQL (Linguagem de Consulta Kusto). Você pode filtrar por tipo de tabela, por exemplo CustomLog ou AzureMetrics.

Os prompts de exemplo incluem:

  • "Liste todas as tabelas no workspace da análise de logs 'prod-law' do tipo de tabela 'CustomLog' no grupo de recursos 'rg-prod'."
  • Mostre-me tabelas do tipo 'AzureMetrics' para o workspace 'f1b2c3d4-5678-90ab-cdef-1234567890ab' do grupo de recursos 'rg-monitoring'.
Parâmetro Obrigatório ou opcional Description
Grupo de recursos Obrigatório O nome do grupo de recursos Azure.
Nome do espaço de trabalho Obrigatório O ID ou o nome do workspace do Log Analytics. Isso pode ser tanto o identificador exclusivo (GUID) quanto o nome de exibição do seu espaço de trabalho.
Tipo de tabela Obrigatório Tipo de tabela pela qual filtrar.

Dicas de anotação da ferramenta:

Destrutivo Idempotent Mundo Aberto Somente leitura Secret Local Obrigatório
❌ ✅ ❌ ✅ ❌ ❌

Log Analytics: Obter tipos de tabelas

Essa ferramenta MCP (Protocolo de Contexto de Modelo) lista os tipos de tabela disponíveis em um workspace Azure Log Analytics. Ele retorna os nomes dos tipos de tabela. Você pode usar esses nomes quando fizer consultas nos logs do Azure Monitor.

Os prompts de exemplo incluem:

  • Liste todos os tipos de tabela disponíveis no workspace do Log Analytics chamado 'prod-law-01', no grupo de recursos 'rg-prod'.
  • "Quais tipos de tabela estão disponíveis no workspace da análise de logs chamado 'analytics-workspace' no grupo de recursos 'rg-logs'?"
Parâmetro Obrigatório ou opcional Description
Grupo de recursos Obrigatório O nome do grupo de recursos Azure.
Nome do espaço de trabalho Obrigatório O nome ou a ID do workspace do Log Analytics. Você pode usar o GUID do workspace ou o nome de exibição.

Dicas de anotação da ferramenta:

Destrutivo Idempotent Mundo Aberto Somente leitura Secret Local Obrigatório
❌ ✅ ❌ ✅ ❌ ❌

Log Analytics: Consultar logs do espaço de trabalho

Consulte logs em um workspace inteiro da análise de logs usando Linguagem de Consulta Kusto. Essa ferramenta executa consultas em todo o workspace que retornam logs de todos os recursos e tabelas no workspace. Essa ferramenta faz parte das ferramentas do PROTOCOLO MCP (Model Context Protocol). Por exemplo, você pode perguntar: 'mostrar todos os erros no meu workspace', 'o que aconteceu no meu workspace nas últimas 24 horas', 'listar solicitações com falha no workspace'.

Os prompts de exemplo incluem:

  • "Mostre logs com a consulta 'errors' da tabela 'Syslog' no workspace da análise de logs 'my-workspace' no grupo de recursos 'rg-prod'."
Parâmetro Obrigatório ou opcional Description
Consulta Obrigatório A Linguagem de Consulta Kusto a ser executada no workspace da análise de logs. Você pode usar consultas predefinidas por nome: recent mostra os logs mais recentes, ordenados pelo TimeGenerated; errors mostra logs no nível de erro, ordenados pelo TimeGenerated. Ou forneça uma consulta KQL personalizada.
Grupo de recursos Obrigatório O nome do grupo de recursos Azure.
Nome da tabela Obrigatório O nome da tabela a ser consultada no espaço de trabalho.
Nome do espaço de trabalho Obrigatório O ID ou o nome do workspace do Log Analytics. Você pode fornecer o identificador global exclusivo (GUID) ou o nome de exibição da área de trabalho.
Hours Opcional O número de horas anteriores a consultar a partir de agora.
Limit Opcional O número máximo de resultados a serem retornados.

Dicas de anotação da ferramenta:

Destrutivo Idempotent Mundo Aberto Somente leitura Secret Local Obrigatório
❌ ✅ ❌ ✅ ❌ ❌

Análise de Logs: consultar os logs de recursos

Consulte logs de diagnóstico e atividade de um recurso específico do Azure em um workspace da análise de logs usando Linguagem de Consulta Kusto. Essa ferramenta filtra os resultados para o recurso especificado e executa a consulta KQL fornecida na tabela escolhida. Por exemplo, pergunte: "Mostre os logs do recurso 'app-monitor' nas últimas 24 horas."

Os prompts de exemplo incluem:

  • "Mostre logs com a consulta 'recent' para a ID do recurso '/subscriptions/a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1/resourceGroups/rg-prod/providers/Microsoft.Compute/virtualMachines/my-vm' na tabela 'AzureDiagnostics'."
Parâmetro Obrigatório ou opcional Description
Consulta Obrigatório A consulta KQL a ser executada no espaço de trabalho do Log Analytics. Você pode usar consultas predefinidas por nome: recent mostra os logs mais recentes ordenados pelo TimeGenerated; errors mostra logs no nível de erro ordenados pelo TimeGenerated. Caso contrário, forneça uma consulta KQL personalizada.
ID do recurso Obrigatório O ID do recurso Azure a ser consultado. Exemplo: /subscriptions/<sub>/resourceGroups/<rg>/providers/Microsoft.OperationalInsights/workspaces/<ws>.
Nome da tabela Obrigatório O nome da tabela a ser consultada no espaço de trabalho.
Hours Opcional O número de horas anteriores a consultar a partir de agora.
Limit Opcional O número máximo de resultados a serem retornados.

Dicas de anotação da ferramenta:

Destrutivo Idempotent Mundo Aberto Somente leitura Secret Local Obrigatório
❌ ✅ ❌ ✅ ❌ ❌

Modelos de saúde: listar modelos de saúde

Lista todos os modelos de integridade em um recurso de modelo de integridade do Azure Monitor. Essa ferramenta ajuda você a descobrir os modelos de integridade disponíveis para monitorar a integridade no nível do aplicativo. A ferramenta Model Context Protocol (MCP) relata a saúde em nível de aplicativo com base em modelos de saúde personalizados, não na disponibilidade básica de recursos. Para disponibilidade básica de recursos, use Azure Resource Health. Para consultar logs em um workspace da análise de logs, use azmcp_monitor_workspace_log_query. Para consultar logs de um recurso de Azure específico, use azmcp_monitor_resource_log_query.

Os prompts de exemplo incluem:

  • Liste todos os modelos de saúde no recurso de modelos de saúde 'app-health-monitor' no grupo de recursos 'rg-prod'.

Exemplo de comando da CLI

azmcp monitor healthmodels list \
  [--resource-group <resource-group>]

Dicas de anotação da ferramenta:

Destrutivo: ❌ | Idempotente: ✅ | Mundo aberto: ❌ | Somente leitura: ✅ | Segredo: ❌ | Local obrigatório: ❌

Modelos de saúde: Obter modelo de saúde

Recupera um modelo de integridade específico pelo nome de um recurso de modelo de integridade do Azure Monitor. Essa ferramenta retorna o status de saúde e os eventos de saúde recentes de um modelo de saúde específico. A ferramenta Model Context Protocol (MCP) relata a saúde em nível de aplicativo com base em modelos de saúde personalizados, não na disponibilidade básica de recursos. Para disponibilidade básica de recursos, use Azure Resource Health. Para consultar logs em um workspace da análise de logs, use azmcp_monitor_workspace_log_query. Para consultar logs de um recurso de Azure específico, use azmcp_monitor_resource_log_query.

Os prompts de exemplo incluem:

  • "Obtém o modelo de integridade 'order-service-health' do recurso de modelo de integridade 'app-health-monitor' no grupo de recursos 'rg-prod'."
Parâmetro Obrigatório ou opcional Description
Modelo de saúde Obrigatório O nome do modelo de integridade a ser recuperado.
Grupo de recursos Obrigatório O nome do grupo de recursos Azure.

Observação

Migração da versão 3.0.0-beta.24 e anterior: O monitor healthmodels entity get comando é removido em 3.0.0-beta.25. Use monitor healthmodels list para listar todos os modelos de saúde ou monitor healthmodels get para obter um modelo de saúde específico por nome.

Dicas de anotação da ferramenta:

Destrutivo Idempotent Mundo Aberto Somente leitura Secret Local Obrigatório
❌ ✅ ❌ ✅ ❌ ❌

Métricas: Métricas de consulta

Consultar métricas do Azure Monitor para um recurso. Essa ferramenta retorna dados de série temporal para as métricas especificadas, ajudando você a analisar o desempenho e a disponibilidade dos recursos. Essa ferramenta faz parte das ferramentas do PROTOCOLO MCP (Model Context Protocol).

Os prompts de exemplo incluem:

  • "Analise tendências de desempenho e tempos de resposta para o recurso 'appinsights-prod' do Application Insights com métricas 'requests/duration' e namespace de métrica 'microsoft.insights/components'."
  • "Verifique a métrica de disponibilidade 'availabilityResults/availabilityPercentage' para o recurso 'appinsights-staging' do Application Insights usando o namespace de métrica 'microsoft.insights/components'?"
  • "Obtenha a métrica 'requests/duration' com a agregação 'Average' e o intervalo 'PT1M' para o recurso 'appinsights-prod' usando o namespace de métrica 'microsoft.insights/components'."
  • "Investigue as taxas de erro e solicitações com falha para o recurso 'appinsights-prod' do Application Insights usando as métricas 'requests/failed,exceptions/count' e o namespace de métrica 'microsoft.insights/components'."
  • "Consulte a métrica 'requests/count' para o tipo de recurso 'Microsoft.Insights/components', recurso 'appinsights-qa', com o namespace de métrica 'microsoft.insights/components' e o intervalo 'PT5M'."
  • "Qual é a taxa de solicitações por segundo usando a métrica 'requests/count' com agregação 'Count' para o recurso do Application Insights 'appinsights-prod' e o namespace de métrica 'microsoft.insights/components'?"
Parâmetro Obrigatório ou opcional Description
Nomes de métrica Obrigatório Os nomes das métricas a serem consultadas, separadas por vírgulas.
Namespace de métrica Obrigatório O namespace de métrica a ser consultado. Obtenha esse valor da ferramenta azmcp-monitor-metrics-definitions.
Nome do recurso Obrigatório O nome do recurso Azure para o qual consultar as métricas.
Agregação Opcional O tipo de agregação a ser usado, como Média, Máximo, Mínimo, Total ou Contagem.
Hora de término Opcional A hora de término da consulta no formato ISO (por exemplo, 2023-01-01T00:00:00Z). O padrão é agora.
Filtro Opcional O filtro OData a ser aplicado à consulta de métricas.
Interval Opcional O intervalo de tempo para pontos de dados (por exemplo, PT1H por 1 hora, PT5M por 5 minutos).
Buckets máximos Opcional O número máximo de buckets de tempo a serem retornados. O padrão é 50.
Tipo de recurso Opcional O tipo de recurso Azure (por exemplo, Microsoft.Storage/storageAccounts, Microsoft.Compute/virtualMachines). Se não for especificado, a ferramenta tentará inferir o tipo do nome do recurso.
Hora de início Opcional A hora de início da consulta no formato ISO (por exemplo, 2023-01-01T00:00:00Z). O padrão é 24 horas atrás.

Dicas de anotação da ferramenta:

Destrutivo Idempotent Mundo Aberto Somente leitura Secret Local Obrigatório
❌ ✅ ❌ ✅ ❌ ❌

Métricas: Listar definições de métrica

Essa ferramenta lista definições de métrica para um recurso de Azure. Ele retorna metadados sobre cada métrica, incluindo namespaces, descrições e tipos de agregação, para que você possa determinar quais métricas consultar um recurso.

Os prompts de exemplo incluem:

  • "Obtenha definições de métrica para o nome do recurso 'app-insights-prod'."
  • "Liste as definições de métrica para o nome de recurso 'mystorageacct' com o tipo de recurso 'Microsoft.Storage/storageAccounts' e o namespace de métrica 'Storage'."
  • Mostrar definições de métrica para o nome do recurso 'vm-prod-01' com o termo de pesquisa 'cpu' e o limite '20'.
Parâmetro Obrigatório ou opcional Description
Nome do recurso Obrigatório O nome do recurso Azure para o qual consultar as métricas.
Limit Opcional O número máximo de definições de métrica a serem retornadas. Define-se por padrão como 10.
Namespace de métrica Opcional O namespace de métrica a ser consultado. Obtenha esse valor da ferramenta azmcp-monitor-metrics-definitions.
Tipo de recurso Opcional O tipo de recurso Azure (por exemplo, Microsoft.Storage/storageAccounts, Microsoft.Compute/virtualMachines). Se você não especificá-lo, a ferramenta tentará inferir o tipo de recurso do nome do recurso.
Cadeia de caracteres de pesquisa Opcional Uma cadeia de caracteres para filtrar as definições de métrica. O filtro faz correspondência sem diferenciar maiúsculas de minúsculas no nome e na descrição da métrica.

Dicas de anotação da ferramenta:

Destrutivo Idempotent Mundo Aberto Somente leitura Secret Local Obrigatório
❌ ✅ ❌ ✅ ❌ ❌

Instrumentação: Obter recurso de aprendizagem

Essa ferramenta lista todos os recursos de aprendizagem disponíveis para a instrumentação do Azure Monitor ou recupera o conteúdo de um recurso específico pelo caminho. Por padrão, a ferramenta retorna todos os caminhos de recurso. Se você especificar um caminho, a ferramenta retornará o conteúdo completo do recurso. Para instrumentar um aplicativo, use a ferramenta orchestrator-start.

Os prompts de exemplo incluem:

  • "Obtenha o recurso de aprendizagem de integração no caminho 'onboarding/get-started.md'."
  • Mostre-me o conteúdo do recurso de aprendizado de introdução do Azure Monitor no caminho 'onboarding/quickstart.md'.
  • "Recupere o conteúdo do arquivo de recurso de aprendizagem do Azure Monitor no caminho 'samples/instrumentation-guide.html'."
  • "Listar todos os recursos de aprendizagem para iniciar no Azure Monitor."
  • Mostre-me todas as trilhas de aprendizado de recursos para a instrumentação do Azure Monitor.
  • "Quais recursos de aprendizagem estão disponíveis para a integração da instrumentação do Azure Monitor?"
Parâmetro Obrigatório ou opcional Description
Caminho Opcional Caminho do recurso de aprendizagem.

Dicas de anotação da ferramenta:

Destrutivo Idempotent Mundo Aberto Somente leitura Secret Local Obrigatório
❌ ✅ ❌ ✅ ❌ ✅

Instrumentação: Iniciar orquestração

Comece aqui para ferramentas do Protocolo de Contexto do Modelo que instrumentam o Azure Monitor. Essa ferramenta analisa o workspace e retorna a primeira ação a ser executada. Depois de executar a ação, chame o orchestrator-next para continuar. Siga exatamente a ação no campo instruction.

Os prompts de exemplo incluem:

  • "Inicie a orquestração da instrumentação do Azure Monitor para o caminho do workspace '/home/dev/workspace-monitoring'."
  • "Analise o caminho do workspace '/src/projects/my-app-workspace' e retorne a primeira etapa de instrumentação do Azure Monitor."
  • "Inicie a integração guiada do Azure Monitor para o projeto no caminho do workspace '/workspace/my-app' e forneça a primeira etapa."
Parâmetro Obrigatório ou opcional Description
Caminho do workspace Obrigatório Caminho absoluto para a pasta do workspace.

Dicas de anotação da ferramenta:

Destrutivo Idempotent Mundo Aberto Somente leitura Secret Local Obrigatório
❌ ❌ ❌ ❌ ❌ ✅

Instrumentação: Continuar a orquestração

Obtenha a próxima ação de instrumentação depois de concluir a atual.

Essa ferramenta faz parte do pacote MCP (Model Context Protocol).

Depois de executar o instruction exato da resposta anterior, execute esta ferramenta para receber a próxima ação.

Fluxo de trabalho esperado:

  1. Você recebe uma ação de orchestrator-start ou orchestrator-next.
  2. Você executa exatamente o campo instruction.
  3. Execute essa ferramenta usando um conciso Completion note para obter a próxima ação.

Retorna: a próxima ação a executar ou o status complete quando todas as etapas forem concluídas.

Os prompts de exemplo incluem:

  • "Após concluir a etapa anterior de instrumentação do Azure Monitor, obtenha a próxima ação para a ID de sessão 'session-abc123' com a observação de conclusão 'Added UseAzureMonitor() to Program.cs'."
  • "Obtenha a próxima ação de integração para a ID de sessão 'workspace/session-2026' com a observação de conclusão 'Ran dotnet add package Microsoft.ApplicationInsights'."
  • "Após concluir a etapa anterior de instrumentação, retorne a próxima etapa para a ID de sessão 'session-789xyz' com a observação de conclusão 'appsettings.json atualizado para habilitar o Application Insights'."
Parâmetro Obrigatório ou opcional Description
Nota de conclusão Obrigatório Uma frase que descreve o que você executou, por exemplo, "Executei o comando dotnet add package" ou "Adicionado UseAzureMonitor() ao Program.cs".
ID da Sessão Obrigatório O caminho do workspace retornado como sessionId por orchestrator-start.

Dicas de anotação da ferramenta:

Destrutivo Idempotent Mundo Aberto Somente leitura Secret Local Obrigatório
❌ ❌ ❌ ❌ ❌ ✅

Instrumentação: enviar análise brownfield

Envia os achados da análise de código brownfield depois que orchestrator-start retorna o status analysis_needed. Essa ferramenta faz parte do fluxo de trabalho MCP (Model Context Protocol). Você deve examinar os arquivos de origem do workspace e preencher o modelo de análise antes de chamar essa ferramenta. Depois que essa ferramenta for bem-sucedida, continue com orchestrator-next.

Os prompts de exemplo incluem:

  • "Envie o JSON dos achados da análise de código brownfield '{"serviceOptions":null,"initializers":null,"processors":null,"clientUsage":null,"sampling":{"found":false,"hasCustomSampling":false},"telemetryPipeline":null,"logging":null}' para a sessão de instrumentação do Azure Monitor 'workspace-7a3b' depois que a análise for solicitada."
  • "Continue a orquestração da migração enviando o JSON de achados '{"serviceOptions":{"found":true,"details":"AddApplicationInsightsTelemetry used"},"initializers":[],"processors":[],"clientUsage":null,"sampling":{"found":false,"hasCustomSampling":false},"telemetryPipeline":null,"logging":null}' para a sessão 'sess-01234'."
  • "Envie a análise de telemetria brownfield concluída como JSON de achados '{"serviceOptions":null,"initializers":null,"processors":null,"clientUsage":{"found":true},"sampling":{"found":false,"hasCustomSampling":false},"telemetryPipeline":null,"logging":{"found":true}}' para a sessão de integração 'session-9f3b'."
Parâmetro Obrigatório ou opcional Description
JSON de descobertas Obrigatório Objeto JSON com resultados da análise de brownfield. Propriedades obrigatórias: serviceOptions (achados de opções de serviço da análise da chamada AddApplicationInsightsTelemetry(), nulo se não encontrado), initializers (achados de inicializadores de telemetria da análise de implementações de ITelemetryInitializer ou IConfigureOptions<TelemetryConfiguration>, nulo se nenhuma for encontrada), processors (achados de processadores de telemetria da análise de implementações de ITelemetryProcessor, nulo se nenhum for encontrado), clientUsage (achados de uso do TelemetryClient da análise do uso direto do TelemetryClient, nulo se não encontrado), sampling (achados de configuração de amostragem personalizada, nulo se não houver amostragem personalizada), telemetryPipeline (achados de uso personalizado de ITelemetryChannel ou TelemetrySinks, nulo se não encontrado), logging (achados explícitos de provedor e filtro de logger, nulo se não encontrado). Para seções que não existem na base de código, passe um objeto padrão vazio, por exemplo, encontrado: false ou hasCustomSampling: false, em vez de nulo.
ID da Sessão Obrigatório O caminho do workspace retornado como sessionId por orchestrator-start.

Dicas de anotação da ferramenta:

Destrutivo Idempotent Mundo Aberto Somente leitura Secret Local Obrigatório
❌ ❌ ❌ ❌ ❌ ✅

Instrumentação: Enviar seleção de aprimoramento

Envie a seleção de melhoria feita pelo usuário após orchestrator-start retornar o status enhancement_available. Apresente as opções de aprimoramento para o usuário e chame essa ferramenta com as chaves de aprimoramento escolhidas. Você pode selecionar vários aprimoramentos passando uma lista separada por vírgulas, por exemplo, redis,processors. Depois que essa ferramenta for bem-sucedida, continue com orchestrator-next.

Os prompts de exemplo incluem:

  • "Envie as chaves de aprimoramento 'redis,processors' para a ID de sessão de instrumentação do Azure Monitor 'workspaces/my-app/session-abc123'."
  • "Continue o fluxo de aprimoramento de instrumentação enviando chaves de aprimoramento 'redis' para a ID da sessão 'workspaces/prod-app/session-789'."
  • "Envie as chaves de aprimoramento escolhidas 'entityframework,otlp' para a ID de sessão de integração 'workspaces/onboard/session-456'."
Parâmetro Obrigatório ou opcional Description
Chaves de aprimoramento Obrigatório Uma ou mais chaves de aprimoramento, separadas por vírgulas (por exemplo, redis, , redis,processors). entityframework,otlp
ID da Sessão Obrigatório O caminho do workspace retornado como sessionId por orchestrator-start.

Dicas de anotação da ferramenta:

Destrutivo Idempotent Mundo Aberto Somente leitura Secret Local Obrigatório
❌ ❌ ❌ ❌ ❌ ✅

Pastas de trabalho: listar pastas de trabalho

Pesquise Azure pastas de trabalho usando o Resource Graph para consultas de metadados rápidas. Essa ferramenta ajuda você a descobrir, filtrar e contar pastas de trabalho em diferentes escopos.

Ele retorna metadados da pasta de trabalho, incluindo id, name, location, category e timestamps. Por padrão, ele não retorna o conteúdo completo da pasta de trabalho (serializedData) – use a ferramenta show para isso ou defina Output format como full.

Por padrão, a pesquisa tem como destino pastas de trabalho no contexto atual do Azure (locatário/assinatura). Você pode usar Resource group para especificar explicitamente seu escopo de pesquisa. A ferramenta retorna a contagem total do lado do servidor por padrão. O máximo de resultados retornados é 50, com um limite máximo de 1000; ajuste isso com Max results. Escolha Output format como summary para tokens mínimos ou full para a saída serializedData completa.

Os prompts de exemplo incluem:

  • "Mostre todas as pastas de trabalho no grupo de recursos 'monitoring-rg'."
  • "Listar as pastas de trabalho compartilhadas no grupo de recursos 'prod-rg'."
  • "Quais pastas de trabalho foram modificadas após 2024-01-15 no grupo de recursos 'analytics-rg'?"
Parâmetro Obrigatório ou opcional Description
Grupo de recursos Opcional O nome do grupo de recursos Azure.
Categoria Opcional Filtrar pastas de trabalho por categoria (por exemplo, workbook, sentinel, TSG). Se não for especificado, todas as categorias serão retornadas.
Incluir contagem total Opcional Inclua a contagem total de todas as pastas de trabalho correspondentes na resposta (padrão: true).
Kind Opcional Filtrar pastas de trabalho por tipo (por exemplo, shared, user). Se não for especificado, todos os tipos serão retornados.
Resultados máximos Opcional Número máximo de resultados a serem retornados (padrão: 50, máximo: 1000).
Modificado após Opcional Filtrar pastas de trabalho modificadas após essa data (formato ISO 8601, por exemplo). 2024-01-15
O nome contém Opcional Filtre pastas de trabalho em que o nome de exibição contém este texto (sem diferenciar maiúsculas de minúsculas).
Formato de saída Opcional Formato de saída: summary (ID e somente nome, tokens mínimos), standard (metadados sem conteúdo, padrão) full (inclui serializedData).
ID de origem Opcional Filtrar pastas de trabalho por ID do recurso de origem (por exemplo, /subscriptions/abc123/resourceGroups/prod/providers/Microsoft.Insights/components/myapp). Se não for especificado, todas as pastas de trabalho serão retornadas.

Dicas de anotação da ferramenta:

Destrutivo Idempotent Mundo Aberto Somente leitura Secret Local Obrigatório
❌ ✅ ❌ ✅ ❌ ❌

Pastas de trabalho: mostrar detalhes da pasta de trabalho

Recupere detalhes completos da pasta de trabalho pela API do Azure Resource Manager (ARM), incluindo o conteúdo serializedData. Esse comando permite que você obtenha a definição completa da pasta de trabalho, incluindo o JSON de visualização.

Ela retorna as propriedades completas da pasta de trabalho, serializedData, marcas e ETag. Você pode fornecer vários Workbook IDs para operações em lote. O comando relata falhas parciais nos livros de trabalho individuais. Para obter melhor desempenho, use a ferramenta de lista para primeiro descobrir as pastas de trabalho e, em seguida, use o comando "mostrar" para pastas de trabalho específicas.

Os prompts de exemplo incluem:

  • "Mostre os detalhes da pasta de trabalho com a ID de recurso '/subscriptions/abc123/resourceGroups/monitoring/providers/Microsoft.Insights/workbooks/a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1'."
  • Obtenha a definição completa do workbook '/subscriptions/xyz789/resourceGroups/prod-rg/providers/Microsoft.Insights/workbooks/b1b1b1b1-cccc-dddd-eeee-f2f2f2f2f2f2'.
Parâmetro Obrigatório ou opcional Description
IDs de pasta de trabalho Obrigatório As IDs de recurso do Azure das pastas de trabalho a serem recuperados. Dá suporte a vários valores para operações em lote.

Dicas de anotação da ferramenta:

Destrutivo Idempotent Mundo Aberto Somente leitura Secret Local Obrigatório
❌ ✅ ❌ ✅ ❌ ❌

Planilhas: Criar planilha

Crie um nova pasta de trabalho no grupo de recursos e na assinatura especificados. Você pode definir o nome de exibição e o conteúdo JSON serializado para a pasta de trabalho. Esse comando retorna as informações da pasta de trabalho criada após a conclusão bem-sucedida.

Os prompts de exemplo incluem:

  • "Crie uma nova pasta de trabalho chamada 'Painel de Desempenho' no grupo de recursos 'monitoring-rg' com o conteúdo serializado para um notebook básico."
  • "Crie uma pasta de trabalho chamada 'Visão geral da infraestrutura' no grupo de recursos 'prod-rg' com conteúdo mostrando métricas de VM."
Parâmetro Obrigatório ou opcional Description
Nome de exibição Obrigatório O nome de exibição da pasta de trabalho.
Grupo de recursos Obrigatório O nome do grupo de recursos Azure.
Conteúdo serializado Obrigatório O conteúdo JSON serializado da pasta de trabalho.
ID de origem Opcional A ID do recurso vinculado da pasta de trabalho. Por padrão, ela é azure monitor.

Dicas de anotação da ferramenta:

Destrutivo Idempotent Mundo Aberto Somente leitura Secret Local Obrigatório
✅ ❌ ❌ ❌ ❌ ❌

Pastas de trabalho: atualizar pasta de trabalho

Atualize as propriedades de uma pasta de trabalho Azure existente adicionando novas etapas, modificando o conteúdo ou alterando o nome de exibição. Essa ação retorna os detalhes atualizados da pasta de trabalho. Você precisa da ID do recurso da pasta de trabalho e pode especificar um novo conteúdo serializado ou um novo nome de exibição.

Os prompts de exemplo incluem:

  • Atualize a pasta de trabalho '/subscriptions/abc123/resourceGroups/monitoring-rg/providers/Microsoft.Insights/workbooks/a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1' com o nome de exibição 'Relatório Mensal'.
  • Altere o conteúdo serializado do workbook '/subscriptions/xyz789/resourceGroups/prod-rg/providers/Microsoft.Insights/workbooks/b1b1b1b1-cccc-dddd-eeee-f2f2f2f2f2f2' para incluir um novo gráfico de métricas.
Parâmetro Obrigatório ou opcional Description
ID da pasta de trabalho Obrigatório A ID de recurso do Azure do pasta de trabalho a ser atualizada.
Nome de exibição Opcional O nome de exibição da pasta de trabalho.
Conteúdo serializado Opcional O conteúdo serializado JSON da pasta de trabalho.

Dicas de anotação da ferramenta:

Destrutivo Idempotent Mundo Aberto Somente leitura Secret Local Obrigatório
✅ ✅ ❌ ❌ ❌ ❌

Pastas de trabalho: excluir pastas de trabalho

Exclua uma ou mais pastas de trabalho por meio de suas IDs de recurso do Azure. Esse comando executa uma exclusão temporária de pastas de trabalho, retendo-as por 90 dias. Você pode restaurá-los da Lixeira pelo portal do Azure, se necessário.

Para operações em lote, você pode fornecer vários Workbook IDs valores. O comando relata falhas parciais por pasta de trabalho, garantindo que falhas individuais não afetem toda a operação em lote.

Para saber mais, consulte Manage Azure Monitor pastas de trabalho.

Os prompts de exemplo incluem:

  • "Exclua a pasta de trabalho com a ID de recurso '/subscriptions/abc123/resourceGroups/monitoring/providers/Microsoft.Insights/workbooks/a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1'."
  • "Remova as pastas de trabalho com as IDs de recurso '/subscriptions/xyz789/resourceGroups/prod-rg/providers/Microsoft.Insights/workbooks/b1b1b1b1-cccc-dddd-eeee-f2f2f2f2f2f2' e '/subscriptions/def456/resourceGroups/analytics-rg/providers/Microsoft.Insights/workbooks/c2c2c2c2-dddd-eeee-ffff-a3a3a3a3a3a3'."
Parâmetro Obrigatório ou opcional Description
IDs de pasta de trabalho Obrigatório As IDs de recurso do Azure das pastas de trabalho a serem excluídos. Dá suporte a vários valores para operações em lote.

Dicas de anotação da ferramenta:

Destrutivo Idempotent Mundo Aberto Somente leitura Secret Local Obrigatório
✅ ✅ ❌ ❌ ❌ ❌

Conteúdo relacionado

  • Last updated on