View a markdown version of this page

Observabilitas Agen dengan Aplikasi MCP - OpenSearch Layanan Amazon

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Observabilitas Agen dengan Aplikasi MCP

OpenSearch memberikan pengalaman observabilitas agen dengan Aplikasi MCP yang membawa alur kerja observabilitas ke IDE agen Anda, dengan visualisasi yang dirender Aplikasi MCP yang dapat Anda verifikasi. Pengalaman ini menambah pengalaman observabilitas berbasis halaman web di OpenSearch UI (log, jejak, metrik, peringatan). Agen AI Anda dapat menyelidiki insiden dengan data yang disimpan dalam OpenSearch domain dan koleksi. Dengan Aplikasi MCP, setiap panggilan alat MCP mengembalikan ringkasan teks untuk alasan agen dan visualisasi interaktif untuk Anda verifikasi di utas percakapan yang sama.

Topik

Contoh Aplikasi MCP

Contoh berikut menunjukkan bagaimana Aplikasi MCP merender visualisasi interaktif di dalam IDE agen yang kompatibel saat Anda menyelidiki insiden.

Peringatan — Lihat dan triase peringatan penembakan di seluruh sumber data Anda. Tampilan peringatan menunjukkan aktivitas penembakan dari waktu ke waktu, kerusakan tingkat keparahan, dan detail per peringatan, dengan opsi untuk memulai penyelidikan. Tangkapan layar berikut menunjukkan tampilan peringatan dengan aktivitas penembakan.

Tampilan lansiran Aplikasi MCP yang menampilkan histogram aktivitas penembakan dan daftar peringatan yang dapat difilter berdasarkan tingkat keparahan, status, dan sumber.

Laporan observabilitas — Tinjau hasil agregat, seperti jumlah kesalahan berdasarkan layanan, di samping kueri yang mendasarinya dan analisis AI-generated akar penyebab. Tangkapan layar berikut menunjukkan laporan observabilitas.

Laporan observabilitas Aplikasi MCP yang menunjukkan bagan batang hitungan berdasarkan layanan kesalahan, tabel akar penyebab, dan ringkasan analisis.

Investigasi jejak — Jelajahi hierarki rentang dan garis waktu jejak terdistribusi, periksa detail rentang individu, dan baca analisis dari mana kegagalan berasal. Tangkapan layar berikut menunjukkan tampilan investigasi jejak.

Investigasi jejak Aplikasi MCP yang menunjukkan garis waktu hierarki rentang dengan detail rentang dan analisis AI.

Peta layanan — Visualisasikan dependensi layanan sebagai grafik panggilan, di mana lebar tepi mencerminkan volume panggilan dan warna mencerminkan tingkat kesalahan, untuk memahami radius ledakan suatu insiden. Diagram berikut menunjukkan peta layanan.

Peta layanan Aplikasi MCP yang menampilkan grafik panggilan dengan tingkat kesalahan per layanan dan tepi ketergantungan.

Visualisasi metrik — Render hasil kueri PromQL sebagai grafik garis, batang, area, atau metrik interaktif, dengan rangkaian hasil dan analisis perilaku metrik. Tangkapan layar berikut menunjukkan visualisasi metrik.

Visualisasi metrik Aplikasi MCP menampilkan bagan garis promQL dengan seri hasil dan tabel nilai metrik.

Konsep utama

OpenSearch UI

OpenSearch UI adalah dasbor berbasis cloud yang dikelola dan pengalaman analitik operasional untuk Amazon OpenSearch Service. Ini menyediakan antarmuka titik akhir tunggal terpadu untuk mengeksplorasi, menanyakan, dan memvisualisasikan data di berbagai sumber data. Visualisasi yang dihasilkan melalui Aplikasi MCP berasal dari aplikasi UI Anda OpenSearch .

Server MCP lokal

Server MCP lokal adalah program yang berjalan langsung di komputer Anda yang bertindak sebagai jembatan dua arah yang aman antara IDE agen Anda dan aplikasi UI Anda OpenSearch . Server MCP berisi beberapa alat yang dapat digunakan agen AI Anda, termasuk alat Aplikasi MCP yang merender UI dalam IDE yang kompatibel. Ikuti petunjuk di bagian berikut untuk menginstal server MCP lokal dengan kemampuan Aplikasi MCP.

Aplikasi MCP

Aplikasi UI interaktif yang dirender di dalam host MCP seperti Claude Desktop. Dalam pengalaman OpenSearch observabilitas agen, aplikasi MCP adalah unit yang dapat dikomposisi yang melakukan pekerjaan observabilitas tunggal seperti menampilkan visualisasi tentang SLO atau jejak.

