Nền tảng hỗ trợ
| Site | URL |
|---|---|
| US1 | app.datadoghq.com |
| US3 | us3.datadoghq.com |
| US5 | us5.datadoghq.com |
| EU1 | app.datadoghq.eu |
| AP1 | ap1.datadoghq.com |
| AP2 | ap2.datadoghq.com |
Điều kiện tiên quyết
Bạn cần có Datadog API key và Application key có phạm vi. Tạo API key:- Vào Organization Settings → API Keys trong tài khoản Datadog của bạn.
- Nhấn + New Key, đặt tên (ví dụ:
CloudThinker) và lưu. - Sao chép giá trị key.
- Vào Organization Settings → Application Keys.
- Nhấn + New Key, đặt tên (ví dụ:
CloudThinker). - Trong Scopes, chọn các quyền được liệt kê trong Quyền yêu cầu.
- Lưu và sao chép giá trị key.
Thiết lập
Chọn Datadog site của bạn
Chọn Datadog site phù hợp với tài khoản của bạn (ví dụ: US1 cho
datadoghq.com, EU1 cho datadoghq.eu).Chi tiết kết nối
| Trường | Mô tả | Ví dụ |
|---|---|---|
| Site | Datadog site phù hợp với tài khoản của bạn | US1 (datadoghq.com) |
| API Key | Datadog API key | — |
| Application Key | Datadog Application key với phạm vi rõ ràng | — |
Quyền yêu cầu
Chọn các phạm vi này khi tạo Application key. Các phạm vi đọc bao gồm tất cả công cụ điều tra;notebooks_write là tùy chọn và cho phép tạo notebook.
| Phạm vi | Tính năng cho phép |
|---|---|
logs_read_data, logs_read_index_data | Tìm kiếm và phân tích log |
metrics_read, timeseries_query | Truy vấn metric và dữ liệu time-series |
monitors_read | Tìm kiếm monitor theo trạng thái và tag |
incidents_read | Tìm kiếm sự cố và lấy chi tiết |
dashboards_read | Kiểm tra cấu hình dashboard |
hosts_read | Liệt kê và kiểm tra host hạ tầng |
apm_read | Lấy trace và tìm kiếm APM span |
apm_service_catalog_read | Liệt kê dịch vụ và ánh xạ phụ thuộc |
events_read | Tìm kiếm sự kiện platform và tùy chỉnh |
notebooks_read | Tìm kiếm và lấy notebook điều tra |
rum_apps_read | Tìm kiếm dữ liệu Real User Monitoring |
notebooks_write | Tạo và chỉnh sửa notebook điều tra (tùy chọn) |
Khả năng của agent
Sau khi kết nối, các agent có thể thực hiện thao tác đọc và ghi trên môi trường Datadog của bạn.| Khả năng | Những gì agent có thể làm |
|---|---|
| Log | Tìm kiếm log trên các dịch vụ và môi trường, phân tích mẫu và xu hướng |
| Metric | Tìm kiếm metric có sẵn, truy vấn dữ liệu time-series, lấy metadata metric |
| Monitor | Tìm monitor theo trạng thái, tên hoặc tag |
| Sự cố | Tìm kiếm sự cố đang hoạt động và đã giải quyết, lấy chi tiết đầy đủ |
| Dashboard | Tìm kiếm và kiểm tra cấu hình dashboard |
| Hạ tầng | Liệt kê và kiểm tra host trên hạ tầng của bạn |
| APM | Lấy distributed trace, tìm kiếm span để phân tích latency |
| Service catalog | Liệt kê dịch vụ và ánh xạ quan hệ phụ thuộc dịch vụ |
| Sự kiện | Tìm kiếm sự kiện platform và tùy chỉnh |
| Notebook | Tìm kiếm, lấy, tạo và chỉnh sửa notebook điều tra |
| RUM | Tìm kiếm dữ liệu Real User Monitoring |
| Sức khỏe kết nối | Xác nhận kết nối Datadog đang hoạt động |
Xác minh kết nối
Ví dụ prompt
Xử lý sự cố
Kiểm tra kết nối thất bại với 403
Kiểm tra kết nối thất bại với 403
Xác minh API key hợp lệ và chưa bị thu hồi. Xác nhận Application key có đúng phạm vi và cả hai key thuộc cùng tổ chức Datadog.
Thiếu dữ liệu sau khi kết nối
Thiếu dữ liệu sau khi kết nối
Kiểm tra phạm vi Application key bao gồm loại dữ liệu bạn đang truy vấn (ví dụ:
logs_read_data cho log). Xác minh cài đặt retention của Datadog và xác nhận dịch vụ hoặc host đang tích cực gửi dữ liệu.Chọn sai Datadog site
Chọn sai Datadog site
Nếu truy vấn trả về kết quả rỗng, bạn có thể đã chọn sai site. Kiểm tra URL Datadog của bạn —
app.datadoghq.com là US1, us3.datadoghq.com là US3, app.datadoghq.eu là EU1. Ngắt kết nối và kết nối lại với site đúng.Nhầm lẫn giữa API key và Application key
Nhầm lẫn giữa API key và Application key
Cả hai key đều cần thiết và phục vụ các vai trò khác nhau. API key xác thực yêu cầu. Application key kiểm soát tính năng và dữ liệu Datadog nào agent có thể truy cập. Một mình không đủ.
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.
- Application key có phạm vi — luôn chỉ định phạm vi rõ ràng; key không có phạm vi kế thừa đầy đủ quyền của người dùng tạo ra nó.
- Key riêng cho mỗi tích hợp — tạo API key và Application key riêng cho CloudThinker để bạn có thể thu hồi chúng độc lập.
Liên quan
Kết nối Grafana
Metric và dashboard thay thế
Kết nối PagerDuty
Cảnh báo sự cố và trực on-call