Đ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.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.
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.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
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 Giá trị
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: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.
Khắc phục sự cố
401 hoặc 403 ở bước Verifying hoặc ở mọi lệnh gọi
401 hoặc 403 ở bước Verifying hoặc ở mọi lệnh gọi
- 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.
403 Forbidden ở một số câu hỏi nhưng không phải tất cả
403 Forbidden ở một số câu hỏi nhưng không phải tất cả
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.Không tìm thấy metric hoặc service
Không tìm thấy metric hoặc service
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ề.
429 Too Many Requests
429 Too Many Requests
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