Znane problemy z Apigee

Gdy po zasadzie LookupCache jest używana zmienna przepływu cachehit, ze względu na sposób wysyłania punktów debugowania w celu asynchronicznego działania LookupPolicy wypełnia obiekt DebugInfo przed wykonaniem wywołania zwrotnego, co skutkuje błędem.

Obejście: powtórz ten proces (utwórz drugie wywołanie) tuż po pierwszym wywołaniu.

Ustawienie PurgeChildEntries w zasadzie InvalidateCache powinno trwale usuwać tylko wartości elementu KeyFragment, ale czyści całą pamięć podręczną.

Obejście: użyj zasady KeyValueMapOperations, aby iterować obsługę wersji pamięci podręcznej i pominąć potrzebę unieważniania pamięci podręcznej.

• Apigee Edge obsługuje OpenAPI 3.0, gdy tworzysz specyfikacje w edytorze specyfikacji i publikujesz interfejsy API przy użyciu SmartDokumentów w portalu, ale niektóre funkcje nie są jeszcze obsługiwane.

  Na przykład te funkcje ze specyfikacji OpenAPI 3.0 nie są jeszcze obsługiwane:

  • Właściwości allOf służące do łączenia i rozszerzania schematów
  • Odwołania zdalne

  Jeśli specyfikacja OpenAPI odwołuje się do nieobsługiwanej funkcji, narzędzia w niektórych przypadkach ją zignorują, ale nadal będą renderować dokumentację API. W innych przypadkach nieobsługiwana funkcja spowoduje błędy, które uniemożliwią prawidłowe wyrenderowanie dokumentacji referencyjnej interfejsu API. W obu przypadkach musisz zmodyfikować specyfikację OpenAPI, aby uniknąć korzystania z nieobsługiwanej funkcji do czasu jej obsługi w kolejnej wersji.

  Uwaga: edytor specyfikacji jest mniej restrykcyjny niż aplikacja SmartDokumentacja w przypadku renderowania dokumentacji referencyjnej interfejsu API, dlatego wyniki poszczególnych narzędzi mogą się różnić.

• Gdy używasz w portalu tego interfejsu API, nagłówek Accept jest ustawiony na application/json niezależnie od wartości consumes ustawionej w specyfikacji OpenAPI.

• Jednoczesne aktualizowanie portalu (np. strony, motywu, arkusza CSS lub skryptu) przez wielu użytkowników nie jest obecnie obsługiwane.
• Jeśli usuniesz z portalu stronę dokumentacji API, nie będzie można jej ponownie utworzyć. Musisz usunąć i ponownie dodać usługę API oraz ponownie wygenerować dokumentację API.
• Podczas konfigurowania zasad bezpieczeństwa treści może minąć do 15 minut, zanim zmiany będą w pełni stosowane.
• Podczas dostosowywania motywu portalu zastosowanie wszystkich zmian może potrwać do 5 minut.

• W nadchodzącej wersji wyszukiwarka zostanie zintegrowana ze zintegrowanym portalem.

Ten problem dotyczy tylko użytkowników, którzy używają MINT lub mają włączoną funkcję MINT w Edge w przypadku instalacji Private Cloud.

Komponent, którego dotyczy problem: proces przetwarzania wiadomości brzegowych

Problem: jeśli masz włączone zarabianie i instalujesz wersję 4.52.01 jako nową instalację lub uaktualnienie z poprzednich wersji chmury prywatnej, wystąpi problem z procesorami wiadomości. Stopniowo wzrasta liczba otwartych wątków, prowadząc do wyczerpania zasobów. W pliku Edge-message-processor system.log występuje ten wyjątek:

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

W wielu implementacjach protokołu HTTP/2 (CVE-2023-44487), w tym w Apigee Edge dla Private Cloud, została ostatnio wykryta luka w zabezpieczeniach typu DoS (DoS). Luka w zabezpieczeniach mogła prowadzić do ataku DoS funkcji zarządzania interfejsem Apigee API. Więcej informacji znajdziesz w biuletynie Apigee na temat zabezpieczeń GCP-2023-032 (w języku angielskim).

Komponenty routera brzegu chmury prywatnej i serwera zarządzania są dostępne w internecie i mogą być podatne na ataki. Chociaż protokół HTTP/2 jest włączony na porcie zarządzania innych specyficznych dla brzegu komponentów Edge dla Private Cloud, żaden z nich nie jest dostępny w internecie. W komponentach innych niż Edge, takich jak Cassandra, Zookeeper i innych, protokół HTTP/2 nie jest włączony. Aby usunąć lukę w zabezpieczeniach Edge dla Private Cloud, zalecamy wykonanie tych czynności:

• Instrukcje dotyczące Edge for Private Cloud w wersji 4.51.00.11 lub nowszej
• Instrukcje dotyczące Edge for Private Cloud w wersji starszej niż 4.51.00.11

Wykonaj te czynności, jeśli korzystasz z Edge Private Cloud w wersji 4.51.00.11 lub nowszej:

1. Zaktualizuj serwer zarządzania:

   1. W każdym węźle serwera zarządzania otwórz /opt/apigee/customer/application/management-server.properties
   2. Dodaj ten wiersz do pliku właściwości:

      conf_webserver_http2.enabled=false

   3. Ponownie uruchom komponent serwera zarządzania:

      apigee-service edge-management-server restart

2. Zaktualizuj procesor wiadomości:

   1. W każdym węźle procesora wiadomości otwórz /opt/apigee/customer/application/message-processor.properties
   2. Dodaj ten wiersz do pliku właściwości:

      conf_webserver_http2.enabled=false

   3. Uruchom ponownie komponent procesora wiadomości:

      apigee-service edge-message-processor restart

3. Zaktualizuj router:

   1. W każdym węźle routera otwórz /opt/apigee/customer/application/router.properties
   2. Dodaj ten wiersz do pliku właściwości:

      conf_webserver_http2.enabled=false

   3. Uruchom ponownie komponent procesora wiadomości:

      apigee-service edge-router restart

4. Zaktualizuj QPID:

   1. W każdym węźle QPID otwórz /opt/apigee/customer/application/qpid-server.properties
   2. Dodaj ten wiersz do pliku właściwości:

      conf_webserver_http2.enabled=false

   3. Uruchom ponownie komponent procesora wiadomości:

      apigee-service edge-qpid-server restart

5. Aktualizowanie Postgres:

   1. W każdym węźle Postgres otwórz /opt/apigee/customer/application/postgres-server.properties
   2. Dodaj ten wiersz do pliku właściwości:

      conf_webserver_http2.enabled=false

   3. Uruchom ponownie komponent procesora wiadomości:

      apigee-service edge-postgres-server restart

Wykonaj te czynności, jeśli używasz Edge dla Private Cloud w wersji starszej niż 4.51.00.11:

1. Zaktualizuj serwer zarządzania:

   1. W każdym węźle serwera zarządzania otwórz /opt/apigee/customer/application/management-server.properties
   2. Do pliku właściwości dodaj te 2 wiersze:

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

   3. Ponownie uruchom komponent serwera zarządzania:

      apigee-service edge-management-server restart

2. Zaktualizuj procesor wiadomości:

   1. W każdym węźle procesora wiadomości otwórz /opt/apigee/customer/application/message-processor.properties
   2. Do pliku właściwości dodaj te 2 wiersze:

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

   3. Uruchom ponownie komponent procesora wiadomości:

      apigee-service edge-message-processor restart

3. Zaktualizuj router:

   1. W każdym węźle routera otwórz /opt/apigee/customer/application/router.properties
   2. Do pliku właściwości dodaj te 2 wiersze:

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

   3. Uruchom ponownie komponent procesora wiadomości:

      apigee-service edge-router restart

4. Zaktualizuj QPID:

   1. W każdym węźle QPID otwórz /opt/apigee/customer/application/qpid-server.properties
   2. Do pliku właściwości dodaj te 2 wiersze:

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

   3. Uruchom ponownie komponent procesora wiadomości:

      apigee-service edge-qpid-server restart

5. Aktualizowanie Postgres:

   1. W każdym węźle Postgres otwórz /opt/apigee/customer/application/postgres-server.properties
   2. Do pliku właściwości dodaj te 2 wiersze:

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

   3. Uruchom ponownie komponent procesora wiadomości:

      apigee-service edge-postgres-server restart

W usłudze Apigee-postgresql występują problemy z uaktualnieniem usługi Edge for Private Cloud w wersji 4.50 lub 4.51 do wersji 4.52. Problemy występują głównie wtedy, gdy liczba tabel przekracza 500.

Aby sprawdzić łączną liczbę tabel w Postgres, uruchom zapytanie SQL poniżej:

select count(*) from information_schema.tables

Obejście: podczas aktualizowania Apigee Edge w wersji 4.50.00 lub 4.51.00 do 4.52.00 wykonaj krok wstępny przed uaktualnieniem Apigee-postgresql.

