Điều kiện tiên quyết
- AppDynamics Controller, SaaS hoặc on-premises, đang giám sát các ứng dụng bạn quan tâm.
- Quyền admin trên Controller để tạo API client.
- Nếu Controller chạy on-premises: Controller phải nhận được HTTPS từ CloudThinker Cloud. Tài liệu này không công bố danh sách egress IP của CloudThinker: hãy hỏi đầu mối CloudThinker của bạn, hoặc liên hệ chúng tôi. Xem Tiếp cận dịch vụ trong mạng riêng để biết các phương án khác.
Thiết lập
1
Ghi lại Controller URL và tên tài khoản
Đăng nhập Controller và sao chép địa chỉ gốc, ví dụ
https://myaccount.saas.appdynamics.com. Bỏ mọi đường dẫn phía sau như /controller.Với SaaS, tên tài khoản thường là subdomain (myaccount trong ví dụ). Bạn cũng có thể xem tên này trong Settings → License.2
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: một role chỉ xem, nhìn thấy được các ứng dụng mà agent cần đọc
3
Thêm kết nối trong CloudThinker
Mở More → Workspace settings → Connections, giữ nguyên tab Builtin Connections và chọn AppDynamics. Điền đủ bốn trường:
- APPD_CONTROLLER_URL: URL gốc của Controller
- APPD_ACCOUNT_NAME: tên tài khoản
- APPD_CLIENT_NAME: chỉ tên client, ví dụ
cloudthinker - APPD_CLIENT_SECRET: secret bạn vừa sao chép
Chi tiết kết nối
Cả bốn trường đều bắt buộc. Để kết nối Controller thứ hai, thêm Controller đó thành một kết nối riêng với API client riêng.
Quyền yêu cầu
Gán cho API client một role chỉ xem, giới hạn trong các ứng dụng agent cần đọc. Agent cần nhìn thấy:
Agent không bao giờ thay đổi cấu hình AppDynamics, nên hãy tắt mọi quyền cấu hình và quản trị trên role này. Nếu một ứng dụng không xuất hiện trong kết quả, role đó không nhìn thấy ứng dụng ấy.
Khả năng của agent
Agent bắt đầu với khoảng thời gian ngắn, chẳng hạn 60 phút gần nhất, và chỉ mở rộng khi không thấy tín hiệu. Agent dùng đúng tên ứng dụng, tier và transaction lấy từ bước khám phá thay vì đoán ID.
Xác minh kết nối
Ví dụ prompt
Khắc phục sự cố
Kết nối thất bại với lỗi 401
Kết nối thất bại với lỗi 401
Tên client, secret hoặc tên tài khoản sai, hoặc tên client có kèm
@<account>. Kiểm tra APPD_CLIENT_NAME chỉ là tên trần và APPD_ACCOUNT_NAME khớp với Controller. Nếu secret bị mất hoặc đã được tạo lại, hãy tạo secret mới trong API Clients, rồi sửa kết nối.Kết nối hết thời gian chờ hoặc không truy cập được Controller
Kết nối hết thời gian chờ hoặc không truy cập được Controller
Kiểm tra APPD_CONTROLLER_URL: giá trị phải là địa chỉ gốc HTTPS, không có đường dẫn. Với Controller on-premises, xác nhận Controller nhận được lưu lượng HTTPS từ các egress IP của CloudThinker.
Không có ứng dụng hoặc số liệu nào trả về
Không có ứng dụng hoặc số liệu nào trả về
Role của API client không nhìn thấy các ứng dụng đó, hoặc Controller không có dữ liệu trong khoảng thời gian đã chọn. Cấp quyền xem cho ứng dụng, rồi thử lại với một tên ứng dụng đã biết và khoảng một giờ gần nhất.
Không tìm thấy ứng dụng hoặc transaction (404)
Không tìm thấy ứng dụng hoặc transaction (404)
Tên bị viết sai hoặc ứng dụng đã được đổi tên. Yêu cầu agent liệt kê ứng dụng hoặc business transaction trước, rồi dùng đúng tên đó.
Yêu cầu trả về 429 hoặc 503
Yêu cầu trả về 429 hoặc 503
Controller đang giới hạn tần suất hoặc quá tải. Đợi một phút, thu hẹp khoảng thời gian rồi hỏi lại.
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.
- Chỉ đọc theo thiết kế: agent chỉ đọc ứng dụng, số liệu, vi phạm, sự kiện và snapshot. Agent không có lệnh nào thay đổi Controller.
- API client riêng: tạo client chỉ dành cho CloudThinker để bạn thu hồi được mà không làm hỏng công cụ khác.
- Chỉ dùng HTTPS: luôn dùng Controller URL dạng
https://để secret của client được bảo vệ khi truyền.
Liên quan
Phân tích nguyên nhân gốc
Xem cách Resolve dùng dữ liệu APM để tìm ra thứ bị hỏng.
Tổng quan kết nối
Thêm cloud, log và code để hoàn thiện bức tranh.