Partilhar via

Ferramentas Azure MCP Server para Azure Monitor e Workbooks

O Azure Model Context Protocol (MCP) Server permite-lhe gerir recursos do Azure Monitor e Workbooks com prompts em linguagem natural. Pode consultar espaços de trabalho do Log Analytics, analisar dados operacionais, monitorizar a saúde dos recursos, recuperar métricas de desempenho e gerir livros de trabalho do Azure Monitor.

Azure Monitor ajuda-o a maximizar a disponibilidade e o desempenho das suas aplicações e serviços. Ele fornece uma solução abrangente para recolher, analisar e agir sobre telemetria dos seus ambientes em nuvem e locais.

Os cadernos de exercícios fornecem uma tela flexível para análise de dados e criação de relatórios visuais ricos dentro do portal Azure. Permitem aceder a múltiplas fontes de dados de todo o Azure e combiná-las em experiências interativas unificadas. Os livros permitem-lhe combinar vários tipos de visualizações e análises, o que os torna ótimos para a exploração de forma livre. Para mais informações, consulte a documentação de workbooks do Azure Monitor.

Observação

Parâmetros das ferramentas: As ferramentas Azure MCP Server definem parâmetros para os dados necessários para completar 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 da ferramenta.

Registo de Atividade: Obtenha registos de atividade

Lista registos de atividade do Azure Monitor para um recurso Azure especificado para um dado número de horas passadas. Esta ferramenta ajuda-o a compreender o histórico de implementação de recursos, alterações de configuração e padrões de acesso. Devolve eventos do registo de atividade que incluem carimbo temporal, nome da operação, estado e informações do chamador. Use os resultados para investigar implementações falhadas, alterações inesperadas ou problemas de acesso.

Exemplos de prompts incluem:

  • "Liste os registos de atividade das ú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 recuperar registos de atividade.
Nível do 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, retorna todos os níveis.
Hours Opcional O número de horas antes de agora para recuperar registos de atividade.
Tipo de recurso Opcional O tipo do recurso Azure (por exemplo, 'Microsoft.Storage/storageAccounts'). Só forneça isso se necessário para desambiguar entre vários recursos com o mesmo nome.
Início 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: ❌

Web Tests: Criar ou atualizar testes web

Parte da ferramenta Model Context Protocol (MCP), esta ferramenta cria ou atualiza um teste web padrão no Azure Monitor para verificar a disponibilidade dos endpoints. Especifica-se as definições de monitorização, tais como o URL, a frequência, as localizações e as respostas esperadas. Se o teste não existir, esta ferramenta cria-o; caso contrário, atualiza o teste existente com as novas definições.

Exemplos de prompts incluem:

  • Crie um novo Teste Web Padrão com o recurso de teste web 'webtest-prod-availability' no grupo de recursos 'rg-prod-monitoring' e associe-o ao componente do AppInsights '/subscriptions/12345678-1234-1234-1234-123456789abc/resourceGroups/rg-ai/providers/microsoft.insights/components/appinsights-prod'.
  • Atualize um Teste Web Padrão existente para o recurso webtest 'webtest-prod-availability' no grupo de recursos 'rg-prod-monitoring' para ligá-lo ao componente AppInsights '/subscriptions/12345678-1234-1234-1234-1234-12356789abc/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 web a ser operado.
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 web.
Ativado Opcional Se o teste da Web está habilitado.
Código de status esperado Opcional Código de status HTTP esperado.
Seguir redirecionamentos Opcional Se devo seguir os redirecionamentos HTTP.
Frequência Opcional Frequência de teste em segundos. Valores suportados: 300, 600, 900.
Cabeçalhos Opcional Cabeçalhos HTTP para incluir no pedido, como pares KEY=VALUE separados por vírgulas.
Verbo HTTP Opcional Método HTTP a utilizar, por exemplo, get ou post.
Ignorar código de estado Opcional Se a validação do código de status deve ser ignorada.
Localização Opcional O local onde o recurso de teste da Web é criado. Isto deve corresponder à localização do componente Application Insights.
Analisar pedidos Opcional Se as solicitações dependentes devem ser analisadas.
Corpo da solicitação Opcional O corpo para enviar com o pedido.
URL de solicitação Opcional O URL absoluto a ser testado.
Tentativa ativada Opcional Se as novas tentativas estão habilitadas.
Verificação SSL Opcional Se deve validar certificados SSL.
Verificação do tempo de vida do SSL Opcional Número de dias para verificar o tempo de vida do certificado SSL.
Tempo limite Opcional Tempo limite de solicitação em segundos. Valores suportados: 30, 60, 90, 120.
Nome do teste web Opcional O nome do teste dentro do recurso de teste web.
Locais de teste da Web Opcional Lista separada por vírgulas dos locais a partir dos quais se pode executar o teste. Localização refere-se à etiqueta de população de geolocalização para os Testes de Disponibilidade.

