Hubungkan AWS DevOps Agent ke TrueWatch MCP Server (APM, Log, Trace & RUM)

Agen operasional baru berguna jika ia dapat melihat sistem yang diminta untuk diselidiki.

AWS DevOps Agent memberi tim pintu masuk berbasis bahasa alami untuk tugas operasi cloud. TrueWatch MCP Server memberi agen tersebut cara yang terkelola untuk melakukan kueri data observabilitas: log, metrik, trace, data RUM, dasbor, monitor, dan konteks investigasi terkait. Bersama-sama, keduanya memungkinkan engineer memulai dari pertanyaan produksi seperti "apa yang berubah saat lonjakan error ini terjadi?" dan membiarkan agen mengumpulkan bukti melalui tool yang dibatasi cakupannya, alih-alih menebak dari konteks prompt.

Panduan ini membahas alur koneksi yang praktis. Anggap ini sebagai pola integrasi, bukan model izin akses. MCP menjawab pertanyaan tentang antarmuka: dapatkah agen memanggil tool observabilitas yang tepat? Deployment produksi tetap memerlukan cakupan workspace, key dengan hak akses minimum, default hanya-baca, persetujuan untuk tindakan yang berdampak langsung, dan catatan audit pemanggilan tool.

Nilai Tambah AWS DevOps Agent

AWS DevOps Agent adalah asisten operasi berbasis AI dari AWS — agen DevOps AI yang dirancang untuk membantu pengguna bekerja dengan sumber daya cloud, mengatasi masalah, dan menghasilkan output terkait infrastruktur melalui interaksi bahasa alami.

Untuk pekerjaan observabilitas, yang penting bukanlah antarmuka obrolannya. Nilainya datang dari menghubungkan agen ke sinyal produksi yang terbaru sekaligus menjaga akses tetap terbatas. Tanpa koneksi tersebut, agen hanya dapat menjelaskan pola kegagalan yang mungkin terjadi. Dengan koneksi MCP yang dibatasi cakupannya, agen dapat memeriksa telemetri terkini dan mengutip bukti yang digunakannya.

Nilai Tambah TrueWatch MCP Server

TrueWatch adalah platform observabilitas bagi engineer yang mengoperasikan sistem produksi modern. TrueWatch menyatukan pemantauan infrastruktur, application performance monitoring (APM), manajemen log, distributed trace, RUM, dasbor, alert, dan data sumber daya cloud dalam satu konteks investigasi bersama.

TrueWatch MCP Server mengekspos kapabilitas TrueWatch tertentu kepada klien yang kompatibel dengan MCP. Dalam artikel ini, AWS DevOps Agent terhubung ke TrueWatch MCP Server dan menerima serangkaian tool berorientasi baca, seperti:

list_checkers
list_logging_query_rules
list_dashboards
query_log_data
query_metric_data
query_trace_data
query_rum_data

Mulailah dengan tool hanya-baca. Biarkan agen mengambil bukti, merangkumnya, dan mengusulkan langkah berikutnya sebelum memperluas akses ke alur kerja yang mengubah sistem produksi.

Alur Integrasi

Alur integrasinya adalah:

AWS DevOps Agent -> MCP Server registration -> TrueWatch MCP Server -> TrueWatch observability data

Tampilan UI AWS dapat berubah. Pola operasionalnya tetap familier: daftarkan MCP server, tambahkan endpoint dan detail autentikasi, kaitkan server ke Agent Space, pilih tool yang diizinkan, lalu jalankan investigasi hanya-baca untuk memverifikasi alurnya.

1. Buka Menu Pendaftaran MCP Server

Buka konsol AWS DevOps Agent. Di menu fungsi, buka Setting, lalu pilih Register. Halaman pendaftaran menampilkan entri integrasi pihak ketiga seperti GitLab, ServiceNow, Slack, dan MCP Server. Pilih MCP Server untuk memulai alur pendaftaran TrueWatch MCP Server.

Saat alur asosiasi berhasil dimulai, halaman akan menampilkan pesan yang serupa dengan:

AWS DevOps Agent MCP Server associated successfully

2. Konfigurasikan Endpoint TrueWatch MCP Server

Di halaman detail MCP server, selesaikan konfigurasi inti.

Pastikan Protokol Transport

MCP server harus mendukung transport Streamable HTTP. Pastikan hal ini sebelum menambahkan endpoint.

Pilih Alur Otorisasi

Buka Authorization configuration dan pilih metode otorisasi yang sesuai dengan pengaturan TrueWatch MCP Server Anda.

Beri Nama Server

Pada Name, gunakan nama yang jelas seperti:

TrueWatch MCP Server

Gunakan nama yang menggambarkan lingkungan jika Anda mengoperasikan beberapa workspace, misalnya TrueWatch MCP Server - Production Read Only.

