herramientas del servidor MCP de Azure para Azure Monitor y Workbooks

El servidor de protocolo de contexto de modelo (MCP) de Azure proporciona la gestión de recursos de Azure Monitor y Workbooks mediante mensajes de lenguaje natural. Puede consultar los espacios de trabajo de Log Analytics, analizar datos operativos, monitorizar el estado de los recursos, recuperar métricas de rendimiento y administrar los cuadernos de Azure Monitor.

Azure Monitor le ayuda a maximizar la disponibilidad y el rendimiento de las aplicaciones y los servicios. Proporciona una solución completa para recopilar, analizar y actuar sobre la telemetría de los entornos locales y en la nube.

Workbooks (libros de trabajo) proporcionan un lienzo flexible para el análisis de datos y la creación de informes visuales completos en el portal de Azure. Permiten acceder a varios orígenes de datos desde Azure y combinarlos en experiencias interactivas unificadas. Los libros le permiten combinar varios tipos de visualizaciones y análisis, lo que los hace idóneos para la exploración de forma libre. Para obtener más información, consulte la documentación de cuadernos de Azure Monitor.

Nota:

parámetros Tool: las herramientas de servidor MCP de Azure definen parámetros para los datos que necesitan para completar tareas. Algunos de estos parámetros son específicos de cada herramienta y se documentan a continuación. Otros parámetros son globales y compartidos por todas las herramientas. Para obtener más información, consulte Parámetros de la herramienta.

Registro de actividad: Obtener registros de actividad

Enumera los registros de actividad de Azure Monitor para un recurso de Azure especificado durante un cierto número de horas previas. Esta herramienta le ayuda a comprender el historial de implementación de recursos, los cambios de configuración y los patrones de acceso. Devuelve eventos del registro de actividad que incluyen la marca de tiempo, el nombre de la operación, el estado y la información del autor de la llamada. Use los resultados para investigar implementaciones con errores, cambios inesperados o problemas de acceso.

Algunas indicaciones de ejemplo incluyen:

  • "Enumere los registros de actividad de las últimas 720 horas para el recurso "webapp-prod".
Parámetro Obligatorio u opcional Description
Nombre del recurso Obligatorio Nombre del recurso de Azure para el que se recuperarán los registros de actividad.
Nivel de evento Opcional Nivel de registros de actividad que se van a recuperar. Los niveles válidos son: Critical, Error, Informational, Verbose, . Warning Si no se proporciona, devuelve todos los niveles.
Hours Opcional Número de horas antes de ahora para recuperar los registros de actividad.
Tipo de recurso Opcional Tipo del recurso de Azure (por ejemplo, 'Microsoft.Storage/storageAccounts'). Proporcione esto solo si es necesario para desambiguar entre varios recursos con el mismo nombre.
Top (Principales) Opcional Número máximo de registros de actividad que se van a recuperar.

Sugerencias de anotación de herramientas:

Destructiva: ❌ | Idempotente: ✅ | Mundo Abierto: ❌ | Solo lectura: ✅ | Secreto: ❌ | Local requerido: ❌

Pruebas web: creación o actualización de pruebas web

Parte de las herramientas del Protocolo de contexto de modelo (MCP), esta herramienta crea o actualiza una prueba web estándar en Azure Monitor para comprobar la disponibilidad del punto de conexión. Especifique la configuración de supervisión, como la dirección URL, la frecuencia, las ubicaciones y las respuestas esperadas. Si la prueba no existe, esta herramienta la crea; de lo contrario, actualiza la prueba existente con la nueva configuración.

Algunas indicaciones de ejemplo incluyen:

  • Cree una prueba Web estándar nueva con el recurso webtest "webtest-prod-availability" en el grupo de recursos "rg-prod-monitoring" y asócielo al componente de AppInsights "/subscriptions/12345678-1234-1234-1234-123456789abc/resourceGroups/rg-ai/providers/microsoft.insights/components/appinsights-prod".
  • Actualizar una prueba web estándar existente para el recurso "webtest-prod-availability" en el grupo de recursos "rg-prod-monitoring" para vincularlo al componente de AppInsights "/subscriptions/12345678-1234-1234-1234-123456789abc/resourceGroups/rg-ai/providers/microsoft.insights/components/appinsights-prod".