Dicas de anotação da ferramenta:

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

Web Tests: Obtenha testes web

Esta ferramenta obtém detalhes para um teste web específico ou lista todos os testes web. Quando especifica o recurso Webtest, esta ferramenta devolve informações detalhadas para esse teste web. Quando não especifica o recurso Webtest, esta ferramenta devolve uma lista de todos os testes web na subscrição, e pode filtrar a lista por grupo de recursos.

Exemplos de prompts incluem:

  • Obtenha os detalhes do teste web para o recurso 'webtest-prod' na subscrição no grupo de recursos 'rg-monitoring'.
  • "Liste todos os recursos de Web Test na minha subscrição."
  • Liste todos os recursos de Teste Web na minha subscrição no grupo de recursos 'rg-prod'.
Parâmetro Obrigatório ou opcional Description
Recurso Webtest Opcional O nome do recurso de teste web a ser operado.

Dicas de anotação da ferramenta:

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

Log Analytics: Listar espaços de trabalho

Esta ferramenta lista os espaços de trabalho do Log Analytics numa subscrição. Recupera o nome, ID, localização e outras propriedades chave de cada espaço de trabalho. Pode usá-lo para identificar espaços de trabalho antes de consultar os registos ou examinar as definições do espaço de trabalho.

Exemplos de prompts incluem:

  • "Listar espaços de trabalho do Log Analytics na minha subscrição."
  • "Mostrar os meus espaços de trabalho do Log Analytics."
  • "Obtenha os espaços de trabalho do Log Analytics na minha subscrição."

Dicas de anotação da ferramenta:

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

Log Analytics: Tabelas de listas

Esta ferramenta lista todas as tabelas num espaço de trabalho de Log Analytics. Por exemplo, listar tabelas no espaço de trabalho 'prod-law' do grupo de recursos 'rg-monitoring' para pré-visualizar colunas e tipos de dados disponíveis. Ele devolve nomes de tabelas e esquemas que utiliza para construir consultas da Linguagem de Consulta Kusto (KQL). Pode filtrar por tipo de tabela, por exemplo CustomLog ou AzureMetrics.

Exemplos de prompts incluem:

  • "Liste todas as tabelas no espaço de trabalho Log Analytics 'prod-law' do tipo de tabela 'CustomLog' no grupo de recursos 'rg-prod'."
  • "Mostre-me tabelas do tipo de tabela 'AzureMetrics' para o espaço de trabalho 'f1b2c3d4-5678-90ab-cdef-1234567890ab' no grupo de recursos 'rg-monitoring'."
Parâmetro Obrigatório ou opcional Description
Nome da área de trabalho Opcional O ID ou nome do espaço de trabalho do Log Analytics. Isso pode ser o identificador exclusivo (GUID) ou o nome para 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

Esta ferramenta Model Context Protocol (MCP) lista os tipos de tabelas disponíveis num espaço de trabalho do Azure Log Analytics. Devolve os nomes dos tipos de tabelas. Podes usar esses nomes quando escreveres consultas no Azure Monitor Logs.

Exemplos de prompts incluem:

  • "Liste todos os tipos de tabelas disponíveis no nome do espaço de trabalho do Log Analytics 'prod-law-01' no grupo de recursos 'rg-prod'."
  • "Que tipos de tabelas estão disponíveis no nome do espaço de trabalho 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 espaço de trabalho.
Nome da área de trabalho Obrigatório O nome ou ID do espaço de trabalho do Log Analytics. Podes usar o GUID do workspace ou o nome de visualização.

Dicas de anotação da ferramenta:

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

Log Analytics: Consultar registos do espaço de trabalho

