เอเจนต์ด้านปฏิบัติการจะมีประโยชน์ก็ต่อเมื่อมองเห็นระบบที่ถูกขอให้ตรวจสอบ
AWS DevOps Agent เป็นจุดเริ่มต้นด้วยภาษาธรรมชาติสำหรับงานปฏิบัติการบนคลาวด์ ส่วน TrueWatch MCP Server ช่วยให้เอเจนต์นี้สืบค้นข้อมูล Observability ได้อย่างควบคุมได้ ไม่ว่าจะเป็นล็อก เมตริก เทรซ ข้อมูล RUM แดชบอร์ด มอนิเตอร์ และบริบทการสืบสวนที่เกี่ยวข้อง เมื่อใช้ร่วมกัน วิศวกรสามารถเริ่มจากคำถามบน Production เช่น “อะไรเปลี่ยนไปช่วงที่เกิดข้อผิดพลาดพุ่งสูง?” แล้วให้เอเจนต์รวบรวมหลักฐานผ่านเครื่องมือที่กำหนดขอบเขตไว้ แทนการเดาจากบริบทของพรอมต์
คู่มือนี้อธิบายขั้นตอนการเชื่อมต่อเชิงปฏิบัติ โปรดมองว่าเป็นรูปแบบการผสานรวม ไม่ใช่โมเดลการอนุญาตสิทธิ์ MCP ตอบคำถามด้านอินเทอร์เฟซว่าเอเจนต์เรียกใช้เครื่องมือ Observability ที่เหมาะสมได้หรือไม่ แต่การใช้งานจริงบน Production ยังต้องมีขอบเขตระดับ Workspace คีย์ที่มีสิทธิ์น้อยที่สุด ค่าเริ่มต้นแบบอ่านอย่างเดียว การอนุมัติสำหรับการกระทำที่มีผลข้างเคียง และบันทึกตรวจสอบการเรียกใช้เครื่องมือ
AWS DevOps Agent เพิ่มอะไรให้
AWS DevOps Agent คือผู้ช่วยด้านปฏิบัติการด้วย AI จาก AWS ซึ่งเป็นเอเจนต์ AI DevOps ที่ออกแบบมาเพื่อช่วยผู้ใช้ทำงานกับทรัพยากรคลาวด์ แก้ไขปัญหา และสร้างผลลัพธ์ที่เกี่ยวกับโครงสร้างพื้นฐานผ่านการโต้ตอบด้วยภาษาธรรมชาติ
สำหรับงาน Observability ประเด็นสำคัญไม่ใช่ตัวอินเทอร์เฟซแชต แต่คุณค่ามาจากการเชื่อมต่อเอเจนต์กับสัญญาณล่าสุดจาก Production และจำกัดขอบเขตการเข้าถึงนั้น หากไม่มีการเชื่อมต่อ เอเจนต์ทำได้เพียงอธิบายรูปแบบความล้มเหลวที่น่าจะเป็น แต่เมื่อมีการเชื่อมต่อ MCP ที่กำหนดขอบเขต เอเจนต์จะตรวจสอบเทเลเมทรีปัจจุบันและอ้างอิงหลักฐานที่ใช้ได้
TrueWatch MCP Server เพิ่มอะไรให้
TrueWatch คือแพลตฟอร์ม Observability สำหรับวิศวกรที่ดูแลระบบ Production สมัยใหม่ รวมการมอนิเตอร์โครงสร้างพื้นฐาน การมอนิเตอร์ประสิทธิภาพแอปพลิเคชัน (APM) การจัดการล็อก Distributed Traces, RUM แดชบอร์ด การแจ้งเตือน และข้อมูลทรัพยากรคลาวด์ ไว้ในบริบทการสืบสวนเดียวกัน
TrueWatch MCP Server เปิดให้ไคลเอนต์ที่รองรับ MCP ใช้ความสามารถบางส่วนของ TrueWatch ในบทความนี้ AWS DevOps Agent เชื่อมต่อกับ TrueWatch MCP Server และได้รับชุดเครื่องมือที่เน้นการอ่าน เช่น
- list_checkers
- list_logging_query_rules
- list_dashboards
- query_log_data
- query_metric_data
- query_trace_data
- query_rum_data
เริ่มต้นด้วยเครื่องมือแบบอ่านอย่างเดียว ให้เอเจนต์ดึงหลักฐาน สรุป และเสนอขั้นตอนถัดไป ก่อนขยายสิทธิ์ไปยังเวิร์กโฟลว์ที่เปลี่ยนแปลงระบบ Production
เส้นทางการผสานรวม
โฟลว์การผสานรวมเป็นดังนี้
AWS DevOps Agent -> MCP Server registration -> TrueWatch MCP Server -> TrueWatch observability dataหน้าจอ AWS อาจเปลี่ยนแปลงได้ แต่ลำดับการทำงานโดยรวมยังคุ้นเคย คือ ลงทะเบียน MCP Server เพิ่มรายละเอียด Endpoint และการยืนยันตัวตน เชื่อมเซิร์ฟเวอร์เข้ากับ Agent Space เลือกเครื่องมือที่อนุญาต และรันการสืบสวนแบบอ่านอย่างเดียวเพื่อตรวจสอบเส้นทาง
1. เปิดหน้าลงทะเบียน MCP Server
เปิดคอนโซล AWS DevOps Agent ในเมนูฟังก์ชัน ไปที่ Setting แล้วเลือก Register หน้าลงทะเบียนจะแสดงรายการการผสานรวมของบุคคลที่สาม เช่น GitLab, ServiceNow, Slack และ MCP Server เลือก MCP Server เพื่อเริ่มขั้นตอนลงทะเบียน TrueWatch MCP Server
เมื่อเริ่มขั้นตอนการเชื่อมโยงสำเร็จ หน้าจอควรแสดงข้อความคล้ายกับ
AWS DevOps Agent MCP Server associated successfully2. กำหนดค่า Endpoint ของ TrueWatch MCP Server
ในหน้ารายละเอียด MCP Server ให้ตั้งค่าหลักให้ครบถ้วน
ยืนยันโปรโตคอลการส่งข้อมูล
MCP Server ต้องรองรับ Streamable HTTP transport โปรดยืนยันก่อนเพิ่ม Endpoint
เลือกโฟลว์การให้สิทธิ์
เปิด Authorization configuration แล้วเลือกวิธีการให้สิทธิ์ที่ตรงกับการตั้งค่า TrueWatch MCP Server ของคุณ
ตั้งชื่อเซิร์ฟเวอร์
ในช่อง Name ให้ใช้ชื่อที่ชัดเจน เช่น
TrueWatch MCP Serverหากดูแลหลาย Workspace ให้ใช้ชื่อที่ระบุสภาพแวดล้อม เช่น TrueWatch MCP Server - Production Read Only
เพิ่ม Endpoint URL
ในช่อง Endpoint URL ให้เพิ่ม Endpoint ของ TrueWatch MCP Server สำหรับ Workspace ของคุณ
ตัวอย่างรูปแบบเป้าหมาย
https://toby-ai.truewatch.com/toby_ai_mcp/mcpโปรดยืนยัน Endpoint สุดท้ายจากเอกสาร TrueWatch ฉบับปัจจุบันก่อนเผยแพร่หรือแชร์คู่มือนี้ URL นี้อาจปรากฏในล็อก AWS CloudTrail ด้วย จึงไม่ควรฝังความลับไว้ใน Endpoint
หากหน้าจอมีช่อง Description ให้เพิ่มหมายเหตุสั้นๆ เกี่ยวกับการใช้งาน เช่น
Read-only observability tools for production investigation.เปิดใช้ Dynamic Client Registration เฉพาะเมื่อสอดคล้องกับนโยบายความปลอดภัยของคุณ ฟีเจอร์นี้ช่วยให้ DevOps Agent ลงทะเบียนกับเซิร์ฟเวอร์การให้สิทธิ์ของ MCP ระหว่างขั้นตอนการตั้งค่า
คลิก Next เมื่อกำหนดค่า Endpoint เรียบร้อย
3. ใช้การให้สิทธิ์ด้วย API Key
AWS DevOps Agent รองรับโฟลว์การให้สิทธิ์ เช่น OAuth Client Credentials, OAuth 3LO และ API Key การตั้งค่าต้นแบบใช้การให้สิทธิ์ด้วย API Key สำหรับ TrueWatch MCP Server
โฟลว์นี้ไม่ต้องรีไดเรกต์ผ่านเบราว์เซอร์ และให้แอปพลิเคชันที่เรียกใช้มีเส้นทางยืนยันตัวตนโดยตรง บน Production ควรใช้คีย์เฉพาะสำหรับการเชื่อมต่อเอเจนต์นี้ และจำกัดขอบเขตให้เข้าถึงเฉพาะข้อมูลและเครื่องมือที่จำเป็นน้อยที่สุด
กำหนดค่า Header
ตั้งชื่อ Header แบบคงที่เป็น
Authorizationกำหนดค่าของ API Key
ใช้รูปแบบ API Key และ Site Key ตามที่เอกสาร TrueWatch MCP Server กำหนด การตั้งค่าต้นแบบใช้ค่ารวมดังนี้
<TRUEWATCH_API_KEY>-<SITE_KEY>โดย
- <TRUEWATCH_API_KEY> คือ API Key ที่สร้างไว้ใน Workspace ของ TrueWatch
- <SITE_KEY> ระบุภูมิภาคหรือไซต์ของการติดตั้ง TrueWatch
สร้างหรือตรวจสอบ API Key
ในคอนโซล TrueWatch เปิด System Settings แล้วไปที่ API Keys สร้างคีย์สำหรับการผสานรวมนี้ หรือตรวจสอบคีย์ที่มีอยู่
สำหรับเอเจนต์ด้านปฏิบัติการ จุดเริ่มต้นที่ปลอดภัยกว่าคือ
- สิทธิ์แบบอ่านอย่างเดียว
- สิทธิ์ที่จำกัดตาม Workspace
- ไม่ใช้บทบาทผู้ดูแลระบบที่กว้างเกินไป
- แยกคีย์สำหรับ Development, Staging และ Production
- มีนโยบายการหมุนเวียนคีย์และข้อมูลเจ้าของ
แมป Site Key
ภูมิภาคการติดตั้งของ TrueWatch แมปไปยัง OpenAPI Endpoint ที่ต่างกัน โปรดยืนยันการแมปปัจจุบันก่อนใช้งานบน Production บล็อกฉบับภาษาอังกฤษสามารถแสดงรูปแบบโดยไม่เปิดเผยรายละเอียดการติดตั้งภายใน ดังนี้
const SITE_KEY_MAP = { us1: 'https://us1-openapi.truewatch.com', eu1: 'https://eu1-openapi.truewatch.com', ap1: 'https://ap1-openapi.truewatch.com',};หลังตรวจสอบการกำหนดค่าแล้ว คลิก Previous หากต้องการตรวจสอบการตั้งค่าก่อนหน้า จากนั้นคลิก Next เพื่อส่ง หากตั้งค่าสำเร็จ ควรเห็นข้อความการเชื่อมโยง MCP Server
4. เชื่อม MCP Server เข้ากับ Agent Space
กลับไปที่หน้าหลักของ AWS DevOps Agent แล้วเปิด Agent Spaces
Agent Spaces ควบคุมช่วงการเข้าถึง ขอบเขตความสามารถ และขอบเขตการปฏิบัติการของ DevOps Agent ใช้ Space แยกกันเมื่อต้องการแยกทีม สภาพแวดล้อม หรือระดับความเสี่ยงออกจากกัน
เปิด Agent Space เป้าหมาย คลิก View details แล้วค้นหา MCP Server
5. เพิ่มเครื่องมือ MCP และบันทึกการกำหนดค่า
ในหน้าเครื่องมือของ MCP Server ให้เลือกเครื่องมือที่ AWS DevOps Agent ได้รับอนุญาตให้เรียกใช้
การตั้งค่าต้นแบบเพิ่มเครื่องมือ TrueWatch MCP เจ็ดรายการ
- list_checkers
- list_logging_query_rules
- list_dashboards
- query_log_data
- query_metric_data
- query_trace_data
- query_rum_data
อย่าให้เอเจนต์ใช้เครื่องมือทั้งหมดเป็นค่าเริ่มต้น สำหรับระบบ Production ให้เริ่มจากเครื่องมือที่อ่านข้อมูลเท่านั้น หลีกเลี่ยงเครื่องมือที่แก้ไข ลบ เขียน ย้อนกลับ ปรับขนาด หรือปิดเสียงพฤติกรรมของ Production เว้นแต่จะมีเส้นทางการอนุมัติแยกต่างหาก
คลิก Save หลังเลือกเครื่องมือที่อนุญาตแล้ว
6. เริ่มการสืบสวนแบบอ่านอย่างเดียว
หลังกำหนดค่า MCP Server และสิทธิ์ของเครื่องมือแล้ว ให้เปิดหน้ารายละเอียด Agent Space และเลือก Operator access
ส่วนนี้มีมุมมองด้านปฏิบัติการ เช่น โทโพโลยี ความสามารถ และการเข้าถึงเว็บแอปพลิเคชัน สำหรับการทดสอบครั้งแรก ให้กำหนดงานให้แคบและเป็นแบบอ่านอย่างเดียว
คลิก Start investigation ใน Investigation starting point ให้ป้อนคำขอสืบสวนที่เฉพาะเจาะจง ตัวอย่างการทดสอบครั้งแรกที่ดี ได้แก่
Analyze error logs from the last 15 minutes and group them by service and error type.หรือ:
Find services with recent trace errors and summarize the evidence behind each finding.พรอมต์ควรบอกเอเจนต์ว่าต้องดึงหลักฐานอะไรและสรุปอย่างไร
หากหน้าจอแสดงสถานะ เช่น Fetching data หรือ Investigating และผลลัพธ์มีข้อมูลจากเครื่องมือ MCP แสดงว่าเส้นทางการเชื่อมต่อทำงานได้
เดโม: วิเคราะห์ล็อกข้อผิดพลาดใน 15 นาทีที่ผ่านมา
เดโมต้นแบบใช้คำของ่ายๆ ดังนี้
Analyze error logs from the last 15 minutes.AWS DevOps Agent ตีความคำขอ จัดทำแผนการสืบสวน เรียกใช้เครื่องมือ TrueWatch MCP และสรุปข้อมูลที่ได้กลับมา
ในโฟลว์ต้นแบบ เอเจนต์ได้
- สืบค้นข้อมูลข้อผิดพลาดล่าสุด
- จัดกลุ่มข้อผิดพลาดตามประเภท
- ระบุบริการที่ได้รับผลกระทบ
- แนบตัวอย่างล็อกดิบ
- สรุปข้อค้นพบสำคัญ
สามบริการ สามรูปแบบความล้มเหลวที่ต่างกัน นี่คือภาพจริงของการมอนิเตอร์ไมโครเซอร์วิส คือข้อผิดพลาดที่ผูกกับบริการและช่วงเวลาเฉพาะ ไม่ถูกรวมเป็นเหตุการณ์ทั่วไปเพียงเหตุการณ์เดียว
รูปแบบผลลัพธ์ตัวอย่าง
ในช่วงเวลาของเดโม การสืบสวนระบุข้อผิดพลาดได้สามหมวดหมู่
ไม่พบการกำหนดค่า
- ประเภทข้อผิดพลาด: forethought.utils.exceptions.APIException
- รหัสข้อผิดพลาด: ftLogackupCfgNoExists
- บริการ: inner-api
- คำอธิบาย: ไม่พบการกำหนดค่าการส่งต่อข้อมูล
คิวรีหมดเวลา
- ประเภทข้อผิดพลาด: errors.errorString
- บริการ: kodo-inner
- คำอธิบาย: ข้อผิดพลาดภายในเซิร์ฟเวอร์ที่เกิดจากคิวรีหมดเวลา
ข้อผิดพลาด API ที่ไม่ทราบสาเหตุ
- ประเภทข้อผิดพลาด: forethought.utils.exceptions.APIException
- รหัสข้อผิดพลาด: ft.CloudCareApiError
- บริการ: front-api
- คำอธิบาย: ข้อผิดพลาด API ที่ไม่ทราบสาเหตุ
ส่วนที่มีประโยชน์ไม่ใช่การที่เอเจนต์เขียนย่อหน้าออกมา แต่คือการที่คำตอบสามารถย้อนกลับไปยังการเรียกใช้เครื่องมือ ช่วงเวลา บริการ ตัวอย่างล็อก และผลคิวรีได้
คำถามที่พบบ่อย
Q: AWS DevOps Agent ควรมีสิทธิ์เขียนข้อมูล TrueWatch หรือไม่? A: ไม่ ไม่ใช่ในช่วงแรก เริ่มด้วยเครื่องมือแบบอ่านอย่างเดียวเท่านั้น ขยายไปยังเครื่องมือที่แก้ไข ลบ หรือย้อนกลับพฤติกรรมของ Production ก็ต่อเมื่อมีเส้นทางการอนุมัติโดยมนุษย์แยกต่างหากแล้ว
Q: วิธีตั้งค่า API Key ที่ปลอดภัยที่สุดสำหรับการผสานรวมนี้คืออะไร? A: ใช้คีย์เฉพาะที่จำกัดขอบเขตเพียงการเชื่อมต่อเอเจนต์นี้ ไม่ใช่คีย์ที่ใช้ร่วมกันหรือระดับผู้ดูแลระบบ แนวปฏิบัติที่ดีที่สุดคือสิทธิ์ระดับ Workspace ไม่ใช้บทบาทผู้ดูแลระบบที่กว้างเกินไป แยกคีย์ตามสภาพแวดล้อม (dev/staging/production) และมีนโยบายการหมุนเวียนพร้อมเจ้าของที่ระบุชื่อ
Q: จะรู้ได้อย่างไรว่าการผสานรวมนี้ปลอดภัยพอที่จะรันกับ Production? A: ตรวจสามเรื่องหลังการสืบสวนครั้งแรก ได้แก่ ขอบเขตข้อมูล (เอเจนต์สืบค้นเฉพาะ Workspace/สภาพแวดล้อม/ช่วงเวลาที่ตั้งใจหรือไม่) ขอบเขตเครื่องมือ (เครื่องมือที่เปิดใช้ทุกตัวถูกใช้จริงหรือไม่ หากไม่ใช่ให้นำออก) และคุณภาพของหลักฐาน (วิศวกรสามารถย้อนคำตอบไปยังบริการ ช่วงเวลา ประเภทข้อผิดพลาด และเส้นทางคิวรีที่เฉพาะเจาะจงได้หรือไม่)
Q: TrueWatch MCP Server ต่างจาก Toby AI Agents อย่างไร? A: MCP Server คือเลเยอร์อินเทอร์เฟซ ช่วยให้ไคลเอนต์ AI เรียกใช้เครื่องมือ Observability ของ TrueWatch ได้ ส่วน Toby AI Agents คือโมเดลการปฏิบัติงานแบบครบวงจรที่สร้างอยู่ด้านบน ประกอบด้วยวิธีการแก้ไขปัญหา ขอบเขตสิทธิ์ ร่องรอยหลักฐาน โฟลว์การอนุมัติ พฤติกรรมตามบทบาท และการตรวจสอบหลังการดำเนินการ MCP ตอบคำถามว่า “เอเจนต์มองเห็นข้อมูลได้หรือไม่?” ส่วน Toby AI Agents ตอบว่า “เอเจนต์ควรลงมือทำหรือไม่ และเราจะกำกับดูแลอย่างไร?” นี่คือสิ่งที่ Observability สำหรับเอเจนต์ AI ที่พร้อมใช้งานจริงบน Production ต้องการ
Q: ควรหลีกเลี่ยงอะไรเมื่อใช้การตั้งค่านี้? A: อย่าให้เอเจนต์ใช้เครื่องมือทั้งหมดที่มีเป็นค่าเริ่มต้น อย่าฝังความลับไว้ใน URL ของ Endpoint (อาจปรากฏในล็อก AWS CloudTrail) อย่าข้ามการอนุมัติโดยมนุษย์สำหรับการกระทำใดๆ ที่เปลี่ยนสถานะของ Production และอย่ารันการทดสอบครั้งแรกใน Agent Space ของ Production ให้ใช้ Workspace ที่ไม่ใช่ Production ก่อน
