Chuyển đến nội dung chính
Kết nối môi trường Dynatrace để agent CloudThinker liệt kê các problem đang mở, chạy DQL (Dynatrace Query Language) trên log, metric, span và sự kiện trong Grail, xem xét lỗ hổng và tìm các thực thể mà một problem ảnh hưởng tới. Kết nối dùng Dynatrace MCP server chính thức, đăng nhập bằng một platform token cho một môi trường.

Đ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.com khô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:run cù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)
Nhấn Generate và sao chép token. Dynatrace chỉ hiển thị token một lần. Token chỉ làm được những gì người dùng của nó được phép, nên hãy tạo token bằng một người dùng (hoặc service user) có quyền đọc dữ liệ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
Nhấn Connect.Trạng thái thành công: Dynatrace hiển thị Connected. Chạy prompt xác minh bên dưới để chắc chắn token đọc được môi trường của bạn.
Dùng platform token, không dùng API token classic của Dynatrace. API token classic không có các Platform scope mà MCP server cần, nên hầu hết yêu cầu sẽ thất bại với lỗi 401 hoặc 403.

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ới app-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.
Nếu DQL chạy được với loại dữ liệu này nhưng thất bại với loại khác, token đang thiếu scope storage:*:read của loại đó. Thêm scope trong Dynatrace và cập nhật token trong kết nối.

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

Bạn sẽ thấy thông tin môi trường, các problem đang mở cùng thực thể bị ảnh hưởng, và các lỗ hổng có điểm rủi ro từ 7.0 trở lên. Nếu token có các scope Davis, danh sách Davis analyzer cũng xuất hiện.

Ví dụ prompt

Với môi trường lớn, hãy nêu tên dịch vụ, thực thể hoặc bucket và một khoảng thời gian ngắn. Truy vấn hẹp trả kết quả nhanh hơn và tốn ít Grail budget hơn.

Khắc phục sự cố

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.
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 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.
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.
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:write hoặ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.