Parámetro Obligatorio u opcional Description
Grupo de recursos Obligatorio Nombre del grupo de recursos de Azure.
Recurso Webtest Obligatorio Nombre del recurso de prueba web en el que se va a operar.
Componente de Appinsights Opcional Identificador de recurso del componente de Application Insights que se va a asociar a la prueba web.
Descripción Opcional Una breve descripción de la prueba web.
Enabled Opcional Indica si la prueba web está habilitada.
Código de estado esperado Opcional Código de estado HTTP esperado.
Seguir redireccionamientos Opcional Indica si se deben seguir las redirecciones HTTP.
Frecuencia Opcional Frecuencia de prueba en segundos. Valores admitidos: 300, 600, 900.
Headers Opcional Encabezados HTTP que se van a incluir en la solicitud, como pares KEY=VALUE separados por comas.
Verbo HTTP Opcional Método HTTP que se va a usar, por ejemplo, get o post.
Omitir el código de estado Opcional Si se debe ignorar la validación del código de estado.
Ubicación Opcional Ubicación donde se crea el recurso de prueba web. Esto debe coincidir con la ubicación del componente de Application Insights.
Análisis de solicitudes Opcional Si se deben analizar las solicitudes dependientes.
Cuerpo de la solicitud Opcional Cuerpo que se va a enviar con la solicitud.
URL de solicitud Opcional URL absoluta para probar.
Reintento habilitado Opcional Si los reintentos están habilitados.
Comprobación de SSL Opcional Si se van a validar certificados SSL.
Comprobación de duración de SSL Opcional Número de días para comprobar la vigencia del certificado SSL.
Tiempo de espera Opcional Tiempo de espera de la solicitud en segundos. Valores admitidos: 30, 60, 90, 120.
Nombre de prueba web Opcional Nombre de la prueba dentro del recurso de prueba web.
Ubicaciones de prueba web Opcional Lista separada por comas de ubicaciones desde las que ejecutar la prueba. Location hace referencia a la etiqueta de población geográfica para las pruebas de disponibilidad.

Sugerencias de anotación de herramientas:

Destructiva: ✅ | Idempotente: ✅ | Mundo Abierto: ❌ | Solo lectura: ❌ | Secreto: ❌ | Local requerido: ❌

Pruebas web: Obtener prueba web

Esta herramienta obtiene detalles de una prueba web específica o enumera todas las pruebas web. Al especificar el recurso Webtest, esta herramienta devuelve información detallada para esa prueba web. Cuando no especifica el recurso Webtest, esta herramienta devuelve una lista de todas las pruebas web de la suscripción y puede filtrar la lista por grupo de recursos.

Algunas indicaciones de ejemplo incluyen:

  • "Obtenga los detalles de la prueba web para el recurso "webtest-prod" en mi suscripción en el grupo de recursos "rg-monitoring".
  • "Enumerar todos los recursos de prueba web en mi suscripción".
  • "Enumere todos los recursos de prueba web de mi suscripción en el grupo de recursos "rg-prod".
Parámetro Obligatorio u opcional Description
Recurso Webtest Opcional Nombre del recurso de prueba web en el que se va a operar.

Sugerencias de anotación de herramientas:

Destructiva: ❌ | Idempotente: ✅ | Mundo Abierto: ❌ | Solo lectura: ✅ | Secreto: ❌ | Local requerido: ❌

Log Analytics: Enumerar áreas de trabajo

Esta herramienta enumera los espacios de trabajo de Log Analytics de una suscripción. Recupera el nombre, el identificador, la ubicación y otras propiedades clave de cada área de trabajo. Puede usarlo para identificar áreas de trabajo antes de consultar sus registros o examinar la configuración del área de trabajo.

Algunas indicaciones de ejemplo incluyen:

  • "Enumerar Log Analytics áreas de trabajo en mi suscripción".
  • "Mostrar mis áreas de trabajo de Log Analytics."
  • "Obtenga las áreas de trabajo de Log Analytics en mi suscripción".

Sugerencias de anotación de herramientas:

Destructiva: ❌ | Idempotente: ✅ | Mundo Abierto: ❌ | Solo lectura: ✅ | Secreto: ❌ | Local requerido: ❌

Log Analytics: Listar tablas

Esta herramienta enumera todas las tablas de un área de trabajo de Log Analytics. Por ejemplo, enumere las tablas del área de trabajo "prod-law" del grupo de recursos "rg-monitoring" para obtener una vista previa de las columnas y los tipos de datos disponibles. Devuelve nombres de tabla y esquemas que se usan para compilar consultas del lenguaje de consulta kusto (KQL). Puede filtrar por tipo de tabla, por ejemplo CustomLog o AzureMetrics.

Algunas indicaciones de ejemplo incluyen:

  • Enumere todas las tablas en el área de trabajo de Log Analytics «prod-law» del tipo «CustomLog» de tabla en el grupo de recursos «rg-prod».
  • Mostrar tablas del tipo 'AzureMetrics' para el área de trabajo 'f1b2c3d4-5678-90ab-cdef-1234567890ab' en el grupo de recursos 'rg-monitoring'.
Parámetro Obligatorio u opcional Description
Nombre del espacio de trabajo Opcional Identificador o nombre del área de trabajo de Log Analytics. Puede ser el identificador único (GUID) o el nombre para mostrar del espacio de trabajo.

Sugerencias de anotación de herramientas:

Destructiva: ❌ | Idempotente: ✅ | Mundo Abierto: ❌ | Solo lectura: ✅ | Secreto: ❌ | Local requerido: ❌

Log Analytics: Obtener los tipos de tabla