Respon ganda

Dengan Aplikasi MCP, satu panggilan alat di IDE yang kompatibel sekarang mengembalikan dua output secara bersamaan: ringkasan teks ringkas yang Anda harapkan dari agen observabilitas Anda, dan visualisasi interaktif yang diberikan dalam percakapan yang sama agar Anda dapat dengan mudah meninjau dan memverifikasi hasilnya.

Prasyarat

  • Aplikasi OpenSearch UI dengan ruang kerja Observability dibuat dan terhubung ke setidaknya satu sumber data (OpenSearch domain, koleksi, atau Prometheus yang Dikelola Amazon)

  • IDE agen dengan dukungan Aplikasi MCP (Claude Desktop, VS Code GitHub Copilot, Goose, ChatGPT, Cursor)

  • Keakraban dasar dengan konsep observabilitas (log, jejak, metrik) dan penggunaan IDE

  • Node.js 22 atau lebih baru diinstal pada mesin lokal Anda

  • AWS kredensil yang dikonfigurasi dengan izin untuk mengakses aplikasi UI Anda OpenSearch. Kredensil harus memungkinkan es:ESHttpGet dan es:ESHttpPost tindakan.

  • (Opsional) Aplikasi OpenTelemetry Demo digunakan dengan data sampel, jika Anda ingin menguji tanpa data produksi

Menyiapkan server MCP

Untuk mengatur server MCP menggunakan file mcpb
  1. Unduh file server MCP OpenSearch observabilitas. Secara opsional, Anda juga dapat mengunduh file tanda tangan untuk verifikasi.

  2. Unzip file yang diunduh.

  3. Buka file mcpb untuk memicu IDE Anda yang kompatibel untuk memulai alur konfigurasi. Ikuti instruksi di dalam halaman.

Atau, jika membuka file MCPB tidak berfungsi, Anda dapat menggunakan file server.js sebagai referensi dan secara manual mengkonfigurasi server MCP di ekstensi IDE Anda.

Untuk mengkonfigurasi server MCP secara manual
  1. Buka IDE pilihan Anda (pastikan itu kompatibel dengan Aplikasi MCP), dan arahkan ke ekstensi atau bagian MCP. Pilih Tambahkan konfigurasi baru.

  2. Di halaman konfigurasi, perbarui nilai berikut:

    • Ganti nilai “args” dengan jalur file server.js Anda yang sebenarnya.

    • Ganti OS_UI_ENDPOINT dengan URL aplikasi UI Anda. OpenSearch

    • Ganti wilayah dengan Wilayah aplikasi OpenSearch UI Anda.

Contoh berikut menunjukkan konfigurasi untuk 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— Ganti dengan path ke file server.js Anda.

  • OS_UI_ENDPOINT— Ganti dengan URL aplikasi OpenSearch UI Anda.

  • AWS_REGION— Ganti dengan AWS Wilayah Anda.

  • AWS_PROFILE— Ganti dengan nama AWS profil Anda. Jika Anda belum memiliki profil yang dikonfigurasi, ikuti instruksi ini.

Setelah Anda mengonfigurasi server MCP, verifikasi koneksi dengan memasukkan pertanyaan di IDE Anda, seperti “Daftar sumber data observabilitas yang tersedia”. Jika Anda menerima pesan kesalahan, ikuti petunjuk untuk memperbaiki konfigurasi.

Aplikasi MCP yang tersedia untuk observabilitas agen

  • Triase dan Respons - korelasi peringatan, garis waktu insiden

  • Investigasi Log - pencarian pola, pengelompokan log

  • Investigasi Jejak - pencari jejak, detail rentang, kerusakan latensi

  • Investigasi Metrik — eksplorasi PromQL, analisis ambang

  • Kinerja Layanan - Metrik RED, tampilan tingkat layanan

  • Topologi - peta layanan, grafik ketergantungan

  • Visualisasi — visualisasi dinamis

  • Kumpulan Data dan Korelasi — gabungan sinyal silang, ringkasan data

  • AI dan Observabilitas Agen - Penelusuran panggilan LLM, peta jejak agen, dan ringkasan

  • Stack Health - status cluster, alokasi pecahan

  • Skor instrumentasi — menggunakan telemetri untuk mendeteksi jebakan instrumentasi

verifikasi file mcpb

(Opsional) Untuk memverifikasi tanda tangan artefak yang diunduh, impor kunci penandatanganan publik dan jalankan perintah berikut.

# 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

Jika verifikasi berhasil, output termasukGood signature from "OpenSearch MCP <aos-observability-mcp-releases@amazon.com>".