Điều kiện tiên quyết
- Một AppDynamics Controller (SaaS hoặc on-premises) chứa các ứng dụng bạn muốn giám sát.
- Một API client được tạo trong tài khoản của bạn, với Client Name và Client Secret.
- Controller URL và tên tài khoản của bạn.
Cấp cho API client vai trò chỉ đọc. CloudThinker chỉ đọc tình trạng ứng dụng, số liệu, vi phạm và sự kiện — không bao giờ thay đổi cấu hình AppDynamics.
Thiết lập
Mở AppDynamics Controller
Đăng nhập vào AppDynamics Controller với quyền admin. Controller URL của bạn theo định dạng
https://<account>.saas.appdynamics.com với SaaS, hoặc host on-premises của bạn.Tạo API client
Vào Settings → Administration → API Clients và nhấn Create:
- Client Name:
cloudthinker - Description:
Read-only access for CloudThinker agents - Roles: gán vai trò chỉ đọc với quyền truy cập vào các ứng dụng bạn muốn CloudThinker giám sát
Tìm tên tài khoản của bạn
Tên tài khoản xuất hiện trong Settings → License hoặc là tên miền phụ của Controller URL (ví dụ
myaccount trong https://myaccount.saas.appdynamics.com).Thêm kết nối trong CloudThinker
Điều hướng đến Connections → AppDynamics và nhập:
- Controller URL: URL cơ sở Controller của bạn
- Account Name: tên tài khoản AppDynamics của bạn
- Client Name: tên API client (ví dụ
cloudthinker@myaccount) - Client Secret: secret bạn vừa sao chép
Chi tiết kết nối
| Trường | Mô tả | Ví dụ |
|---|---|---|
| APPD_CONTROLLER_URL | URL cơ sở AppDynamics Controller của bạn | https://myaccount.saas.appdynamics.com |
| APPD_ACCOUNT_NAME | Tên tài khoản AppDynamics của bạn | myaccount |
| APPD_CLIENT_NAME | Tên API client | cloudthinker@myaccount |
| APPD_CLIENT_SECRET | Secret của API client | — |
Cả bốn trường đều bắt buộc — xác thực OAuth2 client credentials của AppDynamics cần Controller URL, tài khoản, tên client và secret để lấy access token.
Quyền yêu cầu
Gán cho API client một vai trò chỉ đọc với quyền truy cập vào các ứng dụng mà CloudThinker cần giám sát. Quyền đọc bao gồm ứng dụng, tier, node, business transaction, số liệu, vi phạm health rule và sự kiện.Khả năng của agent
Sau khi kết nối, các agent có quyền đọc dữ liệu APM AppDynamics của bạn.| Khả năng | Mô tả |
|---|---|
| Khám phá | Tóm tắt môi trường — ứng dụng, tier, node và các tín hiệu tình trạng gần đây |
| Tình trạng ứng dụng | Liệt kê ứng dụng và gắn cờ các vi phạm health rule hoặc business transaction bị suy giảm |
| Phân loại vi phạm | Liệt kê và kiểm tra các vi phạm health rule đang hoạt động, sắp xếp theo mức độ nghiêm trọng |
| Xem xét số liệu | Lấy thời gian phản hồi, lần gọi mỗi phút và tỷ lệ lỗi cho ứng dụng và business transaction |
| Phân tích sự kiện | Lấy các sự kiện lỗi gần đây và tóm tắt các loại lỗi hàng đầu theo tier bị ảnh hưởng |
Xác minh kết nối
Ví dụ lệnh
Khắc phục sự cố
401 hoặc 403 Unauthorized
401 hoặc 403 Unauthorized
Kết nối bị từ chối hoặc hết thời gian chờ
Kết nối bị từ chối hoặc hết thời gian chờ
Controller URL không thể truy cập từ CloudThinker. Xác minh Controller URL đúng và có thể truy cập, đồng thời xác nhận các Controller on-premises cho phép kết nối đến.
Không tìm thấy tài khoản
Không tìm thấy tài khoản
Tên tài khoản không khớp với Controller. Kiểm tra Settings → License hoặc tên miền phụ Controller của bạn và cập nhật APPD_ACCOUNT_NAME.
Không tìm thấy ứng dụng hoặc số liệu
Không tìm thấy ứng dụng hoặc số liệu
Vai trò của API client không có quyền truy cập vào các ứng dụng, hoặc tài khoản không có dữ liệu phù hợp. Xác nhận vai trò cấp quyền đọc cho các ứng dụng mục tiêu, rồi thử lại với tên ứng dụng đã biết.
Kết quả quá lớn hoặc quá nhiều dữ liệu
Kết quả quá lớn hoặc quá nhiều dữ liệu
Các truy vấn ứng dụng hoặc số liệu không giới hạn trả về quá nhiều dữ liệu. Giới hạn yêu cầu theo tên ứng dụng cụ thể và cửa sổ thời gian ngắn để kết quả luôn tập trung.
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.
- Controller URL dùng HTTPS — luôn sử dụng Controller URL dạng HTTPS để bảo vệ thông tin xác thực trong quá trình truyền.
- API client riêng biệt — tạo một client chỉ dành cho CloudThinker để có thể thu hồi độc lập mà không ảnh hưởng đến các tích hợp khác.
Liên quan
Kết nối Datadog
APM, số liệu và giám sát
Kết nối SigNoz
Trace, số liệu và log trong một nơi