Các vấn đề đã biết với Apigee

Khi biến luồng cachehit được sử dụng sau chính sách LookupCache, do cách các điểm gỡ lỗi được gửi đi cho hành vi không đồng bộ, nên LookupPolicy sẽ điền đối tượng DebugInfo trước khi lệnh gọi lại được thực thi, dẫn đến lỗi.

Giải pháp: Lặp lại quy trình (thực hiện cuộc gọi thứ hai) ngay sau cuộc gọi đầu tiên.

Việc đặt PurgeChildEntries trong chính sách InvalidateCache sẽ chỉ xoá hoàn toàn các giá trị phần tử KeyFragment nhưng sẽ xoá toàn bộ bộ nhớ đệm.

Giải pháp: Sử dụng chính sách KeyValueMapOperations để lặp lại phiên bản bộ nhớ đệm và bỏ qua nhu cầu vô hiệu hoá bộ nhớ đệm.

• Apigee Edge hỗ trợ quy cách OpenAPI 3.0 khi bạn tạo thông số kỹ thuật bằng trình chỉnh sửa thông số kỹ thuật và phát hành API bằng SmartDocs trên cổng thông tin của bạn, mặc dù một số tính năng chưa được hỗ trợ.

  Ví dụ: các tính năng sau đây trong OpenAPI Specification 3.0 chưa được hỗ trợ:

  • Các thuộc tính allOf để kết hợp và mở rộng giản đồ
  • Tham chiếu từ xa

  Nếu một tính năng không được hỗ trợ được tham chiếu trong Thông số kỹ thuật OpenAPI của bạn, thì trong một số trường hợp, các công cụ sẽ bỏ qua tính năng đó nhưng vẫn hiển thị tài liệu tham khảo API. Trong các trường hợp khác, tính năng không được hỗ trợ sẽ gây ra lỗi khiến tài liệu tham khảo API không hiển thị thành công. Trong cả hai trường hợp, bạn sẽ cần sửa đổi Thông số kỹ thuật OpenAPI của mình để tránh sử dụng tính năng không được hỗ trợ cho đến khi tính năng đó được hỗ trợ trong bản phát hành sau này.

  Lưu ý: Vì trình chỉnh sửa thông số ít hạn chế hơn SmartDocs khi hiển thị tài liệu tham khảo API, nên bạn có thể thấy kết quả khác nhau giữa các công cụ.

• Khi sử dụng API Thử này trong cổng thông tin, tiêu đề Accept được đặt thành application/json bất kể giá trị được thiết lập cho consumes trong Thông số kỹ thuật OpenAPI.

• Việc nhiều người dùng thực hiện cập nhật đồng thời cổng thông tin (chẳng hạn như trang, giao diện, CSS hoặc tập lệnh) hiện không được hỗ trợ.
• Nếu xoá trang tài liệu tham khảo API khỏi cổng thông tin thì bạn sẽ không thể tạo lại trang đó. Bạn sẽ phải xoá và thêm lại sản phẩm API, đồng thời tạo lại tài liệu tham khảo API.
• Khi định cấu hình chính sách bảo mật nội dung, có thể mất tới 15 phút để các thay đổi được áp dụng đầy đủ.
• Khi tuỳ chỉnh giao diện cổng thông tin, có thể mất đến 5 phút để các thay đổi có hiệu lực đầy đủ.

• Tính năng Tìm kiếm sẽ được tích hợp vào cổng thông tin tích hợp trong bản phát hành trong tương lai.

Sự cố này chỉ ảnh hưởng đến những người đang dùng MINT hoặc đã bật MINT trong Edge để cài đặt Đám mây riêng tư.

Thành phần bị ảnh hưởng: Edge-message-processor

Vấn đề: Nếu bạn đã bật tính năng kiếm tiền và đang cài đặt phiên bản 4.52.01 mới hoặc nâng cấp từ các phiên bản Đám mây riêng tư trước đó, thì bạn sẽ gặp vấn đề với trình xử lý tin nhắn. Số lượng luồng mở sẽ tăng dần, dẫn đến tình trạng cạn kiệt tài nguyên. Bạn có thể thấy trường hợp ngoại lệ sau trong Edge-message-processor system.log:

