Bạn đang xem tài liệu về Apigee Edge.
Hãy xem tài liệu về Apigee X.
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 và so sánh hoạt động tương quan giữa các chỉ số để điều tra và chẩn đoán các vấn đề nhanh hơn. Bạn có thể truy cập dữ liệu trong 30 ngày qua trong 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 điều tra các chỉ số mã trạng thái cho 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 các API API và dịch vụ đích.
Bạn cũng có thể điều tra các vấn đề do cảnh báo cụ thể gây ra trong trang tổng quan Điều tra. Khi cảnh báo xảy ra, nhấp vào tên cảnh báo trong trang Lịch sử cảnh báo để mở cảnh báo trong trang tổng quan Điều tra.
Sử dụng trang tổng quan Kiểm tra để chẩn đoán sự cố
Ví dụ: bạn nhận được 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 tác vụ 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ể liên kết với mã lỗi có số lượng đã tăng trong một 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 các proxy API đang kích hoạt mã lỗi đã xác định trong bước trước.
- Nhấp vào hộp trong ma trận được liên kết với proxy API có một lượng lớn mã lỗi để xem thêm chi tiết và truy cập nhật ký.
- Thiết lập cảnh báo và tạo báo cáo tùy chỉnh để hỗ trợ thêm cho việc chẩn đoán sự cố.
Ngoài ra, bạn có thể khắc phục sự cố về proxy API bằng cách sử dụng dấu vết và các công cụ khác để xác định cách giải quyết 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 điều tra chỉ số mã trạng thái 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ể xem số liệu mã trạng thái cho cửa sổ 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:
Như được làm nổi bật 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à hiểu rõ hơn về các chỉ số.
- 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 tô 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 thông tin chi tiết về chỉ số.
- Lọc dữ liệu theo các tiêu chí sau:
- Môi trường
- Vùng
- 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
- Cửa sổ 1 giờ hoặc 4 giờ
Sử dụng trang tổng quan để thực hiện nhanh các tác vụ sau:
- Truy cập nhật ký trong bảng chi tiết chỉ số.
- Xem ngữ cảnh hiện tại trong Gần đây hoặc Dòng thời gian hoặc trang tổng quan bằng cách nhấp vào
> Xem trong Gần đây hoặc Xem trong Dòng thời gian tương ứng.
- Tạo báo cáo tùy chỉnh và thêm các thứ nguyê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 bổ sung, 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, thì 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 mỗi ma trận để so sánh bất kỳ chỉ số nào trong hai chỉ số sau bằng cách chọn giá trị cho danh sách thả xuống x- và trục y:
- Mã lỗi
- Chính sách lỗi
- Nguồn lỗi
- Trạng thái HTTP
- Proxy
- Thời gian
- Vùng
- Mục tiêu (Dịch vụ mục tiêu hoặc chính sách Chú thích dịch vụ). Nếu mục tiêu là chính sách Chú thích dịch vụ, thì giá trị hiển thị sẽ bắt đầu bằng
sc://
. Ví dụ:sc://my.endpoint.net
.)
Xem chi tiết số liệu Mã trạng thái
Xem thông tin chi tiết của một chỉ số cụ thể bằng cách nhấp vào khối của chỉ số đó trong ma trận.
Thông tin chi tiết về nguyên nhân bị nghi ngờ được hiển thị trong ngăn bên phải, bao gồm:
- Môi trường
- Tổ chức
- Vùng
- Nguồn lỗi (proxy, mục tiêu hoặc cơ sở hạ tầng Apigee)
Thông tin chi tiết cũng có thể bao gồm:
- 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 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 luồng proxy API.
- Tên proxy
- Mã trạng thái HTTP
- Mã lỗi
Nếu lượng số lớn hơn một chỉ số cụ 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à đích, bảng chi tiết sẽ bao gồm Tỷ lệ lỗi theo mục tiêu. Ví dụ:
Sử dụng trang tổng quan Độ trễ
Trang tổng quan thời gian chờ hiển thị thông tin thời gian chờ cho proxy API và dịch vụ mục tiêu trong tổ chức của bạn. Bạn có thể điều tra các chỉ số độ trễ cho một giờ sau trong một giờ bất cứ lúc nào trong 30 ngày qua.
Khám phá trang tổng quan về Thời gian chờ
Để hiển thị trang tổng quan về Thời gian chờ, 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 khu vực bộ lọc để hiển thị trang tổng quan Thời gian chờ.:
Khi bạn chọn trang tổng quan Thời gian chờ, 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)
- Thời gian chờ so với proxy so với tổng thời gian thực (độ trễ tối đa tính bằng mili giây)
- Thời gian chờ proxy và 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 Độ trễ sẽ hiển thị thông tin về 10 proxy có tổng độ trễ P99 cao nhất trong giờ trước đó. Ngoài ra, hãy sử dụng hộp thả xuống Top 10 để chọn một bộ sưu tập hoặc proxy cụ thể.
Trang tổng quan Thời gian chờ 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 khác biệt sau đây:
- Bạn chỉ định cấu hình tổng tỷ lệ phần trăm độ 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 vùng cụ thể để xem.
Xem chi tiết chỉ số Thời gian chờ
Xem thông tin chi tiết của một chỉ số cụ thể bằng cách nhấp vào khối của chỉ số đó trong ma trận.
Thông tin chi tiết về độ trễ cho proxy (đường màu xanh) và mục tiêu (đường màu tím) được hiển thị trong ngăn bên phải, bao gồm:
- Tổng thời gian chờ (độ trễ proxy và độ 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
Di chuột qua 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 qua biểu đồ hoặc chọn danh sách thả xuống để xác định biểu đồ tương ứng với mỗi mục tiêu.
Xem nhật ký từ chi tiết số liệu
Khi xem chi tiết 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ập nhật ký. Nhấp vào mục nhập nhật ký để mở rộng chi tiết mục nhập trong danh sách:
Bạn có thể lọc thêm 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 xuống dữ liệu nhật ký 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 trong kho lưu trữ dữ liệu của riêng mình (chẳng hạn như Google Cloud Storage hoặc BigQuery) để phân tích dữ liệu.
Tạo báo cáo tùy chỉnh từ trang tổng quan Điều tra
Tạo báo cáo tùy chỉnh dựa trên tập hợp các điều kiện đã chọn. Bạn có thể chỉnh sửa báo cáo tùy chỉnh sau khi tạo để thêm hoặc xóa các chỉ số và thứ nguyên, theo yêu cầu. Ví dụ: bạn có thể muốn thu hẹp điều tra của mình đối với mã thông báo 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 bài viết Chỉ số, thứ nguyên và bộ lọc Analytics.
Để biết thêm thông tin, hãy xem Tạo báo cáo tùy chỉnh.
Để tạo báo cáo tùy chỉnh:
Nhấp vào một khối trong ma trận để hiển thị thêm chi tiết.
Trong ngăn bên phải, hãy nhấp vào
.
Trang báo cáo tùy chỉnh hiển thị trong thẻ mới, cùng 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 tuỳ chỉnh theo yêu cầu. Xem Quản lý báo cáo tùy chỉnh.
Nhấp vào Lưu để lưu báo cáo tùy chỉnh.
Báo cáo được chạy bằng cách sử dụng dữ liệu được thu thập trong một giờ qua theo mặc định và dữ liệu được hiển thị trong trang tổng quan báo cáo tùy chỉnh. Xem Khám phá trang tổng quan báo cáo tùy chỉnh.
Trên trang Báo cáo, báo cáo tùy chỉnh được tạo bằng tính năng Giám sát API được đặt tên theo định dạng sau: API Monitoring Investigate Generated
.
Điều tra một thông báo cụ thể
Để điều tra một cảnh báo cụ thể, hãy chọn tên cảnh báo trong trang Lịch sử cảnh báo. Trang tổng quan Điều tra xuất hiện. Lưu ý rằng bảng này chứa một biểu đồ ở đầu trang tổng quan và chỉ bao gồm các thông số thông tin cho cảnh báo:
- Xem chi tiết lưu lượng truy cập API vào 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 điều kiện để hiển thị chi tiết về điều kiện cảnh báo trong 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ý 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 tùy chỉnh.
Bật hoặc tắt tính năng tự động làm mới của trang khi cần.