Tambahkan URL Endpoint

Pada Endpoint URL, tambahkan endpoint TrueWatch MCP Server untuk workspace Anda.

Contoh format target:

https://toby-ai.truewatch.com/toby_ai_mcp/mcp

Pastikan endpoint final pada dokumentasi TrueWatch terbaru sebelum memublikasikan atau membagikan panduan ini. URL ini juga dapat muncul di log AWS CloudTrail, jadi hindari menyematkan rahasia di dalam endpoint itu sendiri.

Jika halaman menyediakan kolom Description, tambahkan catatan operasional singkat seperti:

Read-only observability tools for production investigation.

Aktifkan Dynamic Client Registration hanya jika sesuai dengan kebijakan keamanan Anda. Fitur ini memungkinkan DevOps Agent mendaftar ke authorization server MCP selama proses penyiapan.

Klik Next setelah endpoint dikonfigurasi.

3. Gunakan Otorisasi API Key

AWS DevOps Agent mendukung alur otorisasi seperti OAuth Client Credentials, OAuth 3LO, dan API Key. Penyiapan sumber menggunakan otorisasi API Key untuk TrueWatch MCP Server.

Alur ini menghindari langkah pengalihan browser dan memberi aplikasi pemanggil jalur autentikasi langsung. Di produksi, gunakan key khusus untuk koneksi agen ini dan batasi cakupannya ke data dan tool minimum yang diperlukan.

Konfigurasikan Header

Atur nama header tetap menjadi:

Authorization

Konfigurasikan Nilai API Key

Gunakan format API key dan site key yang ditentukan dalam dokumentasi TrueWatch MCP Server Anda. Penyiapan sumber menggunakan nilai gabungan:

<TRUEWATCH_API_KEY>-<SITE_KEY>

Di mana:

<TRUEWATCH_API_KEY> adalah API key yang dibuat di workspace TrueWatch.
<SITE_KEY> mengidentifikasi region atau situs deployment TrueWatch.

Buat atau Tinjau API Key

Di konsol TrueWatch, buka System Settings lalu masuk ke API Keys. Buat key untuk integrasi ini atau tinjau key yang sudah ada.

Untuk agen operasional, titik awal yang lebih aman adalah:

akses hanya-baca
izin yang dibatasi pada workspace
tanpa peran administrator yang luas
key terpisah untuk development, staging, dan produksi
kebijakan rotasi dan informasi pemilik

Petakan Site Key

Region deployment TrueWatch dipetakan ke endpoint OpenAPI yang berbeda. Pastikan peta yang aktif sebelum digunakan di produksi. Versi blog berbahasa Inggris dapat menunjukkan polanya tanpa membuka detail deployment internal:

const SITE_KEY_MAP = {  us1: 'https://us1-openapi.truewatch.com',  eu1: 'https://eu1-openapi.truewatch.com',  ap1: 'https://ap1-openapi.truewatch.com',};

Setelah meninjau konfigurasi, klik Previous jika Anda perlu memeriksa pengaturan sebelumnya. Lalu klik Next untuk mengirim. Penyiapan yang berhasil akan menampilkan pesan asosiasi MCP server.

4. Kaitkan MCP Server ke Agent Space

Kembali ke halaman utama AWS DevOps Agent dan buka Agent Spaces.

Agent Spaces mengatur rentang akses, batas kapabilitas, dan cakupan operasional DevOps Agent. Gunakan space terpisah jika tim, lingkungan, atau tingkat risiko perlu diisolasi.

Buka Agent Space target, klik View details, lalu temukan MCP Server.

5. Tambahkan Tool MCP dan Simpan Konfigurasi

Di halaman tool MCP server, pilih tool yang boleh dipanggil oleh AWS DevOps Agent.

Penyiapan sumber menambahkan tujuh tool TrueWatch MCP:

list_checkers
list_logging_query_rules
list_dashboards
query_log_data
query_metric_data
query_trace_data
query_rum_data

Jangan memberikan semua tool kepada agen secara default. Untuk sistem produksi, mulailah dengan tool yang hanya membaca data. Hindari tool yang mengubah, menghapus, menulis, melakukan rollback, melakukan scaling, atau membisukan perilaku produksi, kecuali jalur persetujuan terpisah telah tersedia.

Klik Save setelah memilih tool yang diizinkan.

6. Mulai Investigasi Hanya-Baca

Setelah MCP Server dan izin tool dikonfigurasi, buka halaman detail Agent Space dan pilih Operator access.

Area ini mencakup tampilan operasional seperti topologi, kapabilitas, dan akses aplikasi web. Untuk uji coba pertama, buat tugas tetap sempit dan hanya-baca.

