Chuyển đến nội dung chính
Kết nối Datadog để CloudThinker phân loại các monitor đang cảnh báo, tìm kiếm log, truy vấn metric, lần theo trace, và đọc sự cố, host và dashboard. CloudThinker truy cập Datadog qua Datadog MCP server, xác thực bằng một API key cùng một application key chỉ được cấp scope đọc. Datadog có hai phần thiết lập riêng biệt. Muốn phân tích nguyên nhân gốc tự động cho cảnh báo Datadog, bạn cần cả hai.

Điều kiện tiên quyết

  • Một Datadog organization trên một trong các site: US1, US3, US5, EU1, AP1 hoặc AP2. Datadog MCP server không hỗ trợ các site dành cho chính phủ (ddog-gov.com).
  • MCP Access đã được bật trong Organization Settings của Datadog. Admin Datadog chỉ cần bật một lần cho mỗi organization.
  • Quyền tạo API key và application key trong Datadog.
  • Quyền thêm kết nối trong workspace CloudThinker.

Thiết lập

1

Xác định site

Xem thanh địa chỉ khi bạn đã đăng nhập Datadog:
2

Tạo API key

Trong Datadog, vào Organization Settings → API Keys, nhấn New Key, đặt tên cloudthinker và sao chép giá trị.
3

Tạo application key giới hạn scope

Khuyến nghị: tạo key trên một service account của Datadog có Datadog Read Only Role, để key không phụ thuộc vào quyền của một cá nhân. Vào Organization Settings → Service Accounts, tạo cloudthinker với role đó, rồi thêm application key cho service account này.Nếu không, vào Organization Settings → Application Keys và nhấn New Key.Dù chọn cách nào, hãy đặt tên key là cloudthinker và chọn các scope trong Quyền yêu cầu. Lưu và sao chép key ngay.
Application key không có scope sẽ thừa hưởng mọi quyền của người sở hữu, kể cả quyền ghi. Luôn chọn scope.
Trạng thái thành công: danh sách scope của key chỉ có quyền đọc, không có mục _write nào.
4

Thêm kết nối

Mở More → Workspace settings → Connections, giữ nguyên tab Builtin Connections, rồi chọn Datadog. Điền:
  • Alias (không bắt buộc): tên ngắn như datadog-prod. Chỉ gồm chữ thường, số và dấu gạch ngang.
  • Description (không bắt buộc): organization hoặc môi trường của kết nối này. Agent đọc mô tả để chọn đúng instance.
  • DD_API_KEY: API key.
  • DD_APPLICATION_KEY: application key.
  • DD_SITE: site bạn xác định ở bước 1.
Nhấn Connect. CloudThinker hiển thị Connecting và Verifying, rồi chuyển sang trạng thái Connected. Ở bước Verifying, CloudThinker mở một phiên với Datadog MCP server của site bạn chọn và liệt kê các tool của server. Bước này không chạy truy vấn dữ liệu, nên một scope bị thiếu chỉ lộ ra về sau dưới dạng lỗi 403 khi bạn hỏi về loại dữ liệu đó. Nếu xác minh thất bại, kết nối hiển thị Failed kèm thông báo lỗi. Đối chiếu thông báo với phần Khắc phục sự cố.

Chi tiết kết nối

Bạn cần cả hai key. CloudThinker gửi chúng tới Datadog MCP server của site bạn trong mọi lệnh gọi.

Quyền yêu cầu

Datadog MCP server kiểm tra quyền của chính Datadog trong mọi lệnh gọi. Chọn các hàng tương ứng với dữ liệu bạn muốn CloudThinker xem.
Bỏ qua mcp_write và mọi scope _write. Các cuộc điều tra Datadog của CloudThinker chỉ đọc dữ liệu.

Khả năng của agent

Khi kết nối lần đầu đạt trạng thái Connected, CloudThinker chạy một lượt khám phá chỉ đọc và lưu kết quả cho các cuộc trò chuyện sau.

Xác minh kết nối

Câu trả lời đúng sẽ đếm số monitor ở các trạng thái OK, Alert, Warn và No Data, và nêu tên những monitor đang cảnh báo.

Ví dụ prompt

Gửi cảnh báo Datadog tới Resolve

Resolve có sẵn preset cho Datadog, nên Resolve → Triggers & Outcomes điền sẵn phần ánh xạ trường và mức độ nghiêm trọng cho bạn. Webhook Signals giải thích đầy đủ hộp thoại này; các bước dưới đây là phần riêng cho Datadog. Với công cụ không có preset, xem Kết nối nguồn cảnh báo.
1

Tạo webhook trong CloudThinker