Consultar registos em todo o espaço de trabalho do Log Analytics utilizando o Kusto Query Language (KQL). Esta ferramenta executa consultas em todo o espaço de trabalho que retornam registos de todos os recursos e tabelas do espaço de trabalho. Esta ferramenta faz parte das ferramentas Model Context Protocol (MCP). Por exemplo, pode perguntar: 'mostrar todos os erros no meu espaço de trabalho', 'o que aconteceu no meu espaço de trabalho nas últimas 24 horas', 'listar pedidos falhados em todo o espaço de trabalho'.

Exemplos de prompts incluem:

  • "Mostrar registos com erros de consulta da tabela 'Syslog' no espaço de trabalho do Log Analytics 'meu-espaço de trabalho' no grupo de recursos 'rg-prod'."
Parâmetro Obrigatório ou opcional Description
Consulta Obrigatório A consulta da Linguagem de Consultas Kusto (KQL) a ser executada no espaço de trabalho do Log Analytics. Pode usar consultas pré-definidas por nome: recent mostra os registos mais recentes, ordenados por TimeGenerated; errors mostra registos ao nível de erro, ordenados por TimeGenerated. Ou, fornecer uma consulta KQL personalizada.
Grupo de recursos Obrigatório O nome do grupo de recursos Azure que contém o espaço de trabalho.
Nome da tabela Obrigatório O nome da tabela a consultar dentro do espaço de trabalho.
Nome da área de trabalho Obrigatório O ID ou nome do espaço de trabalho do Log Analytics. Pode fornecer o identificador globalmente único (GUID) ou o nome de exibição do espaço de trabalho.
Hours Opcional O número de horas para consultar de volta 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: ❌

Log Analytics: Consultar registos de recursos

Consulta aos registos de diagnóstico e de atividade de um recurso específico do Azure num espaço de trabalho Log Analytics usando a Linguagem de Consulta Kusto (KQL). Esta ferramenta filtra os resultados para o recurso especificado e executa a consulta KQL fornecida contra a tabela escolhida. Por exemplo, pergunte "Mostrar registos do recurso 'app-monitor' nas últimas 24 horas."

Exemplos de prompts incluem:

  • Mostrar registos com a consulta 'recent' para o 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. Pode usar consultas pré-definidas por nome: recent mostra os registos mais recentes ordenados por TimeGenerated; errors mostra registos ao nível de erro ordenados por TimeGenerated. Caso contrário, forneça uma consulta KQL personalizada.
ID do recurso Obrigatório O Azure Resource ID do recurso a consultar. Exemplo: /subscriptions/<sub>/resourceGroups/<rg>/providers/Microsoft.OperationalInsights/workspaces/<ws>.
Nome da tabela Obrigatório O nome da tabela a consultar dentro do espaço de trabalho.
Hours Opcional O número de horas para consultar de volta 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: Obtenha a saúde da entidade

Esta ferramenta recupera o estado de saúde e os eventos recentes de saúde de uma entidade específica num modelo de saúde do Azure Monitor. A ferramenta Model Context Protocol (MCP) reporta a saúde ao nível da aplicação com base em modelos de saúde personalizados, e não a disponibilidade básica de recursos. Para disponibilidade básica de recursos, use Azure Resource Health ou a ferramenta azmcp_resourcehealth_availability-status_get. Para consultar logs em um espaço de trabalho do Log Analytics, utilize azmcp_monitor_workspace_log_query. Para consultar registos de um recurso Azure específico, use azmcp_monitor_resource_log_query.

Exemplos de prompts incluem:

  • "Mostra-me o estado de saúde da entidade 'order-service' usando o modelo de saúde 'app-health-v1' no grupo de recursos 'rg-prod'."
Parâmetro Obrigatório ou opcional Description
Nome da entidade Obrigatório A entidade para verificar o estado de saúde.
Modelo de saúde Obrigatório O nome do modelo de saúde para o qual se deve obter a saúde.
Grupo de recursos Obrigatório O nome do grupo de recursos Azure. Este grupo de recursos é um contentor lógico para recursos do Azure.

Dicas de anotação da ferramenta:

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

Métricas: Métricas de consulta

Consulta métricas do Azure Monitor para um recurso. Esta ferramenta devolve dados de séries temporais para as métricas especificadas, ajudando-o a analisar o desempenho e a disponibilidade dos recursos. Esta ferramenta faz parte das ferramentas Model Context Protocol (MCP).