Esta herramienta protocolo de contexto de modelo (MCP) enumera los tipos de tabla disponibles en un área de trabajo de Azure Log Analytics. Devuelve los nombres de los tipos de tabla. Puede usar esos nombres al escribir consultas en registros de Azure Monitor.

Algunas indicaciones de ejemplo incluyen:

  • "Enumere todos los tipos de tabla disponibles en Log Analytics nombre del área de trabajo "prod-law-01" en el grupo de recursos "rg-prod".
  • "¿Qué tipos de tabla están disponibles en Log Analytics nombre del área de trabajo "analytics-workspace" en el grupo de recursos "rg-logs"?"
Parámetro Obligatorio u opcional Description
Grupo de recursos Obligatorio Nombre del grupo de recursos Azure que contiene el área de trabajo.
Nombre del espacio de trabajo Obligatorio Nombre o identificador del área de trabajo de Log Analytics. Puede usar el GUID del área de trabajo o el nombre visible.

Sugerencias de anotación de herramientas:

Destructiva: ❌ | Idempotente: ✅ | Mundo Abierto: ❌ | Solo lectura: ✅ | Secreto: ❌ | Local requerido: ❌

Log Analytics: Consultar registros del espacio de trabajo

Consulta de registros en todo un área de trabajo de Log Analytics mediante el lenguaje de consulta Kusto (KQL). Esta herramienta ejecuta consultas en todo el área de trabajo que devuelven registros en todos los recursos y tablas del área de trabajo. Esta herramienta forma parte de las herramientas del Protocolo de contexto de modelo (MCP). Por ejemplo, puede preguntar: "mostrar todos los errores en mi área de trabajo", "qué ha ocurrido en mi área de trabajo en las últimas 24 horas", "enumerar las solicitudes con error en el área de trabajo".

Algunas indicaciones de ejemplo incluyen:

  • Mostrar registros con la consulta «errores» de la tabla «Syslog» en el área de trabajo de Log Analytics «my-workspace» en el grupo de recursos «rg-prod».
Parámetro Obligatorio u opcional Description
Query Obligatorio Consulta del lenguaje de consulta kusto (KQL) que se ejecutará en el área de trabajo de Log Analytics. Puede usar consultas predefinidas por nombre: recent muestra los registros más recientes ordenados por TimeGenerated; errors muestra los registros de nivel de error ordenados por TimeGenerated. O bien, proporcione una consulta KQL personalizada.
Grupo de recursos Obligatorio Nombre del grupo de recursos Azure que contiene el área de trabajo.
Nombre de la tabla Obligatorio Nombre de la tabla que se va a consultar en el área de trabajo.
Nombre del espacio de trabajo Obligatorio Identificador o nombre del área de trabajo de Log Analytics. Puede proporcionar el identificador único global (GUID) o el nombre para mostrar del espacio de trabajo.
Hours Opcional Número de horas a consultar desde ahora.
Limit Opcional El número máximo de resultados que se devolverán.

Sugerencias de anotación de herramientas:

Destructiva: ❌ | Idempotente: ✅ | Mundo Abierto: ❌ | Solo lectura: ✅ | Secreto: ❌ | Local requerido: ❌

Log Analytics: Realizar consultas en registros de recursos

Consultar registros de actividad y diagnóstico para un recurso de Azure específico en un área de trabajo de Log Analytics mediante el lenguaje de consulta kusto (KQL). Esta herramienta filtra los resultados del recurso especificado y ejecuta la consulta KQL proporcionada en la tabla elegida. Por ejemplo, pida «mostrar registros para el recurso "app-monitor" durante las últimas 24 horas».

Algunas indicaciones de ejemplo incluyen:

  • Mostrar registros con la consulta 'recent' para el identificador de recurso '/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/rg-prod/providers/Microsoft.Compute/virtualMachines/my-vm' en la tabla 'AzureDiagnostics'.
Parámetro Obligatorio u opcional Description
Query Obligatorio La consulta KQL a ejecutar en el área de trabajo de Log Analytics. Puede usar consultas predefinidas por nombre: recent muestra los registros más recientes ordenados por TimeGenerated; errors muestra los registros de nivel de error ordenados por TimeGenerated. De lo contrario, proporcione una consulta KQL personalizada.
Identificador del recurso Obligatorio Identificador de recurso de Azure del recurso que se va a consultar. Ejemplo: /subscriptions/<sub>/resourceGroups/<rg>/providers/Microsoft.OperationalInsights/workspaces/<ws>.
Nombre de la tabla Obligatorio Nombre de la tabla que se va a consultar en el área de trabajo.
Hours Opcional Número de horas a consultar desde ahora.
Limit Opcional El número máximo de resultados que se devolverán.

Sugerencias de anotación de herramientas:

Destructiva: ❌ | Idempotente: ✅ | Mundo Abierto: ❌ | Solo lectura: ✅ | Secreto: ❌ | Local requerido: ❌

Salud: Obtener la salud de la entidad