Vào Resolve → Triggers & Outcomes, chọn Datadog, rồi trong Signals to Resolve nhấn Add signal. Lần lượt qua Basic Info, Configure và Advanced, rồi nhấn Create. Sao chép Webhook URL và Secret Key. Secret Key chỉ hiển thị một lần.
2

Trỏ phần ánh xạ tới một service

Preset đọc title, body và alert_type, nhưng Service Path mặc định là tags, vốn trỏ tới một danh sách nên không ánh xạ ra giá trị nào. Trong Field Mapping, đổi Service Path thành service, rồi gửi key đó trong payload bên dưới. Xem Ánh xạ các trường.
3

Thêm các hàng mức độ nghiêm trọng mà monitor gửi

Severity Mapping của preset gồm alert, warn, ok và no data, trong khi $ALERT_TYPE của Datadog gửi error, warning, info hoặc success. Trong Severity Mapping, nhấn Customize, rồi nhấn Add Mapping cho từng giá trị mà monitor của bạn gửi. Giá trị chưa được ánh xạ sẽ nhận mức medium.
4

Thêm webhook trong Datadog

Trong Datadog, mở Integrations → Webhooks và thêm một webhook tên CloudThinker. Dán Webhook URL vào URL, và điền nội dung sau vào ô Custom Headers: {"Authorization": "Bearer <your-secret-key>"}. Dùng payload như sau:
Giá trị service cố định sẽ áp dụng cho mọi monitor gửi thông báo tới webhook này. Secret được lưu trong cấu hình webhook của Datadog, nên ai quản lý được integration đó cũng đọc được secret. Hãy giới hạn quyền truy cập này, và dùng Regenerate credentials trên hàng webhook trong Resolve nếu secret bị lộ.
5

Cho monitor gửi thông báo tới webhook

Thêm @webhook-CloudThinker vào message của từng monitor cần mở sự cố. Để chỉ gửi cảnh báo mà không gửi thông báo phục hồi, đặt mention trong điều kiện alert của Datadog:
6

Gửi một event thử

Nhấn Test Notifications trên một monitor, hoặc dùng tab cURL trong Integration Examples của hộp thoại webhook.
Trạng thái thành công: cảnh báo tiếp theo từ monitor đó xuất hiện trong Pulse, luồng cảnh báo của Resolve, với tiêu đề của monitor, và agent điều tra cảnh báo qua kết nối này.

Khắc phục sự cố

  • DD_SITE không khớp với organization. Key Datadog chỉ hoạt động trên site của chính nó, nên hãy so sánh với URL Datadog theo bảng ở bước 1, rồi sửa kết nối.
  • Một trong hai key sai, đã bị thu hồi hoặc thuộc một Datadog organization khác. Tạo key mới trong cùng organization và cập nhật kết nối từ bảng chi tiết của nó.
  • MCP Access đang tắt cho organization, hoặc application key thiếu mcp_read.
Application key thiếu scope cho loại dữ liệu đó, ví dụ thiếu apm_read khi hỏi về trace. Thêm scope trong Organization Settings → Application Keys.
CloudThinker tìm tên metric và service trước khi truy vấn. Hãy yêu cầu liệt kê các metric khớp với một tên, rồi dùng đúng tên mà CloudThinker trả về.
Datadog đang giới hạn tần suất request của các key. Hãy hỏi hẹp hơn với khoảng thời gian ngắn hơn, hoặc thử lại sau một phút.

Bảo mật

  • Quyền tối thiểu — chỉ cấp các quyền mà agent cần cho trường hợp sử dụng của bạn; bắt đầu với quyền chỉ đọc và mở rộng sau.
  • Chỉ đọc theo mặc định — sử dụng thông tin xác thực chỉ đọc trừ khi bạn muốn agent thực hiện thay đổi qua kết nối này.
  • Xoay vòng thông tin xác thực — xoay vòng khóa và token theo lịch trình thông thường của bạn; CloudThinker sẽ lấy giá trị mới khi bạn cập nhật kết nối.
  • Thu hồi khi bàn giao — xóa thông tin xác thực tại nhà cung cấp khi bạn xóa một kết nối hoặc khi đồng nghiệp rời nhóm.
  • Giới hạn scope cho application key: key không có scope mang toàn bộ quyền của người tạo, kể cả quyền ghi.
  • Key riêng: tạo key chỉ dành cho CloudThinker để bạn có thể thu hồi mà không ảnh hưởng tới các integration khác.

Liên quan

Webhook Signals

Ánh xạ các trường của cảnh báo và chọn khi nào CloudThinker điều tra

Kết nối PagerDuty

Gửi sự cố PagerDuty tới Resolve