Error injecting constructor, java.lang.OutOfMemoryError: unable to create new native thread

Gần đây, một lỗ hổng Từ chối dịch vụ (DoS) đã được phát hiện trong nhiều việc triển khai giao thức HTTP/2 (CVE-2023-44487), bao gồm cả trong Apigee Edge cho Đám mây riêng tư. Lỗ hổng bảo mật này có thể làm gián đoạn chức năng quản lý API Apigee. Để biết thêm thông tin, hãy xem bài viết Apigee Security Logs GCP-2023-032.

Các thành phần Edge cho bộ định tuyến và máy chủ quản lý của Đám mây riêng tư sẽ bị lộ Internet và có nguy cơ bị tấn công. Mặc dù HTTP/2 được bật trên trình quản lý chuyển các thành phần khác dành riêng cho Edge của Edge cho Private Cloud, nhưng không thành phần nào trong số đó được tiếp xúc với Internet. Trên các thành phần không phải Edge, chẳng hạn như Cassandra, Zookeeper và các thành phần khác, HTTP/2 chưa được bật. Chúng tôi khuyên bạn nên thực hiện các bước sau đây để giải quyết lỗ hổng bảo mật Edge dành cho Cloud riêng tư:

• Các bước dành cho Edge dành cho Private Cloud phiên bản 4.51.00.11 trở lên
• Các bước dành cho Edge dành cho phiên bản Cloud riêng tư trước phiên bản 4.51.00.11

Hãy làm theo các bước sau nếu bạn đang sử dụng Edge Private Cloud phiên bản 4.51.00.11 trở lên:

1. Cập nhật máy chủ quản lý:

   1. Trên mỗi nút máy chủ quản lý, hãy mở /opt/apigee/customer/application/management-server.properties
   2. Thêm dòng này vào tệp thuộc tính:

      conf_webserver_http2.enabled=false

   3. Khởi động lại thành phần máy chủ quản lý:

      apigee-service edge-management-server restart

2. Cập nhật trình xử lý thư:

   1. Trên mỗi nút xử lý thông báo, hãy mở /opt/apigee/customer/application/message-processor.properties
   2. Thêm dòng này vào tệp thuộc tính:

      conf_webserver_http2.enabled=false

   3. Khởi động lại thành phần trình xử lý thư:

      apigee-service edge-message-processor restart

3. Cập nhật bộ định tuyến:

   1. Trên mỗi nút bộ định tuyến, hãy mở /opt/apigee/customer/application/router.properties
   2. Thêm dòng này vào tệp thuộc tính:

      conf_webserver_http2.enabled=false

   3. Khởi động lại thành phần trình xử lý thư:

      apigee-service edge-router restart

4. Cập nhật QPID:

   1. Trên mỗi nút QPID, hãy mở /opt/apigee/customer/application/qpid-server.properties
   2. Thêm dòng này vào tệp thuộc tính:

      conf_webserver_http2.enabled=false

   3. Khởi động lại thành phần trình xử lý thư:

      apigee-service edge-qpid-server restart

5. Cập nhật Postgres:

   1. Trên mỗi nút Postgres, hãy mở /opt/apigee/customer/application/postgres-server.properties
   2. Thêm dòng này vào tệp thuộc tính:

      conf_webserver_http2.enabled=false

   3. Khởi động lại thành phần trình xử lý thư:

      apigee-service edge-postgres-server restart

Hãy làm theo các bước sau nếu bạn đang sử dụng Edge cho phiên bản Private Cloud cũ hơn 4.51.00.11:

1. Cập nhật máy chủ quản lý:

   1. Trên mỗi nút máy chủ quản lý, hãy mở /opt/apigee/customer/application/management-server.properties
   2. Thêm hai dòng sau vào tệp thuộc tính:

      conf_webserver_http2.enabled=false
      conf/webserver.properties+http2.enabled=false

   3. Khởi động lại thành phần máy chủ quản lý:

      apigee-service edge-management-server restart