Esta herramienta recupera el estado de salud y los eventos de salud recientes de una entidad específica en un modelo de estado de Azure Monitor. La herramienta Protocolo de Contexto del Modelo (MCP) informa sobre la salud de la aplicación en función de modelos de salud personalizados, no de la disponibilidad básica de los recursos. Para obtener disponibilidad básica de recursos, use Azure Resource Health o la herramienta azmcp_resourcehealth_availability-status_get. Para consultar registros en un área de trabajo de Log Analytics, use azmcp_monitor_workspace_log_query. Para consultar los registros de un recurso de Azure específico, use azmcp_monitor_resource_log_query.

Algunas indicaciones de ejemplo incluyen:

  • Muéstrame el estado de salud de la entidad "order-service" mediante el modelo de salud "app-health-v1" en el grupo de recursos "rg-prod".
Parámetro Obligatorio u opcional Description
Nombre de la entidad Obligatorio Entidad para la que se va a obtener el estado de salud.
Modelo de salud Obligatorio Nombre del modelo de salud para el que se va a obtener el estado de salud.
Grupo de recursos Obligatorio Nombre del grupo de recursos de Azure. Este grupo de recursos es un contenedor lógico para Azure recursos.

Sugerencias de anotación de herramientas:

Destructiva: ❌ | Idempotente: ✅ | Mundo Abierto: ❌ | Solo lectura: ✅ | Secreto: ❌ | Local requerido: ❌

Métricas: Métricas de consulta

Consulta las métricas de Azure Monitor de un recurso. Esta herramienta devuelve datos de serie temporal para las métricas especificadas, lo que le ayuda a analizar el rendimiento y la disponibilidad de los recursos. Esta herramienta forma parte de las herramientas del Protocolo de contexto de modelo (MCP).

Algunas indicaciones de ejemplo incluyen:

  • "Analice las tendencias de rendimiento y los tiempos de respuesta del recurso de Application Insights "appinsights-prod" con las métricas "requests/duration" y el espacio de nombres de métrica "microsoft.insights/components".
  • "Compruebe la métrica de disponibilidad "availabilityResults/availabilityPercentage" para el recurso de Application Insights "appinsights-staging" mediante el espacio de nombres de métrica "microsoft.insights/components"?"
  • Obtenga la métrica "requests/duration" con la agregación "Promedio" y el intervalo "PT1M" para el recurso "appinsights-prod" mediante el espacio de nombres de métrica "microsoft.insights/components".
  • Investigue las tasas de errores y las solicitudes fallidas para el recurso de Application Insights "appinsights-prod" mediante las métricas "requests/failed,exceptions/count" y el espacio de nombres de métrica "microsoft.insights/components".
  • Realice una consulta sobre la métrica "requests/count" para el tipo de recurso "Microsoft.Insights/components" recurso "appinsights-qa" con el espacio de nombres de métrica "microsoft.insights/components" y el intervalo "PT5M".
  • ¿Cuál es la tasa de solicitudes por segundo utilizando la métrica "requests/count" con la agregación "Count" para el recurso de Application Insights "appinsights-prod" y el namespace de métricas "microsoft.insights/components"?
Parámetro Obligatorio u opcional Description
Nombres de métricas Obligatorio Nombres de métricas que se van a consultar, separados por comas.
Espacio de nombres de métricas Obligatorio Espacio de nombres de métrica que se va a consultar. Obtenga este valor de la herramienta azmcp-monitor-metrics-definitions.
Nombre del recurso Obligatorio Nombre del recurso de Azure para el que se van a consultar las métricas.
Agregación Opcional Tipo de agregación que se va a usar, como Average, Maximum, Minimum, Total o Count.
Hora de finalización Opcional Hora de finalización de la consulta en formato ISO (por ejemplo, 2023-01-01T00:00:00Z). El valor predeterminado es ahora.
Filter Opcional Filtro OData que se va a aplicar a la consulta de métricas.
Intervalo Opcional Intervalo de tiempo para los puntos de datos (por ejemplo, PT1H durante 1 hora, PT5M durante 5 minutos).
Número máximo de compartimientos Opcional Número máximo de depósitos de tiempo que se van a devolver. El valor predeterminado es 50.
Tipo de recurso Opcional Tipo de recurso Azure (por ejemplo, Microsoft.Storage/storageAccounts, Microsoft.Compute/virtualMachines). Si no se especifica, la herramienta intenta deducir el tipo del nombre del recurso.
Hora de inicio Opcional Hora de inicio de la consulta en formato ISO (por ejemplo, 2023-01-01T00:00:00Z). El valor predeterminado es hace 24 horas.

Sugerencias de anotación de herramientas:

Destructiva: ❌ | Idempotente: ✅ | Mundo Abierto: ❌ | Solo lectura: ✅ | Secreto: ❌ | Local requerido: ❌

Métricas: Enumerar definiciones de métricas

Esta herramienta enumera las definiciones de métricas de un recurso de Azure. Devuelve metadatos sobre cada métrica, incluidos los espacios de nombres, las descripciones y los tipos de agregación, por lo que puede determinar qué métricas se van a consultar para un recurso.

