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 espacios de trabajo de Log Analytics, analizar datos operativos, supervisar el estado de los recursos, recuperar métricas de rendimiento, administrar pruebas web de disponibilidad, orquestar flujos de trabajo de instrumentación y administrar 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.

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".

Sugerencias de anotación de herramientas:

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".

Sugerencias de anotación de herramientas:

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:

• Obtener detalles de la prueba web para el recurso de prueba web “webtest-prod” de mi suscripción en el grupo de recursos “rg-monitoring”.
• Mostrar todos los recursos de prueba web de mi suscripción.
• "Enumere todos los recursos de prueba web de mi suscripción en el grupo de recursos "rg-prod".

Sugerencias de anotación de herramientas:

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:

• Mostrar los área de trabajo de Log Analytics de 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:

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:

• Mostrar todas las tablas del espacio de trabajo de Log Analytics “prod-law” del tipo de tabla “CustomLog” en el grupo de recursos “rg-prod”.
• Muéstrame las tablas del tipo “AzureMetrics” del espacio de trabajo “f1b2c3d4-5678-90ab-cdef-1234567890ab” del grupo de recursos “rg-monitoring”.

Sugerencias de anotación de herramientas:

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"?"

Sugerencias de anotación de herramientas:

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 “errors” de la tabla “Syslog” en el espacio de trabajo de Log Analytics “my-workspace” del grupo de recursos “rg-prod”.

Sugerencias de anotación de herramientas:

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 ID de recurso “/subscriptions/a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1/resourceGroups/rg-prod/providers/Microsoft.Compute/virtualMachines/my-vm” en la tabla “AzureDiagnostics”.

Sugerencias de anotación de herramientas:

Modelos de salud: listar modelos de salud

Enumera todos los modelos de estado de un recurso de modelo de estado de Azure Monitor. Esta herramienta le ayuda a descubrir los modelos de salud disponibles para supervisar el estado en el nivel de aplicación. 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. 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:

• "Enumere todos los modelos de salud del recurso de modelo de salud 'app-health-monitor' del grupo de recursos 'rg-prod'."

Comando de la CLI de ejemplo

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

Sugerencias de anotación de herramientas:

Destructiva: ❌ | Idempotente: ✅ | Mundo Abierto: ❌ | Solo Lectura: ✅ | Secreto: ❌ | Requerido Local: ❌

Modelos de salud: obtener modelo de salud

Recupera un modelo de salud específico por su nombre de un recurso de modelo de salud de Azure Monitor. Esta herramienta devuelve el estado de salud y los eventos de salud recientes de un modelo de salud específico. 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. 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:

• "Obtenga el modelo de salud 'order-service-health' del recurso de modelo de salud 'app-health-monitor' del grupo de recursos 'rg-prod'."

Sugerencias de anotación de herramientas:

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".
• ¿Comprobar la métrica de disponibilidad “availabilityResults/availabilityPercentage” para el recurso de Application Insights “appinsights-staging” utilizando el espacio de nombres de métricas “microsoft.insights/components”?.
• Obtener la métrica “requests/duration” con la agregación “Average” y el intervalo “PT1M” para el recurso “appinsights-prod” utilizando el espacio de nombres de métricas “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".
• Consultar la métrica requests/count del recurso appinsights-qa del tipo Microsoft.Insights/components, con el espacio de nombres de métricas 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"?

Sugerencias de anotación de herramientas:

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".

Sugerencias de anotación de herramientas:

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:

• Obtén 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 “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.
• Muéstrame todas las rutas de los recursos de aprendizaje para la instrumentación de Azure Monitor.
• "¿Qué recursos de aprendizaje están disponibles para la incorporación de instrumentación Azure Monitor?"

Sugerencias de anotación de herramientas:

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. Sigue exactamente la acción indicada en el campo instruction.

Algunas indicaciones de ejemplo incluyen:

• Iniciar la orquestación de instrumentación de Azure Monitor para el directorio de trabajo "/home/dev/workspace-monitoring".
• Analiza la ruta del espacio de trabajo “/src/projects/my-app-workspace” y devuelve el primer paso de instrumentación de Azure Monitor.
• Inicia la incorporación guiada a Azure Monitor para el proyecto en la ruta del espacio de trabajo “/workspace/my-app” y muéstrame el primer paso.

Sugerencias de anotación de herramientas:

Instrumentación: Continuar con la orquestación

Obtén la siguiente acción de instrumentación después de completar la actual.

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

Después de ejecutar exactamente el instruction de la respuesta anterior, ejecuta esta herramienta para recibir la siguiente acción.

Flujo de trabajo esperado:

1. Recibirás una acción de orchestrator-start u 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:

