Tìm hiểu vấn đề

Bạn đang xem tài liệu về Apigee Edge.
Chuyển đến tài liệu về Apigee X.
thông tin

Trang tổng quan Điều tra cho phép bạn xem bảng tổng hợp về các chỉ số và thuộc tính cho tất cả lưu lượng truy cập API và so sánh hoạt động liên quan giữa các chỉ số để điều tra và chẩn đoán vấn đề nhanh hơn. Bạn có thể truy cập dữ liệu trong 30 ngày qua trên trang tổng quan.

Chọn Phân tích > Giám sát API > Điều tra trong giao diện người dùng Edge để mở trang tổng quan Investivate. Trang tổng quan có hai khu vực chính:

  • Mã trạng thái cho phép bạn kiểm tra các chỉ số về mã trạng thái cho các proxy API và dịch vụ mục tiêu.
  • Độ trễ cho phép bạn điều tra các vấn đề về độ trễ đối với proxy API và dịch vụ mục tiêu.

Bạn cũng có thể điều tra các vấn đề do một cảnh báo cụ thể gây ra trong trang Điều tra trang tổng quan. Khi cảnh báo xảy ra, hãy nhấp vào tên của cảnh báo đó trong trang Lịch sử cảnh báo để mở cảnh báo trong trang tổng quan Invesitgate.

Dùng trang Điều tra trang tổng quan để chẩn đoán vấn đề

Ví dụ: bạn nhận được cảnh báo cho biết tỷ lệ lỗi 5xx vượt quá ngưỡng được chỉ định. Để điều tra vấn đề này, bạn có thể thực hiện các thao tác sau trên trang Điều tra trang tổng quan:

  1. Xem ma trận mã lỗi so với thời gian để xem hoạt động của mã lỗi trong 1 giờ qua.
  2. Chuyển sang ma trận mã lỗi so với trạng thái HTTP để xác định các mã trạng thái HTTP cụ thể liên kết với các mã lỗi có số lượng đã tăng trong giờ qua, như đã xác định ở bước trước.
  3. Chuyển sang ma trận mã lỗi so với Proxy để xác định những proxy API đang kích hoạt mã lỗi đã xác định ở bước trước.
  4. Nhấp vào một ô trong ma trận được liên kết với một proxy API có số lượng lớn mã lỗi để xem thêm thông tin chi tiết và nhật ký truy cập.
  5. Thiết lập cảnh báotạo báo cáo tuỳ chỉnh để hỗ trợ thêm trong việc chẩn đoán vấn đề.
  6. Tiếp tục troubleshoot proxy API bằng cách sử dụng dấu vết và các công cụ khác để xác định giải pháp cho vấn đề.

Sử dụng trang tổng quan Mã trạng thái

Trang tổng quan Mã trạng thái cho phép bạn kiểm tra các chỉ số về mã trạng thái cho các proxy API và dịch vụ mục tiêu trong tổ chức của mình. Bạn có thể xem các chỉ số của mã trạng thái trong khoảng thời gian một giờ hoặc bốn giờ bất kỳ lúc nào trong 30 ngày qua.

Khám phá trang tổng quan Mã trạng thái

Để hiển thị trang tổng quan Mã trạng thái, hãy chọn Phân tích > Giám sát API > Điều tra trong giao diện người dùng Edge. Trang tổng quan Mã trạng thái hiển thị theo mặc định:

trang mã trạng thái

Như được đánh dấu trong hình, trang Điều tra trang tổng quan cho phép bạn:

  • Định cấu hình từng ma trận bằng cách đặt trục x và trục y của ma trận đó để so sánh hoạt động tương quan giữa các chỉ số và nắm được thêm thông tin chi tiết.
  • Nhanh chóng xác định các chỉ số đang có khối lượng tương đối cao nhất dựa trên việc tô bóng màu của khối. Khối càng đậm, âm lượng tương đối càng cao.
  • Nhấp vào một khối trong ma trận để xem chi tiết chỉ số.
  • Lọc dữ liệu dựa trên những yếu tố sau:
    • Môi trường
    • Khu vực
    • Proxy
    • Mã trạng thái (bao gồm tất cả lưu lượng truy cập, tất cả lỗi, 2xx, 4xx hoặc 5xx)
    • Ngày và giờ trong 30 ngày qua
    • Thời lượng 1 giờ hoặc 4 giờ

Sử dụng trang tổng quan để nhanh chóng thực hiện các tác vụ sau:

  • Truy cập nhật ký trong bảng thông tin chi tiết về chỉ số.
  • Xem bối cảnh hiện tại trong mục Gần đây hoặc Dòng thời gian hoặc trang tổng quan bằng cách nhấp vào Trình đơn xem thêm > > hoặc > tương ứng.
  • Tạo báo cáo tuỳ chỉnh và thêm các phương diện khác bằng cách nhấp vào .
  • Tạo cảnh báo và thêm các điều kiện cảnh báo khác, thiết lập thông báo và tạo báo cáo tùy chỉnh dựa trên cảnh báo.

