Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
Osservabilità agentica con app MCP
OpenSearch offre un'esperienza di osservabilità agentica con MCP Apps che porta i flussi di lavoro di osservabilità nel tuo IDE agentic, con visualizzazioni renderizzate dall'app MCP che puoi verificare. Questa esperienza migliora l'esperienza di osservabilità basata su pagine Web sull'interfaccia utente (log, tracce, metriche, avvisi). OpenSearch Il tuo agente AI può indagare sugli incidenti con i dati archiviati in domini e raccolte. OpenSearch Con MCP Apps, ogni chiamata allo strumento MCP restituisce sia un riepilogo testuale su cui l'agente deve ragionare, sia una visualizzazione interattiva da verificare nello stesso thread di conversazione.
Argomenti
Esempi di app MCP
Gli esempi seguenti mostrano come le app MCP eseguono il rendering di visualizzazioni interattive all'interno di un IDE agentic compatibile mentre si indaga su un incidente.
Avvisi: visualizza e classifica gli avvisi di attivazione tra le tue fonti di dati. La visualizzazione degli avvisi mostra l'attività di licenziamento nel tempo, le ripartizioni in base alla gravità e i dettagli per avviso, con un'opzione per avviare un'indagine. La schermata seguente mostra la visualizzazione degli avvisi con attività di attivazione.
Rapporto sull'osservabilità: esamina i risultati aggregati, come il conteggio degli errori per servizio, insieme alla query sottostante e all'analisi della causa principale. AI-generated La schermata seguente mostra il rapporto sull'osservabilità.
Indagine sulla tracciabilità: esplora la gerarchia e la cronologia degli intervalli di tracciamento distribuiti, esamina i dettagli dei singoli intervalli e leggi un'analisi dell'origine di un errore. La schermata seguente mostra la visualizzazione dell'indagine sulle tracce.
Mappa dei servizi: visualizza le dipendenze dei servizi sotto forma di un grafico delle chiamate, dove la larghezza dei bordi riflette il volume delle chiamate e il colore riflette il tasso di errore, per comprendere il raggio d'azione di un incidente. Il diagramma seguente mostra la mappa dei servizi.
Visualizzazione metrica: visualizza i risultati delle query PromQL come grafici interattivi a linee, barre, aree o metrici, con serie di risultati e un'analisi del comportamento delle metriche. La schermata seguente mostra la visualizzazione delle metriche.
Concetti chiave
- OpenSearch INTERFACCIA UTENTE
-
OpenSearch L'interfaccia utente è una dashboard gestita e basata sul cloud e un'esperienza di analisi operativa per Amazon OpenSearch Service. Fornisce un'interfaccia unificata a endpoint singolo per esplorare, interrogare e visualizzare i dati su più fonti di dati. Le visualizzazioni generate tramite le app MCP provengono dall'applicazione dell'interfaccia utente. OpenSearch
- Server MCP locale
-
Un server MCP locale è un programma in esecuzione direttamente sul computer che funge da ponte sicuro e bidirezionale tra l'IDE agentic e l'applicazione UI. OpenSearch Il server MCP contiene diversi strumenti che gli agenti di intelligenza artificiale possono utilizzare, inclusi gli strumenti dell'app MCP che eseguono il rendering dell'interfaccia utente all'interno del tuo IDE compatibile. Segui le istruzioni nelle sezioni seguenti per installare un server MCP locale con funzionalità dell'app MCP.
- App MCP
-
Applicazioni di interfaccia utente interattive che eseguono il rendering all'interno di host MCP come Claude Desktop. Nell'esperienza di osservabilità OpenSearch agentica, un'app MCP è un'unità componibile che esegue un singolo lavoro di osservabilità, ad esempio mostrando una visualizzazione su SLO o sulle tracce.
- Doppia risposta
-
Con MCP Apps, una singola chiamata allo strumento nell'IDE compatibile ora restituisce due output contemporaneamente: un riepilogo testuale compatto che ti aspetteresti dal tuo agente di osservabilità e una visualizzazione interattiva renderizzata nella stessa conversazione per consentirti di rivedere e verificare facilmente i risultati.
Prerequisiti
-
Un'applicazione OpenSearch UI con un'area di lavoro Observability creata e connessa ad almeno una fonte di dati (OpenSearch domini, raccolte o Amazon Managed Prometheus)
-
Un IDE agentic con supporto per MCP Apps
(Claude Desktop, VS Code Copilot, Goose, ChatGPT, Cursor) GitHub -
Familiarità di base con i concetti di osservabilità (log, tracce, metriche) e l'utilizzo dell'IDE
-
Node.js 22 o versione successiva installata sul computer locale
-
AWS credenziali configurate con autorizzazioni per accedere all'applicazione OpenSearch UI. Le credenziali devono consentire le azioni e
es:ESHttpGet.es:ESHttpPost -
(Facoltativo) L'applicazione OpenTelemetry demo è stata distribuita con dati di esempio, se si desidera eseguire il test senza dati di produzione
Configurazione del server MCP
Per configurare il server MCP utilizzando il file mcpb
-
Scarica il file
del server OpenSearch MCP di osservabilità. Facoltativamente, puoi anche scaricare il file della firma per la verifica . -
Decomprimere il file scaricato.
-
Apri il file mcpb per attivare l'IDE compatibile e avviare un flusso di configurazione. Segui le istruzioni all'interno della pagina.
In alternativa, se l'apertura del file mcpb non funziona, puoi usare il file server.js come riferimento e configurare manualmente il server MCP nell'estensione del tuo IDE.
Per configurare manualmente il server MCP
-
Apri l'IDE che preferisci (assicurati che sia compatibile con le app MCP) e vai alle estensioni o alla sezione MCP. Scegli Aggiungi nuova configurazione.
-
Nella pagina di configurazione, aggiorna i seguenti valori:
-
Sostituisci il valore «args» con il percorso effettivo del file server.js.
-
Sostituisci OS_UI_ENDPOINT con l'URL dell'applicazione UI. OpenSearch
-
Sostituisci la regione con la regione dell'applicazione UI. OpenSearch
-
L'esempio seguente mostra una configurazione per il server 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— Sostituire con il percorso del file server.js. -
OS_UI_ENDPOINT— Sostituiscilo con l'URL dell'applicazione OpenSearch UI. -
AWS_REGION— Sostituisci con la tua AWS regione. -
AWS_PROFILE— Sostituisci con il nome AWS del tuo profilo. Se non hai ancora configurato un profilo, segui queste istruzioni.
Dopo aver configurato il server MCP, verificate la connessione inserendo una domanda nell'IDE, ad esempio «Elenca le fonti di dati di osservabilità disponibili». Se ricevete un messaggio di errore, seguite le istruzioni per correggere la configurazione.
App MCP disponibili per l'osservabilità agentica
-
Triage e risposta: correlazione degli avvisi, cronologia degli incidenti
-
Log Investigation: ricerca di modelli, raggruppamento dei log
-
Trace Investigation: strumento di ricerca delle tracce, dettagli sugli intervalli, suddivisione della latenza
-
Metric Investigation: esplorazione PromQL, analisi delle soglie
-
Prestazioni del servizio: metriche RED, visualizzazioni a livello di servizio
-
Topologia: mappe dei servizi, grafici delle dipendenze
-
Visualizzazioni: visualizzazioni dinamiche
-
Set di dati e correlazioni: giunzioni tra segnali, riepiloghi dei dati
-
AI e osservabilità degli agenti: tracciamento delle chiamate LLM, mappa di tracciamento degli agenti e riepilogo
-
Stack Health: stato del cluster, allocazione degli shard
-
Punteggio della strumentazione:
utilizzo della telemetria per rilevare le insidie della strumentazione
verifica del file mcpb
(Facoltativo) Per verificare la firma dell'elemento scaricato, importa la chiave di firma pubblica
# 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
Se la verifica ha esito positivo, l'output include. Good signature from
"OpenSearch MCP <aos-observability-mcp-releases@amazon.com>"