Problemi noti di Apigee

Quando la variabile di flusso cachehit viene utilizzata dopo il criterio LookupCache, a causa del modo in cui i punti di debug vengono inviati per il comportamento asincrono, LookupPolicy compila l'oggetto DebugInfo prima dell'esecuzione della richiamata, generando un errore.

Soluzione: ripeti la procedura (effettua una seconda chiamata) di nuovo subito dopo la prima.

L'impostazione di PurgeChildEntries nel criterio InvalidateCache dovrebbe eliminare definitivamente solo i valori dell'elemento KeyFragment, ma cancellare l'intera cache.

Soluzione:utilizza il criterio KeyValueMapOperations per iterare il controllo delle versioni della cache e ignorare la convalida della cache.

• Apigee Edge supporta la specifica OpenAPI 3.0 quando crei le specifiche utilizzando l'editor delle specifiche e pubblichi le API utilizzando SmartDocumenti sul tuo portale, anche se un sottoinsieme di funzionalità non è ancora supportato.

  Ad esempio, le seguenti funzionalità della specifica OpenAPI 3.0 non sono ancora supportate:

  • Proprietà allOf per combinare ed estendere gli schemi
  • Riferimenti remoti

  Se nella specifica OpenAPI viene fatto riferimento a una funzionalità non supportata, in alcuni casi gli strumenti la ignorano, ma visualizzano comunque la documentazione di riferimento dell'API. In altri casi, una funzionalità non supportata causerà errori che impediscono il corretto rendering della documentazione di riferimento dell'API. In entrambi i casi, dovrai modificare la specifica OpenAPI per evitare l'utilizzo della funzionalità non supportata finché non sarà supportata in una release futura.

  Nota: poiché l'editor delle specifiche è meno restrittivo di SmartDocs durante il rendering della documentazione di riferimento dell'API, potresti riscontrare risultati diversi tra gli strumenti.

• Quando utilizzi Prova questa API nel portale, l'intestazione Accept è impostata su application/json a prescindere dal valore impostato per consumes nella specifica OpenAPI.

• Al momento, gli aggiornamenti simultanei del portale (ad esempio modifiche di pagine, temi, CSS o script) da parte di più utenti non sono supportati.
• Se elimini dal portale una pagina della documentazione di riferimento dell'API, non potrai ricrearla; dovrai eliminare e aggiungere nuovamente il prodotto API e rigenerare la documentazione di riferimento dell'API.
• Quando configuri i criteri di sicurezza dei contenuti, l'applicazione completa delle modifiche potrebbe richiedere fino a 15 minuti.
• Quando personalizzi il tema del portale, l'applicazione completa delle modifiche potrebbe richiedere fino a 5 minuti.

• La ricerca verrà integrata nel portale integrato in una release futura.

Questo problema riguarda solo coloro che utilizzano MINT o hanno MINT abilitato in Edge per le installazioni di cloud privato.

Componente interessato: edge-message-processor

Problema: se hai abilitato la monetizzazione e stai installando la versione 4.52.01 come nuova installazione o eseguendo l'upgrade dalle versioni precedenti di Private Cloud, potresti riscontrare un problema con i processori di messaggi. Ci sarà un aumento graduale del numero di thread aperti, con l'esaurimento delle risorse. La seguente eccezione è presente in edge-message-processor system.log:

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

Di recente, è stata scoperta una vulnerabilità denial of service (DoS) in più implementazioni del protocollo HTTP/2 (CVE-2023-44487), tra cui Apigee Edge per il cloud privato. La vulnerabilità potrebbe portare a un DoS della funzionalità di gestione delle API Apigee. Per ulteriori dettagli, consulta il Bollettino sulla sicurezza Apigee GCP-2023-032.

I componenti del router e del server di gestione di Edge per Cloud privato sono esposti a internet e possono essere potenzialmente vulnerabili. Anche se HTTP/2 è abilitato sulla porta di gestione di altri componenti specifici di Edge per il cloud privato, nessuno di questi componenti è esposto a internet. Sui componenti non Edge, come Cassandra, Zookeeper e altri, HTTP/2 non è abilitato. Ti consigliamo di seguire questi passaggi per risolvere la vulnerabilità Edge per cloud privato:

