Chuyển đến nội dung chính
Kết nối AppDynamics (Cisco) Controller để agent CloudThinker liệt kê ứng dụng, tier, node và business transaction, xếp hạng các transaction chậm nhất hoặc lỗi nhiều nhất, phân loại vi phạm health rule đang mở, và chỉ ra request chậm đã tốn thời gian ở cơ sở dữ liệu, lời gọi bên ngoài, hàng đợi hay code của chính bạn. Kết nối đăng nhập bằng API client của AppDynamics (OAuth2 client credentials), và mọi lệnh agent chạy trên Controller đều là thao tác đọc.

Đ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
Tạo secret và sao chép ngay. AppDynamics chỉ hiển thị secret một lần.Giữ thời hạn token ở giá trị mặc định. CloudThinker tự xin token ngắn hạn mới mỗi khi cần, nên thiết lập này không ảnh hưởng đến kết nối.
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
Nhấn Connect. CloudThinker chạy một lời gọi thử đến Controller bằng các thông tin xác thực này.Trạng thái thành công: AppDynamics hiển thị Connected. Chạy prompt xác minh bên dưới để chắc chắn client nhìn thấy các ứng dụng của bạn.
Nhập tên client không kèm @<account>. CloudThinker tự ghép OAuth2 client ID thành <APPD_CLIENT_NAME>@<APPD_ACCOUNT_NAME>, nên nếu nhập cloudthinker@myaccount vào trường tên, giá trị sẽ thành cloudthinker@myaccount@myaccount và thất bại với lỗi 401.

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

Kết quả mong đợi gồm tài khoản, danh sách ứng dụng với số tier và node, cùng các vi phạm đang mở. Danh sách ứng dụng trống thường có nghĩa là role không nhìn thấy ứng dụng nào.

Ví dụ prompt

Với Controller lớn, hãy nêu tên ứng dụng trong mọi prompt. Cách này giữ mỗi yêu cầu chỉ ở vài lời gọi.

Khắc phục sự cố

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.
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.
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.
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 đó.
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.