Exemplos de prompts incluem:

  • "Analisar tendências de desempenho e tempos de resposta para o recurso Application Insights 'appinsights-prod' com métricas 'requests/duration' e espaço de nomes de métricas 'microsoft.insights/components'."
  • "Verifique a métrica de disponibilidade 'availabilityResults/availabilityPercentage' para o recurso Application Insights 'appinsights-staging' usando o espaço de nomes da métrica 'microsoft.insights/components'?"
  • Obtenha a métrica 'requests/duration' com agregação 'Média' e intervalo 'PT1M' para o recurso 'appinsights-prod' usando o namespace de métricas 'microsoft.insights/components'.
  • Investigue as taxas de erro e os pedidos falhados para o recurso Application Insights 'appinsights-prod', utilizando as métricas 'requests/failed,exceptions/count' e o espaço de nomes de métricas 'microsoft.insights/components'.
  • "Consulta a métrica 'requests/count' para o tipo de recurso 'Microsoft.Insights/components', recurso 'appinsights-qa', com o espaço de nomes métrico 'microsoft.insights/components' 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 Application Insights 'appinsights-prod' e o namespace métrico 'microsoft.insights/components'?
Parâmetro Obrigatório ou opcional Description
Nomes métricos Obrigatório Os nomes das métricas a consultar, separados por vírgulas.
Namespace de métrica Obrigatório O namespace de métricas a consultar. Obtenha este valor a partir da ferramenta azmcp-monitor-metrics-definitions.
Nome do recurso Obrigatório O nome do recurso Azure para consultar métricas.
Agregação Opcional O tipo de agregação a usar, como Média, Máximo, Mínimo, Total ou Contagem.
Hora de fim Opcional O tempo de fim da consulta em formato ISO (por exemplo, 2023-01-01T00:00:00Z). Por padrão, define-se para o momento atual.
Filtro Opcional O filtro OData para aplicar à consulta de métricas.
Interval Opcional O intervalo de tempo para pontos de dados (por exemplo, PT1H para 1 hora, PT5M para 5 minutos).
Caçambas máximas Opcional O número máximo de intervalos de tempo a devolver. 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 tenta inferir o tipo a partir do nome do recurso.
Hora de início Opcional A hora de início da consulta em formato ISO (por exemplo, 2023-01-01T00:00:00Z). ** Por padrão, define-se como há 24 horas.

Dicas de anotação da ferramenta:

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

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

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

Exemplos de prompts incluem:

  • "Obtenha definições métricas para o nome do recurso 'app-insights-prod'."
  • Liste definições de métricas para o nome do recurso 'mystorageacct' com o tipo de recurso 'Microsoft.Storage/storageAccounts' e o espaço de nomes métricos 'Storage'.
  • "Mostrar definições de métricas para o nome do recurso 'vm-prod-01' com a cadeia de pesquisa 'cpu' e limite '20'."
Parâmetro Obrigatório ou opcional Description
Nome do recurso Obrigatório O nome do recurso Azure para consultar métricas.
Limit Opcional O número máximo de definições métricas a devolver. O valor padrão é 10.
Namespace de métrica Opcional O espaço de nomes métrico a consultar. Obtenha este valor a partir da ferramenta azmcp-monitor-metrics-definitions.
Tipo de recurso Opcional O tipo de recurso Azure (por exemplo, Microsoft.Storage/storageAccounts, Microsoft.Compute/virtualMachines). Se não o especificar, a ferramenta tenta inferir o tipo de recurso a partir do nome do recurso.
Cadeia de pesquisa Opcional Uma cadeia para filtrar as definições métricas. O filtro realiza correspondência insensível a maiúsculos e minúsculos com base no nome e descrição da métrica.

Dicas de anotação da ferramenta:

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

Instrumentação: Obtenha recursos de aprendizagem

Esta ferramenta lista todos os recursos de aprendizagem disponíveis para instrumentação do Azure Monitor, ou recupera o conteúdo de um recurso específico por caminho. Por predefinição, a ferramenta devolve todos os paths de recursos. Se especificar um caminho, a ferramenta devolve o conteúdo completo dos recursos. Para instrumentar uma aplicação, use a ferramenta orchestrator-start.

