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.
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.
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.
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.
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.
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:ESHttpGetdanes:ESHttpPosttindakan. -
(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
-
Unduh file
server MCP OpenSearch observabilitas. Secara opsional, Anda juga dapat mengunduh file tanda tangan untuk verifikasi . -
Unzip file yang diunduh.
-
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
-
Buka IDE pilihan Anda (pastikan itu kompatibel dengan Aplikasi MCP), dan arahkan ke ekstensi atau bagian MCP. Pilih Tambahkan konfigurasi baru.
-
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
# 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>".