Compartilhar via


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 os espaços de trabalho do Log Analytics, analisar dados operacionais, monitorar a saúde dos recursos, recuperar métricas de desempenho e gerenciar as 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 abaixo. 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 anteriores para o qual recuperar logs de atividade.
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: ❌ | Idempotente: ✅ | Mundo Aberto: ❌ | Somente leitura: ✅ | Segredo: ❌ | Local Necessá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 '/subscriptions/12345678-1234-1234-1234-123456789abc/resourceGroups/rg-ai/providers/microsoft.insights/components/appinsights-prod'.
  • Atualize um teste da Web padrão existente para o recurso 'webtest-prod-availability' no grupo de recursos 'rg-prod-monitoring' para vinculá-lo ao componente do 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 de Teste da 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 de 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.

Dicas de anotação da ferramenta:

Destrutivo: ✅ | Idempotente: ✅ | Mundo Aberto: ❌ | Somente leitura: ❌ | Segredo: ❌ | Local Necessá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 de Teste da Web no qual operar.

Dicas de anotação da ferramenta:

Destrutivo: ❌ | Idempotente: ✅ | Mundo Aberto: ❌ | Somente leitura: ✅ | Segredo: ❌ | Local Necessá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:

  • Listar Log Analytics workspaces na minha assinatura.
  • Exibir meus workspaces de Log Analytics.
  • "Obtenha os Log Analytics workspaces na minha assinatura."

Dicas de anotação da ferramenta:

Destrutivo: ❌ | Idempotente: ✅ | Mundo Aberto: ❌ | Somente leitura: ✅ | Segredo: ❌ | Local Necessá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 Log Analytics workspace '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
Nome do espaço de trabalho Opcional 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.

Dicas de anotação da ferramenta:

Destrutivo: ❌ | Idempotente: ✅ | Mundo Aberto: ❌ | Somente leitura: ✅ | Segredo: ❌ | Local Necessá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 do Log Analytics '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 que contém o workspace.
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: ❌ | Idempotente: ✅ | Mundo Aberto: ❌ | Somente leitura: ✅ | Segredo: ❌ | Local Necessário: ❌

Log Analytics: Consultar logs do espaço de trabalho

Consultar logs em todo o workspace do Log Analytics usando a Linguagem de Consulta Kusto (KQL). Essa ferramenta executa consultas em todo o espaço de trabalho que retornam logs em todos os recursos e tabelas do espaço de trabalho. 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:

  • "Mostrar logs com a consulta 'errors' da tabela 'Syslog' no Log Analytics workspace 'my-workspace' no grupo de recursos 'rg-prod'."
Parâmetro Obrigatório ou opcional Description
Consulta Obrigatório A consulta KQL (Linguagem de Consulta Kusto) a ser executada no workspace 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. Ou forneça uma consulta KQL personalizada.
Grupo de recursos Obrigatório O nome do grupo de recursos Azure que contém o workspace.
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 para consultar novamente a partir de agora.
Limit Opcional O número máximo de resultados a serem retornados.

Dicas de anotação da ferramenta:

Destrutivo: ❌ | Idempotente: ✅ | Mundo Aberto: ❌ | Somente leitura: ✅ | Segredo: ❌ | Local Necessário: ❌

Análise de Logs: consultar os logs de recursos

Consultar logs de diagnóstico e atividade para um recurso específico do Microsoft Azure em um workspace do Log Analytics usando KQL (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 "Exibir os logs do recurso 'app-monitor' nas últimas 24 horas."

Os prompts de exemplo incluem:

  • Mostrar logs com a consulta 'recente' para ID de recurso '/subscriptions/12345678-1234-1234-1234-123456789012/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 workspace.
Hours Opcional O número de horas para consultar novamente a partir de agora.
Limit Opcional O número máximo de resultados a serem retornados.

Dicas de anotação da ferramenta:

Destrutivo: ❌ | Idempotente: ✅ | Mundo Aberto: ❌ | Somente leitura: ✅ | Segredo: ❌ | Local Necessário: ❌

Saúde: Obter saúde da entidade

Essa ferramenta recupera o status de integridade e os eventos de integridade recentes de uma entidade específica em um modelo de integridade Azure Monitor. 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 obter disponibilidade básica de recursos, use Azure Resource Health ou a ferramenta azmcp_resourcehealth_availability-status_get. Para consultar logs em um workspace do Log Analytics, 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:

  • "Mostre-me o status de integridade da entidade 'order-service' usando o modelo de integridade 'app-health-v1' no grupo de recursos 'rg-prod'."
Parâmetro Obrigatório ou opcional Description
Nome da entidade Obrigatório A entidade para a qual obter saúde.
Modelo de saúde Obrigatório O nome do modelo de saúde para o qual obter a saúde.
Grupo de recursos Obrigatório O nome do grupo de recursos Azure. Esse grupo de recursos é um contêiner lógico para recursos Azure.

Dicas de anotação da ferramenta:

Destrutivo: ❌ | Idempotente: ✅ | Mundo Aberto: ❌ | Somente leitura: ✅ | Segredo: ❌ | Local Necessá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 'Média' 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/componentes', recurso 'appinsights-qa', com o namespace de métrica 'microsoft.insights/componentes' e intervalo 'PT5M'."
  • "Qual é a taxa de solicitações por segundo usando a métrica 'requests/count' com a 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 valor padrão é o momento atual.
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 valor 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). A configuração padrão é de 24 horas antes.