Algunas indicaciones de ejemplo incluyen:

  • "Obtenga definiciones de métricas para el nombre de recurso "app-insights-prod".
  • "Enumere las definiciones de métricas para el nombre de recurso "mystorageacct" con el tipo de recurso "Microsoft. Storage/storageAccounts' y el espacio de nombres de métrica 'Storage'".
  • "Mostrar definiciones de métricas para el nombre de recurso "vm-prod-01" con la cadena de búsqueda "cpu" y el límite "20".
Parámetro Obligatorio u opcional Description
Nombre del recurso Obligatorio Nombre del recurso de Azure para el que se van a consultar las métricas.
Limit Opcional Número máximo de definiciones de métricas que se van a devolver. El valor predeterminado es 10.
Espacio de nombres de métricas Opcional Espacio de nombres de métrica que se va a consultar. Obtenga este valor de la herramienta azmcp-monitor-metrics-definitions.
Tipo de recurso Opcional Tipo de recurso Azure (por ejemplo, Microsoft.Storage/storageAccounts, Microsoft.Compute/virtualMachines). Si no lo especifica, la herramienta intenta deducir el tipo de recurso del nombre del recurso.
Cadena de búsqueda Opcional Cadena para filtrar las definiciones de métricas. El filtro realiza la coincidencia sin distinción entre mayúsculas y minúsculas en el nombre y la descripción de la métrica.

Sugerencias de anotación de herramientas:

Destructiva: ❌ | Idempotente: ✅ | Mundo Abierto: ❌ | Solo lectura: ✅ | Secreto: ❌ | Local requerido: ❌

Instrumentación: obtención de recursos de aprendizaje

Esta herramienta enumera todos los recursos de aprendizaje disponibles para la instrumentación de Azure Monitor, o recupera el contenido de un recurso específico por su ruta de acceso. De forma predeterminada, la herramienta devuelve todas las rutas de acceso de recursos. Si especifica una ruta de acceso, la herramienta devuelve el contenido completo del recurso. Para instrumentar una aplicación, use la herramienta orchestrator-start.

Algunas indicaciones de ejemplo incluyen:

  • Obtenga el recurso de aprendizaje de incorporación en la ruta "onboarding/get-started.md".
  • "Muéstrame el contenido del recurso de aprendizaje de incorporación de Azure Monitor en la ruta de acceso "onboarding/quickstart.md".
  • "Recupere el contenido del archivo de recursos de aprendizaje de Azure Monitor en la ruta de acceso "samples/instrumentation-guide.html"".
  • Enumera todos los recursos de aprendizaje de incorporación de Azure Monitor.
  • Mostrarme todas las rutas de aprendizaje de recursos de instrumentación de Azure Monitor.
  • "¿Qué recursos de aprendizaje están disponibles para la incorporación de instrumentación Azure Monitor?"
Parámetro Obligatorio u opcional Description
Camino Opcional Ruta de acceso del recurso de aprendizaje.

Sugerencias de anotación de herramientas:

Destructiva: ❌ | Idempotente: ✅ | Mundo Abierto: ❌ | Solo lectura: ✅ | Secreto: ❌ | Local requerido: ✅

Instrumentación: Iniciar orquestación

Empieza aquí para acceder a las herramientas del Protocolo de Contexto de Modelo (MCP) que instrumentan Azure Monitor. Esta herramienta analiza el área de trabajo y devuelve la primera acción que se va a ejecutar. Después de ejecutar la acción, llame a orchestrator-next para continuar. Siga la acción en el instruction campo exactamente.

Algunas indicaciones de ejemplo incluyen:

  • Iniciar la orquestación de instrumentación de Azure Monitor para el directorio de trabajo "/home/dev/workspace-monitoring".
  • Analizar la ruta de trabajo «/src/projects/my-app-workspace» y devolver el primer paso de instrumentación de Azure Monitor.
  • Inicie el proceso guiado de incorporación a Azure Monitor para el proyecto en la ruta de acceso del área de trabajo «/workspace/my-app» y deme el paso uno.
Parámetro Obligatorio u opcional Description
Ruta de acceso del área de trabajo Obligatorio Ruta de acceso absoluta a la carpeta del área de trabajo.

Sugerencias de anotación de herramientas:

Destructiva: ❌ | Idempotente: ❌ | Mundo Abierto: ❌ | Solo lectura: ❌ | Secreto: ❌ | Local requerido: ✅

Instrumentación: Continuar con la orquestación

Obtenga la próxima acción de instrumentación una vez que complete la actual.

Esta herramienta forma parte del conjunto de protocolos de contexto de modelos (MCP).

Después de ejecutar instruction tal como en la respuesta anterior, ejecute esta herramienta para recibir la siguiente acción.

Flujo de trabajo esperado:

  1. Recibirá una acción de "orchestrator-start" o "orchestrator-next".
  2. Ejecute el campo instruction exactamente.
  3. Ejecute esta herramienta con un Completion note conciso para obtener la siguiente acción.

