Điều kiện tiên quyết
- Một môi trường Dynatrace SaaS trên Dynatrace Platform (Grail), chứa dữ liệu bạn muốn agent đọc. Dynatrace Managed và các môi trường classic không có địa chỉ
apps.dynatrace.comkhông thể kết nối. - Một người dùng Dynatrace (hoặc service user) trong tài khoản của môi trường đó, có quyền đọc dữ liệu agent cần truy vấn. Mọi thành viên tài khoản đều tạo được platform token, nhưng token chỉ có đúng quyền của người dùng đó.
- URL môi trường theo định dạng Platform:
https://<environment-id>.apps.dynatrace.com.
Thiết lập
1
Tìm URL môi trường
Đăng nhập Dynatrace và sao chép địa chỉ trên trình duyệt đến hết
.apps.dynatrace.com, ví dụ https://abc12345.apps.dynatrace.com.Dùng địa chỉ apps.dynatrace.com, không dùng địa chỉ classic live.dynatrace.com. MCP server chỉ làm việc với Platform API.2
Tạo platform token
Mở My platform tokens trong tài khoản Dynatrace (myaccount.dynatrace.com/platformTokens) và chọn Platform token. Thiết lập:
- Token name:
cloudthinker - Expiration date: thời hạn phù hợp với chính sách xoay vòng của bạn
- Environments: môi trường bạn tìm được ở bước trước, trừ khi bạn áp dụng token cho toàn bộ tài khoản
- Scopes:
app-engine:apps:runcùng các scope đọc cho loại dữ liệu bạn muốn agent truy vấn (xem Quyền yêu cầu)
3
Thêm kết nối trong CloudThinker
Mở More → Workspace settings → Connections, giữ nguyên tab Builtin Connections và chọn Dynatrace. Điền:
- DT_ENVIRONMENT: URL môi trường của bạn
- DT_PLATFORM_TOKEN: token bạn vừa tạo
Chi tiết kết nối
Để truy cập môi trường khác, hãy thêm môi trường đó thành một kết nối riêng với token riêng.
Quyền yêu cầu
Bắt đầu vớiapp-engine:apps:run và chỉ thêm các scope đọc cho những loại dữ liệu agent cần truy vấn.
Các công cụ tùy chọn cần thêm scope. Chỉ thêm những scope cho công cụ bạn muốn agent dùng:
Danh sách đầy đủ có trong README của Dynatrace MCP server.
Khả năng của agent
Agent kiểm tra từng truy vấn DQL trước khi chạy và bắt đầu với 50 đến 100 bản ghi. Điều này quan trọng về chi phí: truy vấn DQL quét dữ liệu Grail, có thể được tính vào mức tiêu thụ Dynatrace của bạn (xem bảng giá Dynatrace). MCP server cũng giữ một Grail query budget, tức tổng lượng dữ liệu mà các truy vấn đã quét, và dừng truy vấn khi dùng hết. Mọi thao tác ghi đều đi qua Approvals, và lệnh gọi bị từ chối sẽ không được thử lại.
Xác minh kết nối
Ví dụ prompt
Khắc phục sự cố
Kết nối thất bại hoặc mọi yêu cầu trả về 401
Kết nối thất bại hoặc mọi yêu cầu trả về 401
Token bị thiếu, hết hạn, bị thu hồi hoặc là API token classic. Tạo platform token mới có
app-engine:apps:run, sửa kết nối và dán token vào DT_PLATFORM_TOKEN. Đồng thời kiểm tra DT_ENVIRONMENT dùng apps.dynatrace.com, không phải live.dynatrace.com.Một số truy vấn trả về 403
Một số truy vấn trả về 403
Token thiếu scope cho loại dữ liệu đó. Ví dụ, truy vấn log cần
storage:logs:read. Thêm scope trong Dynatrace và cập nhật kết nối.Truy vấn DQL không trả về dòng nào
Truy vấn DQL không trả về dòng nào
Truy vấn có thể nhắm vào bucket mà token không đọc được, khoảng thời gian không có dữ liệu, hoặc tên thực thể bị viết sai. Yêu cầu agent tìm thực thể theo tên trước, rồi chạy lại truy vấn trên một dịch vụ đã biết với khoảng thời gian ngắn.
Yêu cầu trả về 429
Yêu cầu trả về 429
Grail query budget đã dùng hết. Yêu cầu agent đặt lại budget (thao tác đặt lại đi qua Approvals như mọi thao tác ghi), rồi thu hẹp khoảng thời gian và giới hạn bản ghi để các truy vấn tiếp theo quét ít dữ liệu hơn.
Không tìm thấy thực thể hoặc problem (404)
Không tìm thấy thực thể hoặc problem (404)
Thực thể đã được đổi tên hoặc id bị sai. Yêu cầu agent tìm theo tên thay vì theo id.
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.
- Platform token, ưu tiên scope đọc: chỉ thêm
document:documents:writehoặc scope thông báo khi bạn muốn agent tạo notebook hoặc gửi tin nhắn qua Dynatrace. - Mỗi kết nối một token: tạo token chỉ dành cho CloudThinker để bạn có thể thu hồi mà không làm hỏng các công cụ khác.
Liên quan
Phân tích nguyên nhân gốc
Xem cách Resolve dùng dữ liệu quan sát để tìm ra thứ bị hỏng.
Approvals
Kiểm soát những thao tác ghi Dynatrace nào phải chờ người phê duyệt.