Antipattern: Thêm thông tin tuỳ chỉnh vào giản đồ do Apigee sở hữu trong cơ sở dữ liệu Postgres

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

Edge API Analytics là một tính năng tích hợp rất mạnh mẽ do Apigee Edge cung cấp. Nền tảng này thu thập và phân tích nhiều loại dữ liệu truyền qua các API. Dữ liệu phân tích được thu thập có thể cung cấp thông tin chi tiết rất hữu ích. Ví dụ: Lưu lượng truy cập API có xu hướng như thế nào trong một khoảng thời gian? API nào được dùng nhiều nhất? Những API nào có tỷ lệ lỗi cao?

Bạn có thể sử dụng hoạt động phân tích thường xuyên dữ liệu và thông tin chi tiết này để thực hiện các hành động thích hợp, chẳng hạn như lập kế hoạch năng lực cho API trong tương lai dựa trên mức sử dụng hiện tại, các quyết định kinh doanh và đầu tư trong tương lai, cũng như nhiều hành động khác.

Dữ liệu Analytics và bộ nhớ của dữ liệu

API Analytics thu thập nhiều loại dữ liệu, chẳng hạn như:

  • Thông tin về một API – URI yêu cầu, địa chỉ IP ứng dụng khách, mã trạng thái phản hồi, v.v.
  • Hiệu suất của API Proxy – Tỷ lệ thành công/thất bại, Thời gian xử lý yêu cầu và phản hồi, v.v.
  • Hiệu suất của máy chủ đích – Tỷ lệ thành công/thất bại, Thời gian xử lý
  • Thông tin về lỗi – Số lỗi, Mã lỗi, Chính sách không thành công, Số lỗi do Apigee và Máy chủ đích gây ra.
  • Thông tin khác – Số yêu cầu do Nhà phát triển, Ứng dụng của nhà phát triển, v.v. thực hiện

Tất cả dữ liệu này được lưu trữ trong một lược đồ analytics do Apigee Edge tạo và quản lý trong cơ sở dữ liệu Postgres.

Thông thường, trong một bản cài đặt Edge thuần tuý, Postgres sẽ có các lược đồ sau:

Edge sử dụng giản đồ có tên analytics để lưu trữ tất cả dữ liệu phân tích cho từng tổ chức và môi trường. Nếu bạn cài đặt tính năng kiếm tiền, sẽ có một giản đồ rkms. Các giản đồ khác dành cho nội bộ Postgres.

Giản đồ analytics sẽ tiếp tục thay đổi khi Apigee Edge tự động thêm các bảng dữ kiện mới vào giản đồ này trong thời gian chạy. Thành phần máy chủ Postgres sẽ tổng hợp dữ liệu thực tế thành các bảng tổng hợp được tải và hiển thị trên giao diện người dùng Edge.

Antipattern

Bạn không nên thêm các cột, bảng và/hoặc khung hiển thị tuỳ chỉnh vào bất kỳ lược đồ nào thuộc sở hữu của Apigee trong Cơ sở dữ liệu Postgres trên môi trường Đám mây riêng bằng cách sử dụng trực tiếp các truy vấn SQL, vì việc này có thể gây ra những hậu quả bất lợi.

Hãy xem một ví dụ để giải thích chi tiết về vấn đề này.

Giả sử bạn đã tạo một bảng tuỳ chỉnh có tên account trong giản đồ phân tích như minh hoạ dưới đây:

Sau một thời gian, giả sử bạn cần nâng cấp Apigee Edge từ phiên bản thấp hơn lên phiên bản cao hơn. Việc nâng cấp Apigee Edge Private Cloud bao gồm việc nâng cấp Postgres cùng với nhiều thành phần khác. Nếu có bất kỳ cột, bảng hoặc khung hiển thị tuỳ chỉnh nào được thêm vào Cơ sở dữ liệu Postgres, thì quá trình nâng cấp Postgres sẽ không thành công do lỗi tham chiếu đến các đối tượng tuỳ chỉnh vì các đối tượng này không phải do Apigee Edge tạo. Do đó, quá trình nâng cấp Apigee Edge cũng không thành công và không thể hoàn tất.

Tương tự, lỗi có thể xảy ra trong các hoạt động bảo trì Apigee Edge, trong đó việc sao lưu và khôi phục các thành phần Edge, bao gồm cả cơ sở dữ liệu Postgres, được thực hiện.

Tác động

  • Không thể hoàn tất quy trình nâng cấp Apigee Edge vì quy trình nâng cấp thành phần Postgres không thành công do các lỗi tham chiếu đến các đối tượng tuỳ chỉnh không do Apigee Edge tạo.
  • Sự không nhất quán (và lỗi) trong khi thực hiện hoạt động bảo trì dịch vụ Apigee Analytics (sao lưu/khôi phục).

Phương pháp hay nhất

  • Không thêm bất kỳ thông tin tuỳ chỉnh nào dưới dạng cột, bảng, khung hiển thị, hàm và quy trình trực tiếp vào bất kỳ lược đồ nào thuộc sở hữu của Apigee, chẳng hạn như analytics, v.v.
  • Nếu cần hỗ trợ thông tin tuỳ chỉnh, bạn có thể thêm thông tin đó dưới dạng các cột (trường) bằng cách sử dụng chính sách Trình thu thập số liệu thống kê cho giản đồ analytics.

Tài liệu đọc thêm