Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
Observabilidad de los agentes con aplicaciones MCP
OpenSearch proporciona una experiencia de observabilidad de la agencia con aplicaciones MCP que incorpora los flujos de trabajo de observabilidad al IDE de su agencia, con visualizaciones renderizadas por la aplicación MCP que usted puede verificar. Esta experiencia mejora la experiencia de observabilidad basada en páginas web en la interfaz de usuario (registros, rastreos, métricas, alertas). OpenSearch Su agente de IA puede investigar los incidentes con los datos almacenados en OpenSearch dominios y colecciones. Con las aplicaciones MCP, cada llamada a la herramienta MCP devuelve un resumen de texto para que el agente lo revise y una visualización interactiva para que usted la verifique en el mismo hilo de conversación.
Temas
Ejemplos de aplicaciones MCP
Los siguientes ejemplos muestran cómo las aplicaciones MCP renderizan visualizaciones interactivas dentro de un IDE de agencia compatible mientras investigas un incidente.
Alertas: vea y clasifique las alertas de activación en todas sus fuentes de datos. La vista de alertas muestra la actividad de los disparos a lo largo del tiempo, los desgloses de gravedad y los detalles por alerta, con la opción de iniciar una investigación. En la siguiente captura de pantalla, se muestra la vista de alertas con la actividad de los disparos.
Informe de observabilidad: revise los resultados agregados, como los recuentos de errores por servicio, junto con la consulta subyacente y un análisis de la causa raíz. AI-generated En la siguiente captura de pantalla se muestra el informe de observabilidad.
Investigación de trazas: explore la jerarquía y el cronograma de un rastreo distribuido, inspeccione los detalles de los tramos individuales y lea un análisis del lugar donde se originó una falla. La siguiente captura de pantalla muestra la vista de investigación de trazas.
Mapa de servicio: visualice las dependencias del servicio como un gráfico de llamadas, donde el ancho del borde refleja el volumen de llamadas y el color refleja la tasa de errores, para comprender el radio de alcance de un incidente. El siguiente diagrama muestra el mapa de servicio.
Visualización de métricas: renderice los resultados de las consultas de ProMQL como gráficos interactivos de líneas, barras, áreas o métricas, con series de resultados y un análisis del comportamiento de las métricas. La siguiente captura de pantalla muestra la visualización métrica.
Conceptos clave
- OpenSearch INTERFAZ DE USUARIO
-
OpenSearch La interfaz de usuario es un panel de control gestionado y basado en la nube y una experiencia de análisis operativo para Amazon OpenSearch Service. Proporciona una interfaz unificada de punto final único para explorar, consultar y visualizar datos en múltiples fuentes de datos. Las visualizaciones generadas a través de las aplicaciones MCP provienen de su OpenSearch aplicación de interfaz de usuario.
- Servidor MCP local
-
Un servidor MCP local es un programa que se ejecuta directamente en su computadora y que actúa como un puente bidireccional seguro entre el IDE de su agente y su aplicación de interfaz de usuario. OpenSearch El servidor MCP contiene varias herramientas que sus agentes de IA pueden utilizar, incluidas las herramientas de la aplicación MCP que renderizan la interfaz de usuario en su IDE compatible. Siga las instrucciones de las siguientes secciones para instalar un servidor MCP local con las funciones de la aplicación MCP.
- Aplicación MCP
-
Aplicaciones de interfaz de usuario interactivas que se renderizan dentro de hosts MCP como Claude Desktop. En la experiencia de observabilidad de los OpenSearch agentes, una aplicación MCP es una unidad componible que realiza una sola tarea de observabilidad, como mostrar una visualización sobre el SLO o las trazas.
- Respuesta doble
-
Con MCP Apps, una sola llamada a una herramienta en su IDE compatible ahora arroja dos resultados simultáneamente: un resumen de texto compacto que cabría esperar de un agente de observabilidad y una visualización interactiva renderizada en la misma conversación para que pueda revisar y verificar fácilmente los resultados.
Requisitos previos
-
Una aplicación de OpenSearch interfaz de usuario con un espacio de trabajo de Observabilidad creada y conectada a al menos una fuente de datos (OpenSearch dominios, colecciones o Prometheus gestionado por Amazon)
-
Un IDE de agencia compatible con aplicaciones MCP
(Claude Desktop, VS GitHub Code Copilot, Goose, ChatGPT, Cursor) -
Familiaridad básica con los conceptos de observabilidad (registros, trazas, métricas) y el uso del IDE
-
Node.js 2.2 o posterior instalado en su máquina local
-
AWS credenciales configuradas con permisos para acceder a su aplicación de OpenSearch interfaz de usuario. Las credenciales deben permitir las
es:ESHttpPostaccioneses:ESHttpGety. -
(Opcional) La aplicación de OpenTelemetry demostración se implementó con datos de muestra, si desea realizar pruebas sin datos de producción
Configuración del servidor MCP
Para configurar el servidor MCP mediante el archivo mcpb
-
Descargue el archivo
del servidor OpenSearch MCP de observabilidad. Si lo desea, también puede descargar el archivo de firma para su verificación. -
Descomprima el archivo descargado.
-
Abra el archivo mcpb para activar su IDE compatible e iniciar un flujo de configuración. Siga las instrucciones de la página.
Como alternativa, si abrir el archivo mcpb no funciona, puede usar el archivo server.js como referencia y configurar manualmente el servidor MCP en la extensión de su IDE.
Para configurar manualmente el servidor MCP
-
Abra el IDE que prefiera (asegúrese de que sea compatible con las aplicaciones MCP) y vaya a la sección de extensiones o MCP. Seleccione Añadir nueva configuración.
-
En la página de configuración, actualice los siguientes valores:
-
Sustituya el valor «args» por la ruta real del archivo server.js.
-
Sustituya OS_UI_ENDPOINT por la URL de su OpenSearch aplicación de interfaz de usuario.
-
Sustituya la región por la región de su aplicación de interfaz de usuario. OpenSearch
-
El siguiente ejemplo muestra una configuración para el servidor MCP.
{ "mcpServers": { "opensearch-observability-stack-mcp": { "command": "node", "args": ["/path/to/opensearch-observability-stack-mcp/server/server.js"], "env": { "OS_UI_ENDPOINT": "application-foo-bar.us-west-2.opensearch.amazonaws.com", "AWS_REGION": "us-west-2", "AWS_PROFILE": "my-profile" } } } }
-
/path/to/opensearch-observability-stack-mcp/server/server.js— Sustitúyalo por la ruta a su archivo server.js. -
OS_UI_ENDPOINT— Sustitúyala por la URL de tu aplicación de OpenSearch interfaz de usuario. -
AWS_REGION— Sustitúyala por tu AWS región. -
AWS_PROFILE— Sustitúyalo por tu nombre AWS de perfil. Si aún no tiene un perfil configurado, siga estas instrucciones.
Después de configurar el servidor MCP, compruebe la conexión introduciendo una pregunta en su IDE, como «Listar las fuentes de datos de observabilidad disponibles». Si recibe un mensaje de error, siga las instrucciones para corregir la configuración.
Aplicaciones MCP disponibles para la observabilidad de los agentes
-
Clasificación y respuesta: correlación de alertas, cronología de incidentes
-
Investigación de registros: búsqueda de patrones, agrupamiento de registros
-
Investigación de trazas: buscador de trazas, detalles del intervalo, desglose de la latencia
-
Investigación métrica: exploración con ProMQL, análisis de umbrales
-
Rendimiento del servicio: métricas de RED, vistas del nivel de servicio
-
Topología: mapas de servicios, gráficos de dependencia
-
Visualizaciones: visualizaciones dinámicas
-
Conjuntos de datos y correlaciones: uniones de señales cruzadas, resúmenes de datos
-
Observabilidad de la IA y de los agentes: rastreo de llamadas, mapa y resumen del rastreo de agentes
-
Stack Health: estado del clúster, asignación de fragmentos
-
Puntuación de instrumentación
: uso de la telemetría para detectar errores en la instrumentación
verificación del archivo mcpb
(Opcional) Para verificar la firma del artefacto descargado, importe la clave de firma pública
# 1. Import the public signing key (one-time) curl -s https://d373kuglijqwic.cloudfront.net/opensearch-mcp-signing-public.asc | gpg --import # 2. Download the artifact and its signature curl -O https://d373kuglijqwic.cloudfront.net/opensearch-observability-stack-mcp.zip curl -O https://d373kuglijqwic.cloudfront.net/opensearch-observability-stack-mcp.zip.asc # 3. Verify gpg --verify opensearch-observability-stack-mcp.zip.asc opensearch-observability-stack-mcp.zip
Si la verificación se realiza correctamente, el resultado incluye: Good signature from
"OpenSearch MCP <aos-observability-mcp-releases@amazon.com>"