Devuelve: la siguiente acción que se va a ejecutar o complete el estado cuando se realizan todos los pasos.

Algunas indicaciones de ejemplo incluyen:

  • "Después de completar el paso anterior de instrumentación de Azure Monitor, obtenga la siguiente acción para el identificador de sesión "session-abc123" con la nota de finalización "Se ha agregado UseAzureMonitor() a Program.cs".
  • "Obtenga la siguiente acción de incorporación para el identificador de sesión "workspace/session-2026" con la nota de finalización "Ran dotnet add package Microsoft. ApplicationInsights'."
  • "Después de finalizar el paso de instrumentación anterior, devuelva el siguiente paso para el identificador de sesión "session-789xyz" con la nota de finalización "Actualizado appsettings.json para habilitar Application Insights".
Parámetro Obligatorio u opcional Description
Nota de finalización Obligatorio Una frase que describe lo que ejecutaste, por ejemplo, 'Ejecutaste el comando dotnet add package' o 'Añadiste UseAzureMonitor() a Program.cs'.
Id. de sesión Obligatorio La ruta de acceso del área de trabajo se devuelve como sessionId, desde orchestrator-start.

Sugerencias de anotación de herramientas:

Destructiva: ❌ | Idempotente: ❌ | Mundo Abierto: ❌ | Solo lectura: ❌ | Secreto: ❌ | Local requerido: ✅

Instrumentación: envío de análisis de sitios en desuso

Envía resultados del análisis de código brownfield una vez que orchestrator-start devuelve el estado analysis_needed. Esta herramienta forma parte del flujo de trabajo del Protocolo de contexto de modelo (MCP). Debe examinar los archivos de origen del área de trabajo y rellenar la plantilla de análisis antes de utilizar esta herramienta. Una vez que esta herramienta funcione correctamente, continúe con orchestrator-next.

Algunas indicaciones de ejemplo incluyen:

  • Enviar el archivo JSON de los hallazgos del análisis de código brownfield '{"serviceOptions":null,"initializers":null,"processors":null,"clientUsage":null,"sampling":{"found":false,"hasCustomSampling":false},"telemetryPipeline":null,"logging":null}' a la sesión de instrumentación de Azure Monitor 'workspace-7a3b' tras solicitar el análisis.
  • Continuar con la orquestación de la migración enviando el JSON '{"serviceOptions":{"found":true,"details":"AddApplicationInsightsTelemetry used"},"initializers":[],"processors":[],"clientUsage":null,"sampling":{"found":false,"hasCustomSampling":false},"telemetryPipeline":null,"logging":null}' a la sesión 'sess-01234'.
  • Enviar el análisis de telemetría de brownfield completado como resultados JSON '{"serviceOptions":null,"initializers":null,"processors":null,"clientUsage":{"found":true},"sampling":{"found":false,"hasCustomSampling":false},"telemetryPipeline":null,"logging":{"found":true}}' como parte de la sesión de incorporación 'session-9f3b'.
Parámetro Obligatorio u opcional Description
Resultados JSON Obligatorio Objeto JSON con resultados del análisis de brownfield. Propiedades necesarias: serviceOptions (resultados de opciones de servicio del análisis de la llamada AddApplicationInsightsTelemetry(), null si no se encuentra), inicializadores (resultados del inicializador de telemetría derivados del análisis de las implementaciones de ITelemetryInitializer o IConfigureOptions<TelemetryConfiguration>, null si no se encuentra ninguno), procesadores (resultados del procesador de telemetría del análisis de implementaciones de ITelemetryProcessor, null si no se encuentra ninguno), clientUsage (resultados de uso de TelemetryClient provenientes del análisis directo del uso de TelemetryClient, null si no se encuentra), muestreo (resultados de configuración de muestreo personalizado, null si no hay un muestreo personalizado), telemetryPipeline (resultados de uso de ITelemetryChannel personalizado o TelemetrySinks, null si no se encuentra), registro (resultados de proveedor de logger explícito y filtros, null si no se encuentra). Para las secciones que no existen en el código base, pase un objeto predeterminado vacío, por ejemplo, encontrado: false o hasCustomSampling: false, en lugar de null.
Id. de sesión Obligatorio La ruta de acceso del área de trabajo se ha devuelto como sessionId desde orchestrator-start.

Sugerencias de anotación de herramientas:

Destructiva: ❌ | Idempotente: ❌ | Mundo Abierto: ❌ | Solo lectura: ❌ | Secreto: ❌ | Local requerido: ✅

Instrumentación: Enviar selección de optimización

Envíe la selección de mejora del usuario después de que orchestrator-start devuelva el estado enhancement_available. Presente las opciones de mejora al usuario y, a continuación, llame a esta herramienta con las claves de mejora elegidas. Puede seleccionar varias mejoras pasando una lista separada por comas, por ejemplo, redis,processors. Después de que esta herramienta tenga éxito, continúe con orchestrator-next.