• Passaggi per Edge per Cloud privato versione 4.51.00.11 o successive
• Passaggi per le versioni di Edge per Cloud privato precedenti alla 4.51.00.11

Segui questi passaggi se utilizzi Edge Private Cloud 4.51.00.11 o versioni successive:

1. Aggiorna il server di gestione:

   1. Apri /opt/apigee/customer/application/management-server.properties su ciascun nodo del server di gestione
   2. Aggiungi questa riga al file delle proprietà:

      conf_webserver_http2.enabled=false

   3. Riavvia il componente del server di gestione:

      apigee-service edge-management-server restart

2. Aggiorna il processore dei messaggi:

   1. Apri /opt/apigee/customer/application/message-processor.properties su ogni nodo del processore di messaggi
   2. Aggiungi questa riga al file delle proprietà:

      conf_webserver_http2.enabled=false

   3. Riavvia il componente del processore dei messaggi:

      apigee-service edge-message-processor restart

3. Aggiorna il router:

   1. Apri /opt/apigee/customer/application/router.properties su ciascun nodo del router
   2. Aggiungi questa riga al file delle proprietà:

      conf_webserver_http2.enabled=false

   3. Riavvia il componente del processore dei messaggi:

      apigee-service edge-router restart

4. Aggiorna QPID:

   1. Su ogni nodo QPID, apri /opt/apigee/customer/application/qpid-server.properties
   2. Aggiungi questa riga al file delle proprietà:

      conf_webserver_http2.enabled=false

   3. Riavvia il componente del processore dei messaggi:

      apigee-service edge-qpid-server restart

5. Aggiorna Postgres:

   1. Su ogni nodo Postgres, apri /opt/apigee/customer/application/postgres-server.properties
   2. Aggiungi questa riga al file delle proprietà:

      conf_webserver_http2.enabled=false

   3. Riavvia il componente del processore dei messaggi:

      apigee-service edge-postgres-server restart

Segui questi passaggi se utilizzi versioni di Edge per Cloud privato precedenti alla 4.51.00.11:

1. Aggiorna il server di gestione:

   1. Apri /opt/apigee/customer/application/management-server.properties su ciascun nodo del server di gestione
   2. Aggiungi le due righe seguenti al file delle proprietà:

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

   3. Riavvia il componente del server di gestione:

      apigee-service edge-management-server restart

2. Aggiorna il processore dei messaggi:

   1. Apri /opt/apigee/customer/application/message-processor.properties su ogni nodo del processore di messaggi
   2. Aggiungi le due righe seguenti al file delle proprietà:

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

   3. Riavvia il componente del processore dei messaggi:

      apigee-service edge-message-processor restart

3. Aggiorna il router:

   1. Apri /opt/apigee/customer/application/router.properties su ciascun nodo del router
   2. Aggiungi le due righe seguenti al file delle proprietà:

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

   3. Riavvia il componente del processore dei messaggi:

      apigee-service edge-router restart

4. Aggiorna QPID:

   1. Su ogni nodo QPID, apri /opt/apigee/customer/application/qpid-server.properties
   2. Aggiungi le due righe seguenti al file delle proprietà:

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

   3. Riavvia il componente del processore dei messaggi:

      apigee-service edge-qpid-server restart

5. Aggiorna Postgres:

   1. Su ogni nodo Postgres, apri /opt/apigee/customer/application/postgres-server.properties
   2. Aggiungi le due righe seguenti al file delle proprietà:

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

   3. Riavvia il componente del processore dei messaggi:

      apigee-service edge-postgres-server restart

Apigee-postgresql riscontra problemi con l'upgrade da Edge per Cloud privato versione 4.50 o 4.51 alla versione 4.52. I problemi si verificano principalmente quando il numero di tabelle è maggiore di 500.

Puoi controllare il numero totale di tabelle in Postgres eseguendo la query SQL di seguito:

select count(*) from information_schema.tables