Klik Start investigation. Pada Investigation starting point, masukkan permintaan investigasi yang spesifik. Uji coba awal yang baik antara lain:

Analyze error logs from the last 15 minutes and group them by service and error type.

atau:

Find services with recent trace errors and summarize the evidence behind each finding.

Prompt harus memberi tahu agen bukti apa yang perlu diambil dan bagaimana merangkumnya.

Jika halaman menampilkan status seperti Fetching data atau Investigating, dan output menyertakan hasil dari tool MCP, berarti jalur koneksi berfungsi.

Demo: Analisis Log Error dalam 15 Menit Terakhir

Demo sumber menggunakan permintaan sederhana:

Analyze error logs from the last 15 minutes.

AWS DevOps Agent menafsirkan permintaan, menyusun rencana investigasi, memanggil tool TrueWatch MCP, lalu merangkum data yang dikembalikan.

Dalam alur sumber, agen:

melakukan kueri data error terbaru
mengelompokkan error berdasarkan tipe
mengidentifikasi layanan yang terdampak
menyertakan sampel log mentah
merangkum temuan utama

Tiga layanan, tiga mode kegagalan berbeda — seperti inilah wujud pemantauan microservices dalam praktik: error terkait layanan dan jendela waktu tertentu, bukan digabung menjadi satu insiden generik.

Contoh Bentuk Hasil

Pada jendela waktu demo, investigasi mengidentifikasi tiga kategori error.

Configuration Not Found

Tipe error: forethought.utils.exceptions.APIException
Kode error: ftLogackupCfgNoExists
Layanan: inner-api
Deskripsi: konfigurasi data forwarding tidak ditemukan

Query Timeout

Tipe error: errors.errorString
Layanan: kodo-inner
Deskripsi: internal server error akibat timeout kueri

Unknown API Error

Tipe error: forethought.utils.exceptions.APIException
Kode error: ft.CloudCareApiError
Layanan: front-api
Deskripsi: error API yang tidak diketahui

Yang berguna bukanlah fakta bahwa agen menghasilkan sebuah paragraf. Yang berguna adalah jawabannya dapat ditelusuri kembali ke pemanggilan tool, jendela waktu, layanan, sampel log, dan hasil kueri.

Pertanyaan yang Sering Diajukan

T: Haruskah AWS DevOps Agent memiliki akses tulis ke data TrueWatch? J: Tidak, setidaknya tidak di awal. Mulailah hanya dengan tool hanya-baca. Perluas ke tool yang mengubah, menghapus, atau melakukan rollback perilaku produksi hanya setelah Anda memiliki jalur persetujuan manusia yang terpisah.

T: Apa cara paling aman untuk menyiapkan API key untuk integrasi ini? J: Gunakan key khusus yang cakupannya hanya untuk koneksi agen ini — bukan key bersama atau tingkat admin. Praktik terbaiknya adalah izin yang dibatasi pada workspace, tanpa peran administrator yang luas, key terpisah untuk setiap lingkungan (dev/staging/produksi), dan kebijakan rotasi dengan pemilik yang jelas.

T: Bagaimana saya tahu integrasi ini benar-benar aman dijalankan di produksi? J: Periksa tiga hal setelah investigasi pertama Anda: cakupan data (apakah agen hanya melakukan kueri ke workspace/lingkungan/rentang waktu yang dituju?), cakupan tool (apakah setiap tool yang diaktifkan benar-benar digunakan — hapus yang tidak digunakan), dan kualitas bukti (apakah engineer dapat menelusuri jawaban kembali ke layanan, jendela waktu, tipe error, dan jalur kueri tertentu?).

T: Apa perbedaan antara TrueWatch MCP Server dan Toby AI Agents? J: MCP Server adalah lapisan antarmuka — memungkinkan klien AI memanggil tool observabilitas TrueWatch. Toby AI Agents adalah model operasi lengkap yang dibangun di atasnya: metodologi troubleshooting, batas izin, jejak bukti, alur persetujuan, perilaku berbasis peran, dan verifikasi pascatindakan. MCP menjawab "dapatkah agen melihat datanya?" — Toby AI Agents menjawab "haruskah agen bertindak, dan bagaimana kita mengelolanya?" Itulah yang sebenarnya dibutuhkan observabilitas agen AI yang siap produksi.

T: Apa yang harus saya hindari dengan penyiapan ini? J: Jangan memberikan semua tool yang tersedia kepada agen secara default. Jangan menyematkan rahasia di URL endpoint (dapat muncul di log AWS CloudTrail). Jangan melewati persetujuan manusia untuk tindakan apa pun yang mengubah status produksi. Jangan menjalankan uji coba pertama Anda di Agent Space produksi — gunakan workspace non-produksi terlebih dahulu.