Algunas indicaciones de ejemplo incluyen:

  • Enviar claves de mejora 'redis, processors' para el identificador de sesión de instrumentación de Azure Monitor, 'workspaces/my-app/session-abc123'.
  • "Continúe el flujo de mejora de instrumentación mediante el envío de claves de mejora "redis" al identificador de sesión "workspaces/prod-app/session-789".
  • Enviar las claves de mejora seleccionadas 'entityframework,otlp' para la sesión de incorporación con ID 'workspaces/onboard/session-456'.
Parámetro Obligatorio u opcional Description
Claves de mejora Obligatorio Una o varias claves de mejora, separadas por comas (por ejemplo, redis, redis,processors, entityframework,otlp).
Id. de sesión Obligatorio La ruta de acceso del área de trabajo se ha devuelto como sessionId desde orchestrator-start.

Sugerencias de anotación de herramientas:

Destructiva: ❌ | Idempotente: ❌ | Mundo Abierto: ❌ | Solo lectura: ❌ | Secreto: ❌ | Local requerido: ✅

Libros: Enumerar libros

Busque los Workbooks de Azure con Resource Graph para realizar consultas rápidas de metadatos. Esta herramienta le ayuda a descubrir, filtrar y contar libros de trabajo a través de distintos ámbitos.

Devuelve metadatos del libro, incluidas id, name, location, category y las marcas de tiempo. De forma predeterminada, no devuelve el contenido completo del libro (serializedData): use la herramienta show para hacerlo o establezca Output format en full.

De forma predeterminada, la búsqueda se dirige a los libros de trabajo en el contexto actual de Azure (suscripción del inquilino). Puede usar Resource group para especificar explícitamente el ámbito de búsqueda. La herramienta devuelve el recuento total del lado servidor de forma predeterminada. Los resultados máximos devueltos son 50, con un límite máximo de 1000; ajuste esto con Max results. Elija Output format como summary para tokens mínimos o full como salida serializedData completa.

Algunas indicaciones de ejemplo incluyen:

  • Mostrar todos los libros de trabajo en el grupo de recursos «monitoring-rg».
  • "Enumere los libros compartidos en el grupo de recursos "prod-rg".
  • ¿Qué libros de trabajo se modificaron en el grupo de recursos «analytics-rg» después de 2024-01-15?
Parámetro Obligatorio u opcional Description
Grupo de recursos Opcional Nombre del grupo de recursos de Azure para delimitar la búsqueda.
Categoría Opcional Filtre los libros de trabajo por categoría (por ejemplo, workbook, sentinel, TSG). Si no se especifica, se devuelven todas las categorías.
Incluir recuento total Opcional Incluya el recuento total de todos los libros coincidentes en la respuesta (valor predeterminado: true).
Kind Opcional Filtre los libros de trabajo por tipo (por ejemplo, shared, user). Si no se especifica, se devuelven todos los tipos.
Número máximo de resultados Opcional Número máximo de resultados que se van a devolver (valor predeterminado: 50, máximo: 1000).
Modificado después de Opcional Filtre los libros de trabajo modificados después de esta fecha (formato ISO 8601, por ejemplo, 2024-01-15).
El nombre contiene Opcional Filtrar libros en los que el nombre para mostrar contenga este texto (sin distinción entre mayúsculas y minúsculas).
Formato de salida Opcional Formato de salida: summary (identificador y nombre solo, tokens mínimos), standard (metadatos sin contenido, valor predeterminado), full (incluye serializedData).
Id. de origen Opcional Filtre los libros de trabajo por identificador de recurso de origen (por ejemplo, /subscriptions/abc123/resourceGroups/prod/providers/Microsoft.Insights/components/myapp). Si no se especifica, se devuelven todos los libros.

Sugerencias de anotación de herramientas:

Destructiva: ❌ | Idempotente: ✅ | Mundo Abierto: ❌ | Solo lectura: ✅ | Secreto: ❌ | Local requerido: ❌

Libros de trabajo: Mostrar detalles del libro de trabajo

Recupere los detalles completos del libro a través de la API de Azure Resource Manager (ARM), incluido el contenido de serializedData. Este comando le permite obtener la definición completa del libro de trabajo, incluido el JSON de la visualización.

Devuelve las propiedades completas del libro de trabajo, serializedData, etiquetas y ETag. Puede proporcionar varios Workbook IDs para las operaciones por lotes. El comando notifica errores parciales para libros de trabajo individuales. Para mejorar el rendimiento, use primero la herramienta lista para descubrir libros, y luego use la función 'mostrar' para ver libros específicos.

Algunas indicaciones de ejemplo incluyen:

  • Muéstrame los detalles del libro de trabajo con el identificador de recurso '/subscriptions/abc123/resourceGroups/monitoring/providers/Microsoft.Insights/workbooks/a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1'.
  • Obtenga la definición completa del libro de trabajo '/subscriptions/xyz789/resourceGroups/prod-rg/providers/Microsoft.Insights/workbooks/b1b1b1b1-cccc-dddd-eeee-f2f2f2f2f2f2'.