Exemplos de prompts incluem:

  • Obtenha o recurso de aprendizagem de integração no caminho 'onboarding/get-started.md'.
  • "Mostre-me o conteúdo do recurso de aprendizagem de integração do Azure Monitor em path 'onboarding/quickstart.md'."
  • Recuperar o conteúdo do ficheiro de recursos de aprendizagem do Azure Monitor no caminho 'samples/instrumentation-guide.html'.
  • "Lista todos os recursos de aprendizagem de integração do Azure Monitor."
  • Mostra-me todos os percursos de recursos de aprendizagem para instrumentação do Azure Monitor.
  • "Que recursos de aprendizagem estão disponíveis para a integração de instrumentação do Azure Monitor?"
Parâmetro Obrigatório ou opcional Description
Path Opcional Percurso de recursos 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 as ferramentas do Model Context Protocol (MCP) que instrumentam o Azure Monitor. Esta ferramenta analisa o espaço de trabalho e devolve a primeira ação para executar. Depois de executares a ação, chama orchestrator-next para continuar. Segue a ação no campo instruction à risca.

Exemplos de prompts incluem:

  • "Iniciar orquestração de instrumentação do Azure Monitor para o caminho do espaço de trabalho '/home/dev/workspace-monitoring'."
  • "Analisar o caminho do espaço de trabalho '/src/projects/my-app-workspace' e devolver a primeira etapa de instrumentação do Azure Monitor."
  • "Inicia a integração guiada do Azure Monitor para o projeto no caminho do workspace '/workspace/my-app' e dá-me o passo um."
Parâmetro Obrigatório ou opcional Description
Caminho do espaço de trabalho 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: Prosseguir orquestração

Faz a próxima ação de instrumentação depois de completares a atual.

Esta ferramenta faz parte do conjunto Model Context Protocol (MCP).

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

Fluxo de trabalho esperado:

  1. Receberás uma ação de orchestrator-start ou orchestrator-next.
  2. Executas o instruction campo exatamente.
  3. Executas esta ferramenta de forma concisa Completion note para obter a próxima ação.

Resultado: A próxima ação a executar, ou complete estado quando todos os passos são concluídos.

Exemplos de prompts incluem:

  • Depois de completar o passo anterior de instrumentação do Azure Monitor, obtenha a próxima ação para o ID da sessão 'session-abc123' e a nota de conclusão 'Adicionado UseAzureMonitor() ao Program.cs'.
  • Obtenha a próxima ação de integração para o ID da sessão 'workspace/session-2026' com a nota de conclusão 'Ran dotnet add package Microsoft.ApplicationInsights'.
  • "Após terminar o passo anterior de instrumentação, retorne o passo seguinte para o ID da sessão 'session-789xyz' com a nota de conclusão 'Atualizado appsettings.json para ativar o Application Insights'."
Parâmetro Obrigatório ou opcional Description
Nota de conclusão Obrigatório Uma frase que descreva o que executaste, por exemplo, 'Executei o comando dotnet add package' ou 'Adicionei o UseAzureMonitor() ao Program.cs'.
ID de sessão Obrigatório O caminho do espaço de trabalho é devolvido como sessionId do start do orquestrador.

Dicas de anotação da ferramenta:

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

Instrumentação: Enviar análise brownfield

Envia as conclusões da análise de brownfield code após orchestrator-start retornar o estado analysis_needed. Esta ferramenta faz parte do fluxo de trabalho Model Context Protocol (MCP). Deve escanear os ficheiros fonte do espaço de trabalho e preencher o modelo de análise antes de executar esta ferramenta. Depois que esta ferramenta tiver sucesso, continue com orchestrator-next.

Exemplos de prompts incluem:

  • Enviar as conclusões da análise de código brownfield em formato JSON '{"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' após ter sido solicitada a análise.
  • Continuar a orquestração da migração submetendo findings JSON '{"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'.
  • Enviar análise de telemetria brownfield concluída como conclusões JSON '{"serviceOptions":null,"initializers":null,"processors":null,"clientUsage":{"found":true},"sampling":{"found":false,"hasCustomSampling":false},"telemetryPipeline":null,"logging":{"found":true}}' para sessão de integração 'session-9f3b'.