2. Cập nhật trình xử lý thư:

   1. Trên mỗi nút xử lý thông báo, hãy mở /opt/apigee/customer/application/message-processor.properties
   2. Thêm hai dòng sau vào tệp thuộc tính:

      conf_webserver_http2.enabled=false
      conf/webserver.properties+http2.enabled=false

   3. Khởi động lại thành phần trình xử lý thư:

      apigee-service edge-message-processor restart

3. Cập nhật bộ định tuyến:

   1. Trên mỗi nút bộ định tuyến, hãy mở /opt/apigee/customer/application/router.properties
   2. Thêm hai dòng sau vào tệp thuộc tính:

      conf_webserver_http2.enabled=false
      conf/webserver.properties+http2.enabled=false

   3. Khởi động lại thành phần trình xử lý thư:

      apigee-service edge-router restart

4. Cập nhật QPID:

   1. Trên mỗi nút QPID, hãy mở /opt/apigee/customer/application/qpid-server.properties
   2. Thêm hai dòng sau vào tệp thuộc tính:

      conf_webserver_http2.enabled=false
      conf/webserver.properties+http2.enabled=false

   3. Khởi động lại thành phần trình xử lý thư:

      apigee-service edge-qpid-server restart

5. Cập nhật Postgres:

   1. Trên mỗi nút Postgres, hãy mở /opt/apigee/customer/application/postgres-server.properties
   2. Thêm hai dòng sau vào tệp thuộc tính:

      conf_webserver_http2.enabled=false
      conf/webserver.properties+http2.enabled=false

   3. Khởi động lại thành phần trình xử lý thư:

      apigee-service edge-postgres-server restart

Apigee-postgresql đang gặp vấn đề khi nâng cấp từ Edge lên Cloud riêng tư phiên bản 4.50 hoặc 4.51 đến phiên bản 4.52. Chủ yếu là các vấn đề xảy ra khi số lượng bảng lớn hơn 500.

Bạn có thể kiểm tra tổng số bảng trong Postgres bằng cách chạy truy vấn SQL bên dưới:

select count(*) from information_schema.tables

Giải pháp: Khi Cập nhật Apigee Edge 4.50.00 hoặc 4.51.00 thành 4.52.00, hãy nhớ thực hiện bước sơ bộ trước khi nâng cấp Apigee-postgresql.

apigee-mirror không hoạt động trên Red Hat Enterprise Linux (RHEL) 8.0.

Giải pháp: Để khắc phục vấn đề này, hãy cài đặt apigee-mirror trên máy chủ chạy phiên bản thấp hơn về RHEL hoặc thiết bị khác được hỗ trợ hệ điều hành dành cho Apigee. Sau đó, bạn có thể dùng gương để thêm các gói ngay cả khi bạn đã cài đặt Apigee trên máy chủ RHEL 8.0.

149245401: Cài đặt nhóm kết nối LDAP cho JNDI được định cấu hình thông qua Tài nguyên LDAP không được phản ánh và các giá trị mặc định của JNDI sẽ luôn khiến các kết nối dùng một lần. Do đó, các kết nối đang được mở và đóng mỗi lần để sử dụng một lần, tạo ra một số lượng lớn kết nối mỗi giờ đến máy chủ LDAP.

Giải pháp:

Để thay đổi các thuộc tính của nhóm kết nối LDAP, hãy làm như sau: các bước sau đây để thiết lập thay đổi chung cho tất cả các chính sách LDAP.

1. Tạo một tệp thuộc tính cấu hình nếu chưa có:

   /opt/apigee/customer/application/message-processor.properties