• Tras completar el paso anterior de instrumentación de Azure Monitor, obtén la siguiente acción para el ID de sesión “session-abc123” con la nota de finalización “Se ha añadido UseAzureMonitor() a Program.cs”.
• Obtén la siguiente acción de incorporación para el ID de sesión “workspace/session-2026” con la nota de finalización “Se ha ejecutado dotnet add package Microsoft.ApplicationInsights”.
• Tras completar el paso de instrumentación anterior, devuelve el siguiente paso para el ID de sesión session-789xyz con la nota de finalización Se ha actualizado el archivo appsettings.json para habilitar Application Insights.

Sugerencias de anotación de herramientas:

Instrumentación: Enviar análisis de código heredado

Envía los resultados del análisis de código heredado después de que orchestrator-start devuelva 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:

• Envía los resultados del análisis de código heredado en formato JSON '{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 solicitarse el análisis.
• Continúa con la orquestación de la migración enviando el JSON de resultados '{serviceOptions:{found:true,details:Se ha utilizado AddApplicationInsightsTelemetry},initializers:[],processors:[],clientUsage:null,sampling:{“found”:false," hasCustomSampling:false},telemetryPipeline:null,“logging”:null}“ a la sesión 'sess-01234”.
• Envía el análisis de telemetría de entorno existente completado como resultados JSON '{serviceOptions:null,initializers:null,processors:null,clientUsage:{found:true},sampling:{“found”:false," hasCustomSampling:false},telemetryPipeline:null,logging:{“found”:true}}“ para la sesión de incorporación 'session-9f3b”.

Sugerencias de anotación de herramientas:

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. Una vez que esta herramienta funcione correctamente, continúe con orchestrator-next.

Algunas indicaciones de ejemplo incluyen:

• Enviar las claves de mejora “redis,processors” para el ID 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 el ID de sesión de incorporación “workspaces/onboard/session-456”.

Sugerencias de anotación de herramientas:

Libros de trabajo: Listar libros de trabajo

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 en diferentes ámbitos.

Devuelve metadatos de los libros de trabajo, incluidos id, name, location, category y marcas de tiempo. De forma predeterminada, no devuelve el contenido completo del libro de trabajo (serializedData); para ello, utiliza la herramienta show o establece Output format en full.

De forma predeterminada, la búsqueda se centra en los libros de trabajo de tu contexto actual de Azure (cliente/suscripción). 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. Elige Output format como summary para obtener tokens mínimos o full para obtener una salida completa de serializedData.

Algunas indicaciones de ejemplo incluyen:

• Muéstrame todos los cuadernos de trabajo del 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?

Sugerencias de anotación de herramientas:

Libros de trabajo: Mostrar detalles del libro de trabajo

Recupera los detalles completos de los cuadernos de trabajo a través de la API de Azure Resource Manager (ARM), incluido el contenido 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'.

Sugerencias de anotación de herramientas:

Libros: Crear libro

Crea 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:

• Crea un nuevo cuaderno denominado “Performance Dashboard” en el grupo de recursos “monitoring-rg” con el contenido serializado de un cuaderno 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".

Sugerencias de anotación de herramientas:

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. Necesitas el identificador del recurso del cuaderno y puedes especificar un nuevo contenido serializado o un nuevo nombre para mostrar.

Algunas indicaciones de ejemplo incluyen:

• Actualiza el libro de trabajo “/subscriptions/abc123/resourceGroups/monitoring-rg/providers/Microsoft.Insights/workbooks/a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1” con el nombre para mostrar “Informe mensual”.
• Cambia el contenido serializado del libro de trabajo “/subscriptions/xyz789/resourceGroups/prod-rg/providers/Microsoft.Insights/workbooks/b1b1b1b1-cccc-dddd-eeee-f2f2f2f2f2f2” para incluir un nuevo gráfico de métricas.

Sugerencias de anotación de herramientas:

Libros de trabajo: Eliminar libros de trabajo

Elimina uno o varios libros de trabajo por sus ID de recurso 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 los errores parciales por libro de trabajo, lo que garantiza que los errores individuales no afecten a toda la operación por lotes.

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

Algunas indicaciones de ejemplo incluyen:

• Elimina el libro de trabajo con el ID de recurso “/subscriptions/abc123/resourceGroups/monitoring/providers/Microsoft.Insights/workbooks/a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1”.
• Elimina los libros de trabajo con los ID de recurso “/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'."

Sugerencias de anotación de herramientas:

Contenido relacionado

• ¿Cuáles son las herramientas de servidor MCP de Azure?
• Comience a usar Servidor MCP de Azure
• Azure Monitor
• Application Insights
• Workbooks en Azure Monitor
• Métricas en Azure Monitor