Parámetro Obligatorio u opcional Description
Identificadores de libros de trabajo Obligatorio ID de recursos de Azure de los libros de trabajo a recuperar. Admite varios valores para las operaciones por lotes.

Sugerencias de anotación de herramientas:

Destructiva: ❌ | Idempotente: ✅ | Mundo Abierto: ❌ | Solo lectura: ✅ | Secreto: ❌ | Local requerido: ❌

Libros: Crear libro

Cree un nuevo cuaderno en el grupo de recursos y la suscripción especificados. Puede establecer el nombre visible y el contenido JSON serializado del libro de trabajo. Al completarse con éxito, este comando devuelve la información del libro creado.

Algunas indicaciones de ejemplo incluyen:

  • Cree un nuevo libro de trabajo denominado 'Panel de rendimiento' en el grupo de recursos 'monitoring-rg' con el contenido serializado de un notebook básico.
  • "Cree un libro denominado "Información general de infraestructura" en el grupo de recursos "prod-rg" con contenido que muestre las métricas de máquina virtual".
Parámetro Obligatorio u opcional Description
Nombre para mostrar Obligatorio Nombre visible del libro de trabajo.
Grupo de recursos Obligatorio Nombre del grupo de recursos Azure que contiene el libro.
Contenido serializado Obligatorio Contenido JSON serializado del libro de trabajo.
Id. de origen Opcional Identificador del recurso vinculado para el libro. De manera predeterminada, será azure monitor.

Sugerencias de anotación de herramientas:

Destructiva: ✅ | Idempotente: ❌ | Mundo Abierto: ❌ | Solo lectura: ❌ | Secreto: ❌ | Local requerido: ❌

Hojas de cálculo: Actualizar hoja de cálculo

Actualice las propiedades de un cuaderno de Azure existente mediante la adición de nuevos pasos, la modificación del contenido o el cambio del nombre de visualización. Esta acción devuelve los detalles actualizados del libro de trabajo. Necesita el ID de recurso del libro de trabajo y puede especificar contenido serializado nuevo o un nuevo nombre de visualización.

Algunas indicaciones de ejemplo incluyen:

  • Actualice el libro '/subscriptions/abc123/resourceGroups/monitoring-rg/providers/Microsoft.Insights/workbooks/a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1' con el nombre para mostrar "Informe mensual".
  • "Cambie el contenido serializado del libro '/subscriptions/xyz789/resourceGroups/prod-rg/providers/Microsoft.Insights/workbooks/b1b1b1b1-cccc-dddd-eeee-f2f2f2f2f2f2' para incluir un nuevo gráfico de métricas."
Parámetro Obligatorio u opcional Description
ID del cuaderno Obligatorio El identificador de recurso de Azure del cuaderno de trabajo que se va a actualizar.
Nombre para mostrar Opcional Nombre visible del libro de trabajo.
Contenido serializado Opcional Contenido serializado JSON del libro de trabajo.

Sugerencias de anotación de herramientas:

Destructiva: ✅ | Idempotente: ✅ | Mundo Abierto: ❌ | Solo lectura: ❌ | Secreto: ❌ | Local requerido: ❌

Libros de trabajo: Eliminar libros de trabajo

Elimine uno o varios libros de trabajo por sus identificadores de recursos de Azure. Este comando realiza una eliminación suave en libros de trabajo, reteniéndolos durante 90 días. Puede restaurarlos desde la Papelera de reciclaje a través del portal de Azure si es necesario.

En el caso de las operaciones por lotes, puede proporcionar varios Workbook IDs valores. El comando informa de fallos parciales por cada libro de trabajo, asegurando que los fallos individuales no afecten a la operación de todo el lote.

Para más detalles, consulte Administrar Azure Monitor workbooks.

Algunas indicaciones de ejemplo incluyen:

  • Elimine el libro con el identificador de recurso '/subscriptions/abc123/resourceGroups/monitoring/providers/Microsoft.Insights/workbooks/a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1'.
  • Quite los libros de trabajo con identificadores de recursos "/subscriptions/xyz789/resourceGroups/prod-rg/providers/Microsoft.Insights/workbooks/b1b1b1b1-cccc-dddd-eeee-f2f2f2f2f2f2" y "/subscriptions/def456/resourceGroups/analytics-rg/providers/Microsoft.Insights/workbooks/c2c2c2c2-dddd-eeee-ffff-a3a3a3a3a3a3".
Parámetro Obligatorio u opcional Description
Identificadores de libros de trabajo Obligatorio Los identificadores de recursos de Azure de los libros de trabajo que se van a eliminar. Admite varios valores para las operaciones por lotes.

Sugerencias de anotación de herramientas:

Destructiva: ✅ | Idempotente: ✅ | Mundo Abierto: ❌ | Solo lectura: ❌ | Secreto: ❌ | Local requerido: ❌