Parâmetro Obrigatório ou opcional Description
Conclusões JSON Obrigatório Objeto JSON com resultados da análise de brownfield. Propriedades obrigatórias: serviceOptions (resultados das opções de serviço da análise da chamada AddApplicationInsightsTelemetry(), nulo se não encontrado), inicializadores (resultados do inicializador de telemetria ao analisar implementações ITelemetryInitializer ou IConfigureOptions<TelemetryConfiguration>, nulo se não encontrado), processadores (resultados do processador de telemetria ao analisar implementações ITelemetryProcessor, nulo se não encontrado), clienteUtilização (resultados da utilização direta do TelemetryClient da análise, nulo se não encontrado), amostragem (resultados de configuração de amostragem personalizada, nulo se não encontrado), telemetryPipeline (resultados de utilização personalizada do ITelemetryChannel ou TelemetrySinks, nulo se não encontrado), registo (registo explícito do fornecedor e filtro do logger, nulo se não encontrado). Para secções que não existem na base de código, passe um objeto padrão vazio, por exemplo found: false ou hasCustomSampling: false, em vez de null.
ID de sessão Obrigatório O caminho do espaço de trabalho foi retornado como sessionId de orchestrator-start.

Dicas de anotação da ferramenta:

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

Instrumentação: Seleção de melhoria a enviar

Submeta a seleção de melhorias do utilizador após o orchestrator-start devolver o estado enhancement_available. Apresente as opções de melhoria ao utilizador e depois ligue a esta ferramenta com as chaves de melhoria escolhidas. Pode selecionar múltiplas melhorias passando uma lista separada por vírgulas, por exemplo, redis,processors. Depois de esta ferramenta ter sido bem-sucedida, continue com orchestrator-next.

Exemplos de prompts incluem:

  • Submeter chaves de aperfeiçoamento 'redis,processors' para o ID de sessão de instrumentação do Azure Monitor 'workspaces/my-app/session-abc123'.
  • "Continuar o fluxo de melhoria da instrumentação enviando as chaves de melhoria 'redis' para o ID da sessão 'workspaces/prod-app/session-789'."
  • "Envie as chaves de melhoria escolhidas 'entityframework,otlp' para o ID da sessão de integração 'workspaces/onboard/session-456'."
Parâmetro Obrigatório ou opcional Description
Teclas de melhoria Obrigatório Uma ou mais chaves de realço, separadas por vírgulas (por exemplo, redis, redis,processors, entityframework,otlp).
ID de sessão Obrigatório O caminho do espaço de trabalho foi 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 em Azure Workbooks usando o Resource Graph para consultas rápidas de metadados. Esta ferramenta ajuda-o a descobrir, filtrar e contar livros de trabalho em diferentes âmbitos.

Devolve metadados do livro de trabalho, incluindo id, name, location, category, e carimbos temporais. Por defeito, não devolve o conteúdo completo do livro de exercícios (serializedData) — use a ferramenta mostrar para isso, ou defina Output format para full.

Por predefinição, a pesquisa direciona-se para os workbooks no seu contexto atual do Azure (entidade/subscrição). Pode usar Resource group para especificar explicitamente o seu âmbito de pesquisa. A ferramenta devolve por defeito a contagem total do lado do servidor. O máximo de resultados obtidos é 50, com um limite máximo de 1000; ajusta isto com Max results. Escolha Output format como summary para tokens mínimos ou full para resultado completo serializedData.

Exemplos de prompts incluem:

  • Mostra-me todos os livros de trabalho do grupo de recursos 'monitoring-rg'.
  • "Lista os cadernos partilhados no grupo de recursos 'prod-rg'."
  • "Que cadernos de trabalho foram modificados 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 âmbito da pesquisa.
Categoria Opcional Filtrar os livros de exercícios por categoria (por exemplo, workbook, sentinel, TSG). Se não for especificado, todas as categorias serão devolvidas.
Incluir a contagem total Opcional Inclua a contagem total de todos os cadernos de exercícios correspondentes na resposta (padrão: verdadeiro).
Kind Opcional Filtra os livros de exercícios por tipo (por exemplo, shared, user). Se não especificado, todos os tipos são devolvidos.
Resultados máximos Opcional Número máximo de resultados a devolver (padrão: 50, máximo: 1000).
Modificado depois Opcional Filtrar livros de exercícios modificados após esta data (formato ISO 8601, por exemplo, 2024-01-15).
Nome contém Opcional Filtrar cadernos de exercícios onde o nome de apresentação contém este texto (insensível a maiúsculas minúsculas).
Formato de saída Opcional Formato de saída: summary (apenas ID e nome, tokens mínimos), standard (metadados sem conteúdo, padrão), full (inclui serializedData).
ID de origem Opcional Filtra os livros de exercícios por ID de recurso de origem (por exemplo, /subscriptions/abc123/resourceGroups/prod/providers/Microsoft.Insights/components/myapp). Se não for especificado, todos os cadernos de exercícios são devolvidos.

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