Định cấu hình ma trận Mã trạng thái

Khi bạn chọn trang tổng quan Mã trạng thái, các ma trận sau sẽ xuất hiện theo mặc định:

  • Mã lỗi so với thời gian
  • Mã lỗi so với trạng thái HTTP
  • Nguồn lỗi so với proxy API

Định cấu hình từng ma trận để so sánh bất kỳ hai chỉ số nào trong số các chỉ số sau đây bằng cách chọn giá trị cho danh sách thả xuống x-Trục y:

Định cấu hình ma trận

Xem chi tiết về chỉ số Mã trạng thái

Xem thông tin chi tiết về một chỉ số cụ thể bằng cách nhấp vào khối của chỉ số đó trong ma trận.

Chọn khối

Thông tin chi tiết liên quan đến nguyên nhân nghi ngờ xuất hiện trong ngăn bên phải, bao gồm:

  • Môi trường
  • Tổ chức
  • Khu vực
  • Nguồn lỗi (cơ sở hạ tầng proxy, mục tiêu hoặc Apigee)

Thông tin chi tiết cũng có thể bao gồm:

  • Chính sách về lỗi – Thông tin về chính sách đã kích hoạt lỗi thời gian chạy, bao gồm cả loại chính sách (tên nội bộ) và tên chính sách do người dùng xác định. Bạn sẽ xác định tên khi đính kèm chính sách vào quy trình proxy API.
  • Tên proxy
  • Mã trạng thái HTTP
  • Mã lỗi

Nếu số lượng giá trị riêng biệt lớn hơn 1 đối với một chỉ số cụ thể, thì bảng thông tin chi tiết có thể bao gồm thông tin chi tiết về tình trạng phân bổ lỗi, chẳng hạn như Phân phối theo ứng dụng của nhà phát triển, Phân phối theo chính sách về lỗi, Phân phối theo mã lỗi, Phân phối theo trạng thái HTTP, v.v. Ví dụ:

Nhà phân phối

Nếu nguồn lỗi phát sinh, bảng thông tin chi tiết sẽ bao gồm cả Tỷ lệ lỗi theo mục tiêu. Ví dụ:

Tỷ lệ lỗi theo mục tiêu

Sử dụng trang tổng quan về độ trễ

Trang tổng quan về độ trễ hiển thị thông tin về độ trễ cho các proxy API và dịch vụ mục tiêu trong tổ chức của bạn. Bạn có thể kiểm tra các chỉ số về độ trễ trong khoảng thời gian một giờ bất cứ lúc nào trong 30 ngày qua.

Khám phá trang tổng quan về độ trễ

Để hiển thị trang tổng quan về độ trễ, hãy chọn Analyze > API Monitoring > Điều tra (Phân tích > Giám sát API > Điều tra) trong giao diện người dùng Edge. Trang tổng quan Mã trạng thái hiển thị theo mặc định. Chọn Độ trễ trong vùng bộ lọc để hiển thị Trang tổng quan về độ trễ.:

trang độ trễ

Khi bạn chọn trang tổng quan về độ trễ, các ma trận sau sẽ xuất hiện theo mặc định:

  • Proxy so với thời gian (độ trễ tối đa tính bằng mili giây)
  • Độ trễ của proxy so với tổng độ trễ (độ trễ tối đa tính bằng mili giây)
  • Độ trễ của proxy so với tất cả mục tiêu (độ trễ tối đa tính bằng mili giây)

Sử dụng hộp thả xuống Proxy để chọn Mục tiêu để xem độ trễ mục tiêu.

Theo mặc định, trang tổng quan về Độ trễ hiển thị thông tin cho 10 proxy có tổng độ trễ P99 cao nhất trong một giờ trước đó. Ngoài ra, hãy sử dụng hộp thả xuống 10 proxy hoặc tập hợp cụ thể để chọn một proxy hoặc tập hợp cụ thể.

Trang tổng quan về độ trễ có tất cả các tính năng của trang tổng quan Mã trạng thái, với những điểm khác biệt sau:

  • Bạn chỉ định cấu hình phân vị tổng độ trễ phản hồi (p50, p90, p95, p99).
  • Bạn chỉ có thể chọn khoảng thời gian một giờ cho các chỉ số độ trễ.
  • Bạn không thể chọn Bất kỳ cho Khu vực trong bộ lọc. Bạn phải chọn một khu vực cụ thể để xem.

Xem chi tiết về chỉ số Độ trễ

Xem thông tin chi tiết về một chỉ số cụ thể bằng cách nhấp vào khối của chỉ số đó trong ma trận.

Chọn khối

Thông tin chi tiết liên quan đến độ trễ của một proxy (đường màu xanh dương) và mục tiêu (đường màu tím) hiển thị trong ngăn bên phải, bao gồm:

  • Tổng độ trễ (độ trễ proxy cộng với độ trễ mục tiêu)
  • Độ trễ trên mỗi mục tiêu (thời gian phản hồi mục tiêu)
  • Phân phối theo trạng thái HTTP

Hãy di chuột qua biểu đồ để xem thông tin chi tiết:

Chế độ xem chỉ số độ trễ

Biểu đồ Độ trễ trên mỗi mục tiêu cho thấy 16 mục tiêu hàng đầu dựa trên độ trễ tối đa, với một biểu đồ cho mỗi mục tiêu. Di chuột qua một biểu đồ hoặc chọn danh sách thả xuống để xác định biểu đồ tương ứng với từng mục tiêu.

Xem nhật ký trong phần thông tin chi tiết về các chỉ số

Khi xem thông tin chi tiết về chỉ số cho mã trạng thái hoặc độ trễ, hãy nhấp vào Xem nhật ký để xem tất cả nhật ký cho chỉ số đã chọn:

Chọn nhật ký

Hộp thoại Nhật ký lưu lượng truy cập sẽ mở ra và hiển thị tối đa 1.000 mục nhập nhật ký. Nhấp vào một mục nhập nhật ký để mở rộng chi tiết của mục nhập đó trong danh sách:

Nhật ký

Bạn có thể lọc nhật ký theo:

  • Nguồn lưu lượng truy cập
  • Loại lỗi
  • Thời gian phản hồi tối thiểu

Bạn không thể tải dữ liệu nhật ký xuống từ hộp thoại Nhật ký lưu lượng truy cập. Tuy nhiên, bạn có thể tạo báo cáo tuỳ chỉnh hoặc tải dữ liệu phân tích xuống kho lưu trữ dữ liệu riêng, chẳng hạn như Google Cloud Storage hoặc BigQuery, để tự phân tích dữ liệu.

Tạo báo cáo tuỳ chỉnh từ trang Điều tra trang tổng quan

Tạo báo cáo tuỳ chỉnh dựa trên nhóm điều kiện đã chọn. Bạn có thể chỉnh sửa báo cáo tuỳ chỉnh sau khi tạo, để thêm hoặc xoá các chỉ số và phương diện (nếu cần). Ví dụ: có thể bạn muốn thu hẹp điều tra của mình đối với một mã truy cập, ứng dụng của nhà phát triển hoặc proxy API cụ thể. Để biết thêm thông tin, hãy xem Tài liệu tham khảo về chỉ số, phương diện và bộ lọc của Analytics.

Để biết thêm thông tin, hãy xem bài viết Tạo báo cáo tuỳ chỉnh.

Để tạo báo cáo tùy chỉnh:

  1. Nhấp vào một khối trong ma trận để xem thêm chi tiết.

    Chọn khối

  2. Trong ngăn bên phải, hãy nhấp vào Tạo báo cáo tùy chỉnh.

    tạo báo cáo

    Trang báo cáo tuỳ chỉnh sẽ hiển thị trong thẻ mới với các trường có liên quan được điền sẵn.

    Lưu ý: Hãy xem bài viết Tạo báo cáo tuỳ chỉnh để biết thêm thông tin về chế độ cài đặt báo cáo tuỳ chỉnh mặc định.

    Chỉnh sửa báo cáo

  3. Chỉnh sửa báo cáo tuỳ chỉnh theo yêu cầu. Xem bài viết Quản lý báo cáo tuỳ chỉnh.

  4. Nhấp vào Lưu để lưu báo cáo tuỳ chỉnh.

Theo mặc định, báo cáo được chạy bằng dữ liệu đã thu thập trong 1 giờ qua và dữ liệu này sẽ xuất hiện trong trang tổng quan tuỳ chỉnh cho báo cáo. Hãy xem bài viết Khám phá trang tổng quan của báo cáo tuỳ chỉnh.

Trên trang Báo cáo, các báo cáo tuỳ chỉnh tạo bằng tính năng Giám sát API sẽ được đặt tên theo định dạng sau: API Monitoring Investigate Generated.

Điều tra một cảnh báo cụ thể

Để điều tra một cảnh báo cụ thể, hãy chọn tên của cảnh báo đó trong trang Nhật ký cảnh báo. Trang tổng quan Điều tra sẽ xuất hiện. Xin lưu ý rằng lớp này chứa một biểu đồ ở đầu trang tổng quan và chỉ bao gồm quy cách thông tin cho cảnh báo:

điều tra trang cảnh báo

  • Xem thông tin chi tiết về lưu lượng truy cập API tại thời điểm cảnh báo được kích hoạt.
  • Xem thông tin theo ngữ cảnh về cảnh báo, bao gồm thời gian cảnh báo được kích hoạt ở giữa biểu đồ.
  • Nhấp vào Chi tiết về điều kiện để hiển thị thông tin chi tiết về tình trạng cảnh báo trong cửa sổ bật lên.
  • Nhấp vào Cẩm nang (nếu có) để xem cẩm nang về thông báo:

    đường liên kết đến cẩm nang

  • Nhấp vào Quản lý thông báo để chỉnh sửa thông báo.

  • Nhấp vào Xem báo cáo (nếu có) để xem báo cáo tuỳ chỉnh.

  • Bật hoặc tắt tính năng tự động làm mới trang theo yêu cầu.