2. Thêm nội dung sau đây vào tệp (thay thế giá trị của Thuộc tính Đặt tên Java và Giao diện thư mục (JNDI) dựa trên yêu cầu về cấu hình tài nguyên LDAP).

   bin_setenv_ext_jvm_opts="-Dcom.sun.jndi.ldap.connect.pool.maxsize=20
   -Dcom.sun.jndi.ldap.connect.pool.prefsize=2
   -Dcom.sun.jndi.ldap.connect.pool.initsize=2
   -Dcom.sun.jndi.ldap.connect.pool.timeout=120000
   -Dcom.sun.jndi.ldap.connect.pool.protocol=ssl"

3. Đảm bảo tệp /opt/apigee/customer/application/message-processor.properties là thuộc sở hữu của apigee:apigee.
4. Khởi động lại từng trình xử lý thư.

Cách xác minh nhóm kết nối JNDI của bạn đang có hiệu lực, bạn có thể thực hiện tcpdump để quan sát hành vi của nhóm kết nối LDAP theo thời gian.

139051927: Đã tìm thấy độ trễ xử lý proxy cao trong Bộ xử lý tin nhắn đang ảnh hưởng tất cả Proxy API. Các triệu chứng bao gồm thời gian xử lý bị chậm trễ từ 200 đến 300 mili giây so với bình thường Phản hồi của API và có thể xảy ra ngẫu nhiên ngay cả khi TPS thấp. Điều này có thể xảy ra khi có hơn 50 mục tiêu máy chủ nơi trình xử lý thư tạo kết nối.

Nguyên nhân gốc rễ: Trình xử lý thông báo giữ một bộ nhớ đệm giúp ánh xạ URL máy chủ mục tiêu đến đối tượng HTTPClient để kết nối đi đến máy chủ mục tiêu. Theo mặc định, chế độ cài đặt này được đặt là 50, và có thể quá thấp đối với hầu hết các đợt triển khai. Khi một đợt triển khai có nhiều tổ hợp tổ chức/env trong một thiết lập, và có số lượng lớn máy chủ mục tiêu vượt quá 50 máy chủ, URL máy chủ mục tiêu liên tục bị loại khỏi bộ nhớ đệm, gây ra độ trễ.

Xác nhận kết quả: Để xác định xem việc loại bỏ URL máy chủ mục tiêu có gây ra vấn đề về độ trễ hay không, hãy tìm kiếm Bộ xử lý thư system.logs cho từ khoá "onEvict" hoặc "Thu hồi". Việc các URL này hiện diện trong nhật ký cho thấy rằng URL máy chủ mục tiêu đều bị loại khỏi bộ nhớ đệm HTTPClient do dung lượng bộ nhớ đệm quá nhỏ.

Giải pháp: Đối với phiên bản Edge cho Private Cloud 19.01 và 19.06, bạn có thể chỉnh sửa và định cấu hình HTTPClient bộ nhớ đệm, /opt/apigee/customer/application/message-processor.properties:

conf/http.properties+HTTPClient.dynamic.cache.elements.size=500

Sau đó, khởi động lại trình xử lý tin nhắn. Thực hiện thay đổi tương tự cho tất cả trình xử lý tin nhắn.

Giá trị 500 là một ví dụ. Giá trị tối ưu cho cách thiết lập của bạn phải lớn hơn số lượng máy chủ mục tiêu mà trình xử lý thư sẽ kết nối. Không có cạnh nào hiệu ứng từ đặt thuộc tính này cao hơn và tác động duy nhất sẽ là trình xử lý thư được cải thiện thời gian xử lý yêu cầu proxy.

Lưu ý: Edge cho Cloud riêng tư phiên bản 50.00 có chế độ cài đặt mặc định là 500.

157933959: Chèn và cập nhật đồng thời cho cùng một bản đồ giá trị khoá (KVM) thuộc phạm vi ở cấp tổ chức hoặc môi trường khiến dữ liệu không nhất quán và làm mất các bản cập nhật.

Lưu ý: Quy định hạn chế này chỉ áp dụng cho Edge dành cho Cloud riêng tư. Edge cho Đám mây công cộng và Kết hợp không có giới hạn này.

Để giải quyết vấn đề trong Edge dành cho Đám mây riêng tư, hãy tạo KVM tại Phạm vi apiproxy.