Bạn đang xem tài liệu về Apigee Edge.
Truy cập vào
tài liệu Apigee X. thông tin
Trang tổng quan Điều tra cho phép bạn xem bảng tổng hợp các chỉ số và thuộc tính cho tất cả lưu lượng truy cập API, đồng thời 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 vào 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 Điều tra. Trang tổng quan có 2 khu vực chính:
- Mã trạng thái cho phép bạn tìm hiểu các chỉ số mã trạng thái cho các dịch vụ đích và proxy API.
- Độ trễ cho phép bạn điều tra các vấn đề về độ trễ đối với các dịch vụ đích và proxy API.
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 tổng quan Điều tra. Khi một cảnh báo xuất hiện, hãy nhấp vào tên của cảnh báo đó trên trang Nhật ký cảnh báo để mở cảnh báo trong trang tổng quan Điều tra.
Sử dụng trang tổng quan Điều tra để chẩn đoán vấn đề
Ví dụ: bạn nhận được một cảnh báo cho biết tỷ lệ lỗi 5xx vượt quá ngưỡng đã 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 tổng quan Điều tra:
- Xem ma trận mã lỗi so với thời gian để xem hoạt động của mã lỗi trong giờ qua.
- 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ể được liên kết với các mã lỗi có số lượng tăng lên trong giờ qua, như đã xác định ở bước trước.
- 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 được xác định ở bước trước.
- 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 mã lỗi lớn để xem thêm thông tin chi tiết và nhật ký truy cập.
- Thiết lập cảnh báo và tạo báo cáo tuỳ chỉnh để hỗ trợ thêm cho việc chẩn đoán vấn đề.
Tiếp tục khắc phục sự cố cho proxy API bằng cách sử dụng tính năng theo dõi 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 về Mã trạng thái
Trang tổng quan về Mã trạng thái cho phép bạn tìm hiểu các chỉ số về mã trạng thái cho các dịch vụ đích và proxy API trong tổ chức của mình. Bạn có thể xem các chỉ số mã trạng thái trong khoảng thời gian một giờ hoặc bốn giờ vào bất kỳ thời điểm nào trong 30 ngày qua.
Khám phá trang tổng quan về 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. Theo mặc định, trang tổng quan Mã trạng thái sẽ hiển thị:
Như minh hoạ trong hình, trang tổng quan Điều tra 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 để so sánh hoạt động tương quan giữa các chỉ số và thu thập thêm thông tin chi tiết.
- Nhanh chóng xác định những chỉ số có số lượng tương đối cao nhất dựa trên màu sắc của một khối. Khối càng đậm thì âm lượng tương đối càng cao.
- Nhấp vào một ô trong ma trận để xem thông tin chi tiết về chỉ số.
- Lọc dữ liệu dựa trên những tiêu chí 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
- Khoảng thời gian 1 giờ hoặc 4 giờ
Sử dụng trang tổng quan để nhanh chóng thực hiện các thao tác sau:
- Nhật ký truy cập trong bảng điều khiển chi tiết về chỉ số.
- Xem bối cảnh hiện tại trong phần Gần đây hoặc Dòng thời gian hoặc trang tổng quan bằng cách nhấp vào biểu tượng
> Xem trong phần Gần đây hoặc Xem trong Dòng thời gian, 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 biểu tượng
. - 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 tuỳ 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 theo 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 2 chỉ số bất kỳ trong số các chỉ số sau bằng cách chọn một giá trị cho danh sách thả xuống trục x và trục y:
- Mã lỗi
- Chính sách về lỗi
- Nguồn gây lỗi
- Trạng thái HTTP
- Proxy
- Thời gian
- Khu vực
- Mục tiêu (Dịch vụ mục tiêu hoặc chính sách về chú thích dịch vụ. Nếu mục tiêu là chính sách ServiceCallout, thì giá trị hiển thị sẽ có tiền tố là
sc://. Ví dụ:sc://my.endpoint.net.)
Xem thông tin 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 chỉ số đó trong ma trận.
Thông tin chi tiết liên quan đến nguyên nhân bị nghi ngờ sẽ 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 (proxy, đích đến hoặc cơ sở hạ tầng Apigee)
Thông tin chi tiết cũng có thể bao gồm:
- Fault Policy (Chính sách 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 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 riêng biệt lớn hơn một đối với một chỉ số cụ thể, thì bảng chi tiết có thể bao gồm thông tin chi tiết về phân phối 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 lỗi, Phân phối theo mã lỗi, Phân phối theo trạng thái HTTP, v.v. Ví dụ:
Nếu nguồn lỗi là mục tiêu, thì bảng chi tiết sẽ có Tỷ lệ lỗi theo mục tiêu. Ví dụ:
Sử dụng trang tổng quan về Độ trễ
Trang tổng quan Độ trễ hiển thị thông tin về độ trễ cho các dịch vụ đích và proxy API 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ờ vào bất kỳ thời điểm nào trong 30 ngày qua.
Khám phá trang tổng quan Độ trễ
Để hiển thị trang tổng quan Độ trễ, 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. Chọn Độ trễ trong vùng bộ lọc để hiển thị trang tổng quan Độ trễ:
Khi bạn chọn trang tổng quan Độ 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ả cá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 Target (Mục tiêu) nhằm xem độ trễ mục tiêu.
Theo mặc định, trang tổng quan Độ trễ sẽ hiển thị thông tin về 10 proxy có tổng độ trễ P99 cao nhất trong giờ trước đó. Hoặc sử dụng hộp thả xuống Top 10 (10 proxy hàng đầu) để chọn một proxy hoặc bộ sưu tậ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 về Mã trạng thái, nhưng có những điểm khác biệt sau:
- Bạn chỉ định cấu hình tổng phân vị độ trễ phản hồi (p50, p90, p95, p99).
- Bạn chỉ có thể chọn một khoảng thời gian là 1 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 vùng cụ thể để xem.
Xem thông tin 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 chỉ số đó trong ma trận.
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) sẽ xuất hiện trong ngăn bên phải, bao gồm:
- Tổng độ trễ (độ trễ của proxy cộng với độ trễ của 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
Di chuột lên biểu đồ để xem thông tin chi tiết:
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 lên 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ề 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:
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ật ký. Nhấp vào một mục nhập nhật ký để mở rộng thông tin chi tiết của mục đó trong danh sách:
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 của riêng bạn, 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 tổng quan Điều tra
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ụ: bạn có thể muốn thu hẹp phạm vi điều tra xuống một mã truy cập, ứng dụng nhà phát triển hoặc proxy API cụ thể. Để biết thêm thông tin, hãy xem bài viết Thông tin 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:
Nhấp vào một ô trong ma trận để hiển thị thêm thông tin chi tiết.
Trong ngăn bên phải, hãy nhấp vào biểu tượng
.
Trang báo cáo tuỳ chỉnh sẽ xuất hiện trong một thẻ mới với các trường 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 tuỳ chỉnh nếu cần. Xem phần Quản lý báo cáo tuỳ chỉnh.
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 được trong giờ qua và dữ liệu sẽ xuất hiện trên trang tổng quan báo cáo tuỳ chỉnh. Xem phần Khám phá trang tổng quan về báo cáo tuỳ chỉnh.
Trên trang Báo cáo, các báo cáo tuỳ chỉnh được tạo bằng tính năng Giám sát API sẽ có tên theo định dạng sau: API Monitoring Investigate Generated.
Điều tra một cảnh báo cụ thể
Để tìm hiểu một cảnh báo cụ thể, hãy chọn tên của cảnh báo đó trên 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 trang tổng quan này có một biểu đồ ở đầu và chỉ bao gồm thông tin cụ thể về 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 bối cảnh về cảnh báo, bao gồm cả thời gian cảnh báo được kích hoạt ở trung tâm củ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ề điều kiện cảnh báo trong một cửa sổ bật lên.
Nhấp vào Playbook (nếu có) để xem playbook cho cảnh báo:
Nhấp vào Quản lý cảnh báo để chỉnh sửa cảnh 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 (nếu cần).