Obtenha os detalhes completos do livro de trabalho através da API Azure Resource Manager (ARM), incluindo o conteúdo serializedData. Este comando permite-lhe obter a definição completa do workbook, incluindo o JSON de visualização.

Devolve propriedades completas do caderno de exercícios, serializedData, etiquetas e ETag. Pode fornecer vários Workbook IDs para operações em lote. O comando reporta falhas parciais em cadernos de exercícios individuais. Para melhor desempenho, primeiro use a ferramenta de lista para descobrir cadernos de exercícios e depois use exibir para cadernos de exercícios específicos.

Exemplos de prompts incluem:

  • Mostra-me os detalhes do livro de trabalho com o ID do 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-f2f2f2f2f2'.
Parâmetro Obrigatório ou opcional Description
IDs de cadernos Obrigatório Os IDs dos recursos do Azure das workbooks a recuperar. Suporta múltiplos valores para operações em lote.

Dicas de anotação da ferramenta:

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

Pastas de trabalho: Criar nova pasta de trabalho

Crie um novo livro de exercícios no grupo de recursos especificado e subscreva. Podes definir o nome de exibição e o conteúdo JSON serializado para o livro de exercícios. Este comando devolve a informação do caderno de exercícios criado após a conclusão bem-sucedida.

Exemplos de prompts incluem:

  • Crie um novo livro de trabalho chamado 'Performance Dashboard' no grupo de recursos 'monitoring-rg' com o conteúdo serializado para um notebook básico.
  • "Crie um livro de exercícios chamado 'Infrastructure Overview' no grupo de recursos 'prod-rg' com conteúdo a mostrar métricas de VM."
Parâmetro Obrigatório ou opcional Description
Nome de exibição Obrigatório O nome de exibição do livro de trabalho.
Grupo de recursos Obrigatório O nome do grupo de recursos Azure que contém o livro de exercícios.
Conteúdo serializado Obrigatório O conteúdo JSON serializado do livro de trabalho.
ID de origem Opcional O ID de recurso associado do livro de trabalho. Por padrão, isso é 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 um livro de trabalho existente do Azure adicionando novos passos, modificando o conteúdo ou alterando o nome de visualização. Esta ação devolve os detalhes atualizados do livro de trabalho. Precisas do ID do recurso do livro de trabalho e podes especificar um novo conteúdo serializado ou um novo nome de visualização.

Exemplos de prompts incluem:

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

Dicas de anotação da ferramenta:

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

Livros de trabalho: Eliminar livros de trabalho

Apague um ou mais livros ou folhas de cálculo pelos respetivos IDs de recursos do Azure. Este comando realiza uma eliminação suave dos cadernos de trabalho, mantendo-os durante 90 dias. Pode restaurá-los a partir do Contentor de Reciclagem através do portal Azure, se necessário.

Para operações em lote, pode fornecer múltiplos Workbook IDs valores. O comando reporta falhas parciais por caderno, garantindo que falhas individuais não afetam toda a operação em lote.

Para saber mais, consulte Gerir Azure Monitor cadernos de exercícios.

Exemplos de prompts incluem:

  • Apagar o livro com o ID do recurso '/subscriptions/abc123/resourceGroups/monitoring/providers/Microsoft.Insights/workbooks/a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1'.
  • "Remover os livros de exercícios com IDs de recursos '/subscriptions/xyz789/resourceGroups/prod-rg/providers/Microsoft. Insights/workbooks/b1b1b1b1-cccc-dddd-eeee-f2f2f2f2f2f2' e '/subscriptions/def456/resourceGroups/analytics-rg/providers/Microsoft. Insights/cadernos de exercícios/c2c2c2-dddd-eeee-ffff-a3a3a3a3a3'."
Parâmetro Obrigatório ou opcional Description
IDs de cadernos de exercícios Obrigatório Os IDs de recurso do Azure dos livros de trabalho para eliminar. Suporta múltiplos valores para operações em lote.

Dicas de anotação da ferramenta:

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

Conteúdo relacionado

  • Last updated on