Dicas de anotação da ferramenta:

Destrutivo: ❌ | Idempotente: ✅ | Mundo Aberto: ❌ | Somente leitura: ✅ | Segredo: ❌ | Local Necessá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'."
  • "Listar definições de métricas para o recurso de nome 'mystorageacct' com o tipo de recurso 'Microsoft.Storage/storageAccounts' e 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 realiza correspondências insensíveis a maiúsculas e minúsculas no nome e na descrição da métrica.

Dicas de anotação da ferramenta:

Destrutivo: ❌ | Idempotente: ✅ | Mundo Aberto: ❌ | Somente leitura: ✅ | Segredo: ❌ | Local Necessá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 o onboarding de instrumentação do Azure Monitor?
Parâmetro Obrigatório ou opcional Description
Caminho Opcional Roteiro do recurso de aprendizagem.

Dicas de anotação da ferramenta:

Destrutivo: ❌ | Idempotente: ✅ | Mundo Aberto: ❌ | Somente leitura: ✅ | Segredo: ❌ | Local Necessário: ✅

Instrumentação: Iniciar orquestração

Comece aqui com ferramentas do Protocolo MCP (Model Context Protocol) que usam 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 de instrumentação do Azure Monitor para o caminho do workspace '/home/dev/workspace-monitoring'.
  • Analise o caminho no workspace '/src/projects/my-app-workspace' e retorne a primeira etapa de instrumentação para o Azure Monitor.
  • Comece a integração guiada do Azure Monitor para o projeto no caminho do espaço de trabalho '/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 espaço de trabalho.

Dicas de anotação da ferramenta:

Destrutivo: ❌ | Idempotente: ❌ | Mundo Aberto: ❌ | Somente leitura: ❌ | Segredo: ❌ | Local Necessá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 comando instruction da resposta anterior, utilize 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 ser executada ou complete status quando todas as etapas forem concluídas.

Os prompts de exemplo incluem:

  • "Depois de concluir a etapa de instrumentação Azure Monitor anterior, obtenha a próxima ação para a identificação da sessão 'session-abc123' com a nota de conclusão 'Adicionado UseAzureMonitor() ao Program.cs'."
  • Obtenha a próxima ação de integração para a sessão com ID 'workspace/session-2026', com a nota de conclusão 'Ran dotnet add package Microsoft.ApplicationInsights'.
  • "Depois de concluir a etapa de instrumentação anterior, retorne a próxima etapa da ID da sessão 'session-789xyz' com a nota de conclusão 'Atualizado appsettings.json 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 a partir do orchestrator-start.

Dicas de anotação da ferramenta:

Destrutivo: ❌ | Idempotente: ❌ | Mundo Aberto: ❌ | Somente leitura: ❌ | Segredo: ❌ | Local Necessário: ✅

Instrumentação: Transmitir análise de projetos brownfield