Soluzione:quando aggiorni Apigee Edge 4.50.00 o la versione 4.51.00 alla versione 4.52.00, assicurati di eseguire il passaggio preliminare prima di eseguire l'upgrade di Apigee-postgresql.

apigee-mirror non funziona su Red Hat Enterprise Linux (RHEL) 8.0.

Soluzione: come soluzione alternativa, installa apigee-mirror su un server che esegue una versione precedente di RHEL o un altro sistema operativo supportato per Apigee. Puoi quindi utilizzare il mirroring per aggiungere pacchetti anche se hai installato Apigee su server RHEL 8.0.

149245401: le impostazioni del pool di connessioni LDAP per JNDI configurato tramite la risorsa LDAP non vengono applicate e i valori predefiniti di JNDI causano ogni volta connessioni a uso singolo. Di conseguenza, le connessioni vengono aperte e chiuse ogni volta per uso singolo, creando un numero elevato di connessioni all'ora al server LDAP.

Soluzione alternativa:

Per modificare le proprietà del pool di connessioni LDAP, segui questi passaggi per impostare una modifica globale di tutti i criteri LDAP.

1. Crea un file delle proprietà di configurazione, se non esiste già:

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

2. Aggiungi quanto segue al file (sostituisci i valori delle proprietà Java Naming e Directory Interface (JNDI) in base ai requisiti di configurazione delle risorse 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. Assicurati che il file /opt/apigee/customer/application/message-processor.properties sia di proprietà di apigee:apigee.
4. Riavvia ogni processore di messaggi.

Per verificare che le proprietà JNDI del pool di connessioni vengano applicate, puoi eseguire un tcpdump per osservare il comportamento del pool di connessioni LDAP nel tempo.

139051927: le latenze elevate di elaborazione proxy rilevate nel processore di messaggi interessano tutti i proxy API. I sintomi includono ritardi di 200-300 ms nei tempi di elaborazione rispetto ai normali tempi di risposta dell'API e possono verificarsi in modo casuale anche con TPS bassi. Questo può verificarsi quando più di 50 server di destinazione in cui un processore di messaggi stabilisce connessioni.

Causa principale: i processori dei messaggi conservano una cache che mappa l'URL del server di destinazione all'oggetto HTTPClient per le connessioni in uscita ai server di destinazione. Per impostazione predefinita, il valore è 50, che potrebbe essere troppo basso per la maggior parte dei deployment. Quando un deployment ha più combinazioni organizzazione/ambiente in una configurazione e ha un numero elevato di server di destinazione che supera in totale i 50, gli URL dei server di destinazione continuano a essere rimossi dalla cache, causando latenze.

Convalida: per determinare se l'eliminazione dell'URL del server di destinazione causa il problema di latenza, cerca la parola chiave "onEvict" o "Eviction" nel sistema di elaborazione dei messaggi system.logs. La loro presenza nei log indica che gli URL dei server di destinazione vengono rimossi dalla cache HTTPClient perché le dimensioni della cache sono troppo ridotte.

Soluzione:per Edge per Cloud privato versioni 19.01 e 19.06, puoi modificare e configurare la cache HTTPClient, /opt/apigee/customer/application/message-processor.properties:

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

Quindi riavvia il processore dei messaggi. Apporta le stesse modifiche a tutti i processori di messaggi.

Il valore 500 è un esempio. Il valore ottimale per la configurazione deve essere maggiore del numero di server di destinazione a cui si connette il processore di messaggi. L'impostazione di questa proprietà su un valore più elevato non ha effetti collaterali e l'unico effetto è un miglioramento dei tempi di elaborazione delle richieste proxy dell'elaboratore dei messaggi.

Nota:l'impostazione predefinita di Edge per cloud privato 50.00 è 500.

157933959: l'inserimento e gli aggiornamenti simultanei della stessa mappa chiave-valore (KVM) con ambito a livello di organizzazione o di ambiente causano dati incoerenti e perdite di aggiornamenti.

Nota:questo limite si applica solo a Edge per cloud privato. Edge per cloud pubblico e ibrido non presentano questa limitazione.

Per una soluzione alternativa in Edge per cloud privato, crea il KVM nell'ambito apiproxy.