As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Observabilidade agente com aplicativos MCP

OpenSearch fornece uma experiência de observabilidade agente com aplicativos MCP que traz fluxos de trabalho de observabilidade para seu IDE agente, com visualizações renderizadas do aplicativo MCP que você pode verificar. Essa experiência aumenta a experiência de observabilidade baseada em páginas da Web na OpenSearch interface do usuário (registros, rastreamentos, métricas, alertas). Seu agente de IA pode investigar incidentes com dados armazenados em OpenSearch domínios e coleções. Com os aplicativos MCP, cada chamada da ferramenta MCP retorna um resumo em texto para o agente raciocinar e uma visualização interativa para você verificar no mesmo tópico de conversa.

Tópicos

Exemplos de aplicativos MCP

Os exemplos a seguir mostram como os aplicativos MCP renderizam visualizações interativas dentro de um IDE agente compatível enquanto você investiga um incidente.

Alertas — Visualize e faça a triagem de alertas de disparo em suas fontes de dados. A visualização do alerta mostra a atividade de disparo ao longo do tempo, as falhas de gravidade e os detalhes por alerta, com a opção de iniciar uma investigação. A captura de tela a seguir mostra a visualização de alertas com a atividade de disparo.

Relatório de observabilidade — analise os resultados agregados, como contagens de erros por serviço, juntamente com a consulta subjacente e uma análise da causa AI-generated raiz. A captura de tela a seguir mostra o relatório de observabilidade.

Investigação de rastreamento — explore a hierarquia e o cronograma de intervalos de um rastreamento distribuído, inspecione detalhes individuais de intervalos e leia uma análise da origem de uma falha. A captura de tela a seguir mostra a visualização da investigação de rastreamento.

Mapa do serviço — Visualize as dependências do serviço como um gráfico de chamadas, em que a largura da borda reflete o volume da chamada e a cor reflete a taxa de erro, para entender o raio de explosão de um incidente. O diagrama a seguir mostra o mapa do serviço.

Visualização métrica — renderize os resultados da consulta ProMQL como gráficos interativos de linhas, barras, áreas ou métricas, com séries de resultados e uma análise do comportamento métrico. A captura de tela a seguir mostra a visualização métrica.

Principais conceitos

Pré-requisitos

Configurando o servidor MCP

Como alternativa, se a abertura do arquivo mcpb não funcionar, você pode usar o arquivo server.js como referência e configurar manualmente o servidor MCP na extensão do seu IDE.

O exemplo a seguir mostra uma configuração para o 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"
      }
    }
  }
}

Depois de configurar o servidor MCP, verifique a conexão inserindo uma pergunta no seu IDE, como “Listar fontes de dados de observabilidade disponíveis”. Se você receber uma mensagem de erro, siga as instruções para corrigir a configuração.

Aplicativos MCP disponíveis para observabilidade agente

verificação do arquivo mcpb

(Opcional) Para verificar a assinatura do artefato baixado, importe a chave de assinatura pública e execute os comandos a seguir.

# 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 a verificação for bem-sucedida, a saída Good signature from "OpenSearch MCP <aos-observability-mcp-releases@amazon.com>" incluirá.