Envia resultados da análise de código brownfield após orchestrator-start retornar 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:

  • Enviar o JSON dos resultados da análise de código brownfield '{"serviceOptions":null,"initializers":null,"processors":null,"clientUsage":null,"sampling":{"found":false,"hasCustomSampling":false},"telemetryPipeline":null,"logging":null}' na sessão de instrumentação do Azure Monitor 'workspace-7a3b' após a solicitação da análise.
  • Continue a orquestração da migração enviando as descobertas JSON '{"serviceOptions":{"found":true,"details":"AddApplicationInsightsTelemetry usado"},"initializers":[],"processors":[],"clientUsage":null,"sampling":{"found":false,"hasCustomSampling":false},"telemetryPipeline":null,"logging":null}' para a sessão 'sess-01234'.
  • Enviar a análise de telemetria de brownfield concluída como descoberta JSON '{"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 necessárias: serviceOptions (descobertas de opções de serviço da análise da chamada AddApplicationInsightsTelemetry(), nulo se não encontrado), inicializadores (descobertas de inicializadores de telemetria da análise de implementações de ITelemetryInitializer ou IConfigureOptions<TelemetryConfiguration>, nulo se nenhuma encontrada), processadores (descobertas do processador de telemetria da análise de implementações do ITelemetryProcessor, nulo se nenhum encontrado), clientUsage (descobertas de uso de TelemetryClient da análise direta do uso de TelemetryClient, nulo se não encontrado), amostragem (descobertas de configuração de amostragem personalizada, nulo se não houver amostragem personalizada), telemetryPipeline (descobertas de uso personalizadas de ITelemetryChannel ou TelemetrySinks, nulo se não encontrado), logging (descobertas de provedor de logger explícito e filtro, 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 de orchestrator-start.

Dicas de anotação da ferramenta:

Destrutivo: ❌ | Idempotente: ❌ | Mundo Aberto: ❌ | Somente leitura: ❌ | Segredo: ❌ | Local Necessá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 chaves de aprimoramento 'redis, processadores' para Azure Monitor ID da sessão de instrumentação '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'."
  • "Enviar chaves de aprimoramento escolhidas 'entityframework,otlp' para integrar a ID da sessã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 de orchestrator-start.

Dicas de anotação da ferramenta:

Destrutivo: ❌ | Idempotente: ❌ | Mundo Aberto: ❌ | Somente leitura: ❌ | Segredo: ❌ | Local Necessá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 é direcionada para as planilhas de trabalho no seu 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 saída completa serializedData .

Os prompts de exemplo incluem:

  • "Mostre-me 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 para definir o escopo da pesquisa.
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 Filtrar pastas de trabalho em que o nome de exibição contém esse texto (que não diferencia 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: ❌ | Idempotente: ✅ | Mundo Aberto: ❌ | Somente leitura: ✅ | Segredo: ❌ | Local Necessário: ❌

Pastas de trabalho: mostrar detalhes da pasta de trabalho

Recupere detalhes completos da pasta de trabalho por meio da API 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.

Ele retorna propriedades completas da pasta de trabalho, serializedDatamarcas 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-me 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 da pasta de trabalho Obrigatório Os IDs de recurso do Azure dos livros de trabalho a serem recuperados. Dá suporte a vários valores para operações em lote.

Dicas de anotação da ferramenta:

Destrutivo: ❌ | Idempotente: ✅ | Mundo Aberto: ❌ | Somente leitura: ✅ | Segredo: ❌ | Local Necessário: ❌

Planilhas: Criar planilha

Crie uma nova pasta de trabalho no grupo de recursos e na assinatura especificada. 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 que contém a pasta de trabalho.
Conteúdo serializado Obrigatório O conteúdo JSON serializado da pasta de trabalho.
ID de origem Opcional O ID do recurso vinculado do livro de trabalho. Por padrão, ela é azure monitor.

Dicas de anotação da ferramenta:

Destrutivo: ✅ | Idempotente: ❌ | Mundo Aberto: ❌ | Somente leitura: ❌ | Segredo: ❌ | Local Necessá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 O Azure ID do recurso da 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: ✅ | Idempotente: ✅ | Mundo Aberto: ❌ | Somente leitura: ❌ | Segredo: ❌ | Local Necessá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 o livro de trabalho com a ID do recurso '/subscriptions/abc123/resourceGroups/monitoring/providers/Microsoft.Insights/workbooks/a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1'."
  • "Remova as pastas de trabalho com IDs de recurso '/subscriptions/xyz789/resourceGroups/prod-rg/providers/Microsoft. Insights/pastas de trabalho/b1b1b1b1-cccc-dddd-eeee-f2f2f2f2f2f2' e '/subscriptions/def456/resourceGroups/analytics-rg/providers/Microsoft. Insights/pastas de trabalho/c2c2c2c2-dddd-eeee-ffff-a3a3a3a3a3a3'."
Parâmetro Obrigatório ou opcional Description
IDs da Pasta de Trabalho Obrigatório Os IDs de recurso do Azure das planilhas a serem excluídas. Dá suporte a vários valores para operações em lote.

Dicas de anotação da ferramenta:

Destrutivo: ✅ | Idempotente: ✅ | Mundo Aberto: ❌ | Somente leitura: ❌ | Segredo: ❌ | Local Necessário: ❌