apigee-mirror nie działa w systemie Red Hat Enterprise Linux (RHEL) 8.0.

Obejście: aby obejść ten problem, zainstaluj apigee-mirror na serwerze z starszą wersją RHEL lub innym obsługiwanym systemem operacyjnym dla Apigee. Następnie za pomocą pliku lustrzanego możesz dodawać pakiety, nawet jeśli Apigee zostało zainstalowane na serwerach RHEL 8.0.

149245401: ustawienia puli połączeń LDAP dla JNDI skonfigurowane przy użyciu zasobu LDAP nie są odzwierciedlane, a ustawienia domyślne JNDI za każdym razem powodują jednorazowe połączenia. W rezultacie połączenia są otwierane i zamykane za każdym razem do jednego użycia, co powoduje utworzenie dużej liczby połączeń z serwerem LDAP w ciągu godziny.

Obejście:

Jeśli chcesz zmienić właściwości puli połączeń LDAP, wykonaj opisane poniżej czynności w celu ustawienia globalnej zmiany we wszystkich zasadach LDAP.

1. Utwórz plik właściwości konfiguracji, jeśli jeszcze nie istnieje:

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

2. Dodaj do pliku poniższe elementy (zastąp wartości właściwości JNDI i Naming w języku Java zgodnie z wymaganiami dotyczącymi konfiguracji zasobów 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. Sprawdź, czy plik /opt/apigee/customer/application/message-processor.properties jest własnością apigee:apigee.
4. Ponownie uruchom każdy procesor wiadomości.

Aby sprawdzić, czy działają właściwości JNDI puli połączeń, możesz wykonać polecenie tcpdump w celu obserwacji zachowania puli połączeń LDAP w czasie.

139051927: wysokie opóźnienia przetwarzania serwera proxy w procesorze wiadomości wpływają na wszystkie serwery proxy interfejsu API. Objawy obejmują opóźnienia przetwarzania o 200–300 ms w porównaniu z normalnym czasem odpowiedzi interfejsu API oraz mogą występować losowo, nawet przy niskim współczynniku TPS. Może się tak zdarzyć, gdy ponad 50 serwerów docelowych, z którymi procesor wiadomości łączy się,

Główna przyczyna: procesory wiadomości przechowują pamięć podręczną, która mapuje adres URL serwera docelowego na obiekt HTTPClient w przypadku połączeń wychodzących z serwerami docelowymi. Domyślnie to ustawienie ma wartość 50, która może być za niska dla większości wdrożeń. Gdy wdrożenie zawiera w konfiguracji wiele kombinacji organizacji i środowisk i ma dużą liczbę serwerów docelowych, która łącznie przekracza 50, adresy URL serwerów docelowych są usuwane z pamięci podręcznej, co powoduje opóźnienia.

Weryfikacja: aby sprawdzić, czy usunięcie adresu URL serwera docelowego powoduje problem z opóźnieniem, wyszukaj w pliku Message Processor system.logs słowo kluczowe „onEvict” lub „Eviction”. Ich obecność w logach wskazuje, że adresy URL serwera docelowego są usuwane z pamięci podręcznej HTTPClient, ponieważ jest ona za mała.

Obejście: w przypadku Edge for Private Cloud w wersjach 19.01 i 19.06 możesz edytować i skonfigurować pamięć podręczną HTTPClient /opt/apigee/customer/application/message-processor.properties:

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

Następnie ponownie uruchom procesor wiadomości. Wprowadź te same zmiany we wszystkich systemach przetwarzania wiadomości.

Przykładem może być wartość 500. Optymalna wartość dla Twojej konfiguracji powinna być większa od liczby serwerów docelowych, z którymi może się połączyć procesor wiadomości. Ustawienie wyższej wartości właściwości nie ma żadnych skutków ubocznych, a jedynym wpływem jest skrócenie czasu przetwarzania żądań serwera proxy procesora wiadomości.

Uwaga: Edge for Private Cloud w wersji 50.00 ma ustawienie domyślne 500.

157933959: równoczesne wstawianie i aktualizowanie mapy par klucz-wartość (KVM) o zakresie na poziomie organizacji lub środowiska powoduje niespójne dane i utratę aktualizacji.

Uwaga: to ograniczenie dotyczy tylko Edge dla Private Cloud. Edge dla chmury publicznej i hybrydowej nie ma tego ograniczenia.

Aby obejść ten problem, utwórz KVM w zakresie apiproxy.