Problemi noti di Apigee

Questa pagina si applica ad Apigee e Apigee hybrid.

Visualizza la documentazione di Apigee Edge.

Seleziona una o più delle seguenti opzioni per filtrare questa pagina:

Questa sezione elenca i problemi noti per i componenti Apigee. Per un elenco di bug, nuove funzionalità e altre informazioni di rilascio, consulta le note di rilascio.

ID problema Riguarda Stato Descrizione

329304975

 Apigee APRI Limite al numero di percorsi di base per ambiente

Apigee applica un limite temporaneo di 500 percorsi base per ambiente per evitare potenziali errori durante il deployment delle revisioni dei proxy API.

Anche se questo limite è attivo, puoi eseguire il deployment di un massimo di 500 revisioni del proxy API (ognuna contenente un singolo percorso base) per ambiente. Se i proxy o le revisioni API contengono più di un percorso base, il numero totale di percorsi di base per ambiente non deve superare 500.

333791378

 ibrido 1.12.0 APRI Funzionalità di backup e ripristino di Cassandra non supportate dallo strumento di migrazione di Helm

Per i passaggi necessari per installare una patch per la soluzione alternativa, consulta la pagina Risoluzione dei problemi.

310384001

 ibrido 1.11.0 APRI Gli errori di convalida dei certificati potrebbero restituire una risposta di errore 502 anziché 503 quando gli utenti aggiungono il tag <Enforce>true</Enforce> nel blocco <SSLInfo> di destinazione per la convalida predefinita dei certificati di endpoint di destinazione TLS.

289583112

 Apigee APRI Il criterio OASValidation non funziona con i requisiti di sicurezza globali nelle specifiche OpenAPI

Se il criterio OASValidation specifica un elemento <OASResource> con requisiti di sicurezza impostati a livello globale, i requisiti di sicurezza non vengono applicati.

Soluzione: per garantire l'applicazione, tutti i requisiti di sicurezza devono essere impostati a livello di operazione nella specifica OpenAPI passata nell'elemento <OASResource> del criterio OASValidation.

205666368

 Apigee
hybrid 1.10.2
hybrid 1.10.3		 Risolto in Apigee 1-10-0-apigee-6 e
Hybrid 1.10.3-hotfix.1		 Apigee ibrido non convalida il certificato di destinazione per impostazione predefinita.

Vedi Informazioni sull'impostazione delle opzioni TLS in un endpoint o un server di destinazione.

295929616

 ibrido 1.10.0 e versioni successive Correzione nella versione ibrida 1.10.3 L'installazione di Apigee hybrid 1.10 su OpenShift (OSE) può non riuscire con errori di esaurimento della memoria.

L'installazione o l'upgrade ad Apigee hybrid da 1.10.0 a 1.10.2 potrebbe non riuscire su OSE a causa di problemi di esaurimento della memoria. Risolto in Apigee versione ibrida 1.10.3.

292268968

 ibrido 1.10.1 APRI apigee-udca potrebbe non rispettare le impostazioni del proxy http.

Se il firewall forza tutto il traffico attraverso un proxy di inoltro, apigee-udca potrebbe entrare in uno stato di backoff loop di arresto anomalo.

269573358

 Apigee
hybrid 1.8.0 e versioni successive		 APRI Il criterio OASValidation ha esito negativo e restituisce Unable to parse JSON errore.
  • Il criterio OASValidation ha esito negativo quando il contenuto JSON non corrisponde al pattern previsto. Ad esempio, se un'intestazione prevede un valore nel formato <text>@<text> e viene compilata con testo privo del simbolo @, il criterio restituisce un errore Unable to parse JSON.
  • Se il criterio OASValidation specifica un elemento <OASResource> contenente un parametro path che utilizza uno schema $ref, il criterio avrà esito negativo con un errore Unable to parse JSON - Unrecognized token.

    Soluzione: non utilizzare $ref nei parametri path della specifica OpenAPI specificata nell'elemento <OASResource>.

299953958

 Apigee
hybrid 1.8.0 e versioni successive		 APRI Problemi di deployment con la convalida OAS durante l'utilizzo del riferimento circolare.
  • Il deployment di Apigee non andrà a buon fine per il criterio di convalida OAS quando si utilizzano riferimenti circolari per la specifica OpenAPI 3.0.0 quando entra in un ciclo infinito.

    • Soluzione: utilizza un file YAML della specifica OpenAPI senza riferimenti circolari.

289254725

 Apigee
Apigee 1-10-0-apigee-3
hybrid 1.8.8
hybrid 1.9.3		 Correzione in Apigee 1-10-0-apigee-5
OPEN in modalità ibrida		 I deployment proxy che includono il criterio OASValidation potrebbero non riuscire.

I deployment del proxy che includono il criterio OASValidation potrebbero non riuscire se:

  • La specifica OpenAPI utilizzata per la convalida nel criterio OASValidation è in formato YAML e
  • La specifica OpenAPI in formato YAML contiene un numero mobile. Ad esempio: 
    schema:
type: number
example: 2.345

284500460

 Apigee
Apigee 1-10-0-apigee-1		 FISSA Aumento della latenza per il criterio di logging dei messaggi quando utilizzato con Cloud Logging.

Per evitare un aumento della latenza nelle risposte al client, il criterio di logging dei messaggi deve essere associato a PostClientFlow. Per saperne di più sull'utilizzo dei criteri in PostClientFlows, consulta la pagina relativa al controllo dei proxy API con i flussi.

282997216

 ibrido 1.8.0 e versioni successive
ibrido 1.9.0 e versioni successive		 APRI Caratteri speciali non consentiti nella password Cassandra Jolokia

Utilizza solo caratteri alfanumerici per la password di Cassandra Jolokia. L'utilizzo di caratteri speciali (inclusi, a titolo esemplificativo, "!", "@", "#", "$", "%", "^", "&", & "*") può causare l'avvio di Cassandra.

271415351

 Apigee APRI Evita deployment simultanei di proxy API o SharedFlow

Le richieste di deployment contemporanee per un SharedFlow o un proxy API possono causare uno stato incoerente nel server di gestione in cui più revisioni vengono mostrate come deployment. Questo può accadere, ad esempio, quando si verificano esecuzioni simultanee di una pipeline di deployment CI/CD utilizzando revisioni diverse. Per evitare questo problema, non eseguire il deployment di proxy API o SharedFlows prima del completamento del deployment attuale.

271689008

 ibrido 1.9.0 e versioni successive APRI I pod cert-manager su OpenShift dalla versione 4.7 alla versione 4.10 non si avviano come previsto

Con cert-manager v1.10.1 su OpenShift nelle versioni dalla 4.7 alla 4.10, i pod cert-manager non si avviano come previsto. Per risolvere il problema, modifica il vincolo della configurazione di sicurezza come descritto nelle note di rilascio di cert-manager 1.10.

270371160

 ibrido 1.9.0 e versioni successive FISSA Il gateway Ingress Apigee supporta solo protocollo/cifrature TLS1.2+

Il gateway Apigee Ingress supporta solo TLS1.2+ e non le versioni precedenti di TLS.

269139342

 ibrido 1.7.0 e versioni successive APRI apigeectl getOrg non rispetta le impostazioni di HTTP_PROXY in overrides.yaml

La convalida dell'organizzazione Apigee non segue le regole del proxy di inoltro HTTP impostate in overrides.yaml. Imposta validateOrg: false per saltare questa convalida.

266452840

 Apigee
ibrido 1.7.0 e versioni successive
ibrido 1.8.0 e versioni successive
ibrido 1.9.0 e versioni successive		 APRI I socket web non funzionano con Anthos Service Mesh 1.15.3 in Apigee X e Apigee Hybrid

In determinate circostanze, i socket web non funzionano per Apigee X e Apigee Hybrid quando viene utilizzato Anthos Service Mesh 1.15.3-asm.6.

242213234

 Apigee APRI Il prodotto API non viene caricato a causa dell'errore "Nessuna connessione disponibile"

Durante il tentativo di caricamento dei prodotti API potrebbe essere restituito questo errore: "I prodotti non sono stati caricati correttamente. Errore: nessuna connessione disponibile dagli agenti Apigee Connect."

Il problema si verifica dopo aver abilitato il controllo di servizio VPC nel progetto Google Cloud e aver aggiunto iamcredentials.googleapis.com come uno dei servizi limitati nel perimetro di servizio.

Soluzione: crea manualmente una regola in uscita, ad esempio: 

-egressTo:
    operations:
    -serviceName: "iamcredentials.googleapis.com"
        methodSelectors:
        -method:
    resources:
    -projects/608305225983
  egressFrom:
    identityType: ANY_IDENTITY

247540503

 ibrido 1.7.0 e versioni successive
ibrido 1.8.0 e versioni successive		 APRI Una race condition con la ricerca delle chiavi di crittografia può causare errori di ricerca KVM.

In determinate circostanze, con una velocità effettiva molto elevata, una gara con la ricerca delle chiavi di crittografia può causare errori di ricerca KVM.

258699204

 ibrido 1.8.0 e versioni successive APRI Le richieste di memoria predefinite e i limiti per i pod delle metriche sono inavvertitamente cambiati nella versione 1.8.x.

Se riscontri problemi con i pod apigee-telemetry-app o apigee-telemetry-proxy, modifica le proprietà delle richieste e dei limiti delle risorse metrics in modo che corrispondano ai seguenti valori predefiniti nel riferimento proprietà di configurazione: metriche.

Proprietà di configurazione Valore predefinito
metrics.aggregator.resources.requests.memory: 512Mi
metrics.aggregator.resources.limits.memory: 3Gi
metrics.app.resources.requests.memory: 512Mi
metrics.app.resources.limits.memory: 1Gi
metrics.appStackdriverExporter.resources.requests.memory: 512Mi
metrics.appStackdriverExporter.resources.limits.memory: 1Gi
metrics.proxy.resources.requests.memory: 512Mi
metrics.proxy.resources.limits.memory: 1Gi
metrics.proxyStackdriverExporter.resources.requests.memory: 512Mi
metrics.proxyStackdriverExporter.resources.limits.memory: 1Gi

Applica le modifiche con apigeectl apply con il flag ‑‑telemetry: 

apigeectl apply --telemetry -f overrides.yaml

260324159

 Apigee 1-9-0-apigee-16 APRI I deployment di proxy API e flussi condivisi richiedono fino a 30 minuti.

In determinate circostanze, il deployment dei proxy API e dei flussi condivisi potrebbe richiedere da 20 a 30 minuti nel piano di runtime a causa di un errore di tipo "socket chiuso" nel sincronizzatore.

254505866

 API Hub FISSA Le nuove regioni causano errori di provisioning

Il provisioning dell'hub API tramite la UI non va a buon fine se selezioni una regione diversa dalla seguente:

  • asia-east1
  • asia-southeast1
  • europe-west1
  • europe-west4
  • us-central1
  • us-east1
  • us-west1
  • us-west4

251897633

 Documentazione APRI Selettore della versione ibrida Apigee

Il selettore della versione ibrida di Apigee funziona solo se selezioni o fai clic direttamente sul testo.

250875730

 Tutti APRI Nell'audit log viene visualizzato il messaggio "Controllo della condizione non riuscito".

Questa operazione dovrebbe verificarsi ogni minuto e non influisce sui costi di fatturazione.

260772383

 ibrido 1.8.0 e versioni successive APRI Errore di associazione socket sulla piattaforma AKS

Se installi un ambiente ibrido su AKS, potresti visualizzare questo errore:

envoy config listener '0.0.0.0_443' failed to bind or apply socket options: cannot bind '0.0.0.0:443': Permission denied

Soluzione:aggiungi la svcAnnotations stanza seguente al file di override: 

ingressGateways:
- name: INGRESS_NAME
  ...
  svcAnnotations:
    service.beta.kubernetes.io/azure-load-balancer-internal: "true"

Vedi Configurare il runtime ibrido. Vedi anche Utilizza un bilanciatore del carico interno con AKS.

241786534

 ibrido 1.8.0 e versioni successive APRI A volte MART non riesce a connettersi a FluentD.

Quando utilizzi UDCA con ambito organizzazione, a volte MART non è in grado di connettersi a FluentD. L'UDCA con ambito a livello di organizzazione è l'impostazione predefinita in Apigee versione 1.8 ibrida. Consulta orgScopedUDCA nel riferimento alla proprietà di configurazione.

N/A ibrido 1.6.0 e versioni successive APRI apigee-logger non funziona su Anthos BareMetal con CentOS o RHEL.

Dopo la migrazione di apigee-logger da fluend a fluent-bit in Apigee versione ibrida 1.6.6, il logger ha smesso di funzionare su Anthos BareMetal con CentOS o RHEL.

231758700
231976420

 ibrido 1.5.0 e versioni successive APRI I clienti Dockerhub ibrido di Apigee non sono in grado di eseguire il pull delle immagini con Docker Content Trust abilitato.

Gli utenti riscontrano il seguente errore durante il pull delle immagini per Apigee Hybrid da Docker Hub: ERRO[0001] Metadata for targets expired. Ciò si applica ai seguenti componenti ibridi:

  • google/apigee-authn-authz
  • google/apigee-mart-server
  • google/apigee-runtime
  • google/apigee-synchronizer

Soluzione

Se si verifica questo errore, puoi utilizzare una delle due soluzioni seguenti:

  • Passa all'utilizzo di gcr.io/apigee-release per eseguire il pull delle immagini ibride.
  • Disabilita l'attendibilità dei contenuti Docker impostando la variabile di ambiente DOCKER_CONTENT_TRUST su 0
207762842 ibrido 1.5.0 e versioni successive APRI Log non spediti a Cloud Logging da apigee-logger.

Le attuali configurazioni di apigee-logger, inclusi i probe di attività, sono incompatibili con il runtime Kubernetes, per cui i log non vengono spediti a Cloud Logging come previsto. Questo problema inoltre causa regolarmente l'arresto anomalo dei pod apigee-logger. Questo problema riguarda le installazioni ibride di Apigee su AKS, Anthos Bare Metal e altre piattaforme. Tieni presente che, in alcuni casi, questo problema determina un volume di log eccessivo.

203827738 archiviazione dei deployment APRI Il proxy API configurabile senza operazioni non funziona.

I proxy che non contengono operazioni o contengono operazioni senza corrispondenze HTTP restituiscono un codice di errore 404 se il percorso della richiesta non contiene esattamente un segmento oltre al percorso base. Ad esempio, le richieste a /basepath non andranno a buon fine, ma le richieste a /basepath/user potrebbero avere esito positivo. Per evitare errori, aggiungi una sezione Operations con almeno un http_match al proxy API configurabile.

201429104 Apigee APRI Il carattere jolly nel percorso di base del proxy restituisce un percorso di richiesta errato.

L'utilizzo di un carattere jolly (*) nel percorso di base del proxy di un proxy API configurabile comporta l'inoltro di percorsi di richiesta errati alla destinazione del backend.

Per impedire un forwarding del percorso di richiesta errato, evita di utilizzare * nel percorso di base del proxy API configurabile fino a quando il problema non viene risolto.

191291501, 191000617 Apigee APRI La modifica dell'indirizzo email di un'entità sviluppatore avrà esito negativo nella UI.
191002224 ibrido 1.5.0 e versioni successive APRI La modifica di un indirizzo email non va a buon fine durante l'utilizzo dell' API PUT /organizations/{org_name}/developers/{developer_email}.
184555974 ibrido 1.5.0 e versioni successive APRI L'azienda apigee-logger Fluentd non può analizzare i log nel cluster OpenShift.
N/A archiviazione dei deployment APRI La gestione e il debug dei deployment dell'archivio Apigee nella UI non sono supportati

Nella UI di Apigee non puoi visualizzare, confermare lo stato del deployment o gestire i deployment di archiviazione, come descritto Eseguire il deployment di un proxy API, oppure utilizzare l'interfaccia utente di debug come descritto in Utilizzo di debug. Come soluzione alternativa, puoi utilizzare gcloud o l'API per Elencare tutti i deployment di archiviazione in un ambiente e utilizzare l' API di debug.

N/A archiviazione dei deployment APRI Il rollback di un deployment di archiviazione non è supportato

Il rollback di un deployment in archivio non è attualmente supportato. Per rimuovere una versione di un deployment di archiviazione, devi eseguire nuovamente il deployment di una versione precedente di un archivio o eliminare l'ambiente.

N/A Apigee in VS Code APRI L'autenticazione Google nei criteri non è supportata in Apigee in Visual Studio Code (VS Code)

L'autenticazione Google nei criteri ServiceCallout ed ExternalCallout, come descritto in Utilizzare l'autenticazione Google, non è supportata in Apigee in VS Code.

146222881 ibrido 1.3.0 e versioni successive APRI Errore di intestazione HTTP non valida

Errore intestazione HTTP non valida: il traffico Istio in entrata trasferisce tutte le risposte di destinazione in entrata al protocollo HTTP2. Poiché il processore di messaggi ibrido supporta solo HTTP1, potresti visualizzare il seguente errore quando viene chiamato un proxy API:

http2 error: Invalid HTTP header field was received: frame type: 1, stream: 1,

name: [:authority], value: [domain_name]

Se visualizzi questo errore, puoi intraprendere una delle seguenti azioni per risolvere il problema:

  • Modifica il servizio di destinazione in modo da omettere l'intestazione Host nella risposta.
  • Rimuovi l'intestazione Host utilizzando il criterio AssegnaMessage nel proxy API, se necessario.

N/A Portale integrato APRI SmartDocs
  • Apigee supporta la specifica OpenAPI 3.0 quando pubblichi le tue API utilizzando SmartDocs sul tuo portale, sebbene un sottoinsieme di funzionalità non sia ancora supportato. Ad esempio, proprietà allOf per combinare ed estendere gli schemi.

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

  • Quando utilizzi Prova questa API nel portale, l'intestazione Accept è impostata su application/json, indipendentemente dal valore impostato per consumes nella specifica OpenAPI.
N/A Portale integrato APRI Amministratore del portale

  • 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 API, non potrai ricrearla; dovrai eliminare e aggiungere nuovamente il prodotto API e rigenerare la documentazione di riferimento dell'API.
  • Quando personalizzi il tema del portale, potrebbero essere necessari fino a 5 minuti prima che le modifiche vengano applicate completamente.
N/A Portale integrato APRI Funzionalità del portale

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

N/A Portale integrato APRI Provider di identità SAML

La disconnessione singola (SLO) con il provider di identità SAML non è supportata per i domini personalizzati. Per abilitare un dominio personalizzato con un provider di identità SAML, lascia vuoto il campo URL di disconnessione quando configuri le impostazioni SAML.

191815997 ibrido 1.6.0 e versioni successive APRI Se un cliente ibrido configura un proxy di inoltro per il proxy API, il token Google non funzionerà a meno che non abbia accesso diretto a *.googleapis.com.
N/A Apigee APRI Il monitoraggio delle API e Cloud Monitoring mostrano picchi anomali

  • I conteggi delle richieste e delle risposte del proxy API (per proxy e target) mostrano picchi anomali

    Ecco un esempio che mostra questo picco:

    (visualizza immagine ingrandita)

  • A causa di un bug, il sistema registra il conteggio in modo errato per un breve periodo e il conteggio viene corretto. Questo accade in caso di riduzione del traffico API (con uno fare lo scale down dei gateway API).
  • Per distinguere i picchi effettivi nelle richieste rispetto a questo problema, consulta la pagina Analisi delle API (in particolare le pagine Prestazioni del proxy e Prestazioni target).

Metriche interessate:

  • apigee.googleapis.com/proxyv2/request_count
  • apigee.googleapis.com/proxyv2/response_count
  • apigee.googleapis.com/targetv2/request_count
  • apigee.googleapis.com/targetv2/response_count
203778087 ibrido 1.5.3 e versioni successive APRI apigee-stackdriver-logging-agent attualmente viene eseguito come root.

Soluzione:disabilita l'agente Logging nel sistema ibrido.

205629443 Apigee APRI Se ServiceCallout è attivo e viene eliminato (nessun tag <Response>), può verificarsi una race condition se è presente un altro criterio dopo.

Soluzione:per mantenere il comportamento dell'incendio e dell'eliminazione:

  1. Aggiungi <Response>calloutResponse</Response> a ServiceCallout.
  2. Imposta continueOnError su true.
207719377 Apigee FISSA in Apigee 1-11-0-apigee-1 Se in un bundle sono presenti più criteri SpikeArrest, si verificheranno 502 errori.

Soluzione:evita di utilizzare più di un criterio SpikeArrest nel proxy per evitare il problema.

209097822 ibrido 1.5.0 e versioni successive
Apigee		 APRI Gli aggiornamenti dinamici per valutare i picchi di arresto potrebbero non riflettere immediatamente

Per una chiave specifica, se c'è traffico continuo, la chiave potrebbe non essere limitata alla frequenza aggiornata. Se ci sono cinque minuti di traffico per una determinata chiave, la velocità verrà riflessa.

Soluzione: esegui nuovamente il deployment del proxy con una nuova variabile di riferimento se la frequenza deve essere applicata immediatamente. In alternativa, utilizza due arresti anomali dei picchi condizionali con variabili di flusso diverse per regolare la velocità.

221305498 Apigee APRI Il monitoraggio API potrebbe mostrare il codice di errore "(not set)".

Il monitoraggio delle API dei proxy API configurabili può mostrare un codice di errore "(not set)" per le risposte con uno stato non 2xx dalla destinazione.

246774745 Apigee APRI Il valore di io.timeout.millis non viene rispettato quando viene utilizzato con più target dinamici.

Se un proxy imposta due o più valori io.timeout.millis in due o più flussi utilizzando lo stesso host di destinazione, viene rispettato un solo valore io.timeout.millis.

245664917 ibrido 1.8.x APRI L'errore di upgrade ibrido Apigee può essere ignorato

Durante l'upgrade ad Apigee hybrid 1.8.x, dopo aver eseguito apigeectl init e aver verificato l'esito positivo di check-ready, potresti notare, se visualizzi i pod, che il job di convalida dello schema Cassandra è in stato di errore. Si tratta di una condizione innocua e puoi andare al passaggio successivo della procedura di upgrade senza problemi.

300660653 Apigee APRI Quando esegui il deployment di proxy con lo stesso percorso in più ambienti collegati alla stessa istanza e allo stesso gruppo di ambienti, dovrebbe essere restituito un errore, ma non viene restituito

Il deployment di proxy con lo stesso percorso in più ambienti collegati alla stessa istanza e allo stesso gruppo di ambienti non è consentito e dovrebbe restituire un messaggio di avviso relativo a un conflitto di percorso di base. Non viene visualizzato alcun errore e i deployment sembrano avere esito positivo.

Soluzione:durante e dopo il deployment, verifica che non esistano conflitti di percorso di base con i proxy di cui è stato eseguito il deployment. Correggi l'errore come necessario.

301458133 Apigee APRI Alcuni tentativi di deployment del proxy restituiscono un errore che indica che la revisione è immutabile

Quando si cerca di salvare un proxy di cui è stato eseguito il deployment in precedenza, il deployment potrebbe non riuscire con un errore che indica che la revisione è immutabile.

Soluzione:fai clic sulla freccia del menu a discesa accanto al pulsante Salva e seleziona Salva come nuova revisione. quindi riprova a eseguire il deployment.

301845257 Apigee APRI Il tentativo di eseguire il deployment di più di 800 proxy in un gruppo di ambienti non riesce e genera un errore. Il limite in cui viene restituito un errore è inferiore a 800 quando i basepath sono più lunghi di 15 caratteri.

N/A Apigee 1-9-0-apigee-23 APRI Upgrade della versione TLS richiesto per i client che presentano Unsupported protocol errori

Gli aggiornamenti al set predefinito di crittografie supportate dai server Apigee per migliorare la sicurezza potrebbero causare errori Unsupported protocol per alcune versioni TLS. I clienti che riscontrano questi errori devono consultare l'elenco completo delle crittografie supportate dalla build FIPS di Envoy.

315874988 Apigee APRI Con le richieste proxy gRPC, i trailer gRPC vengono rimossi dalla risposta

Quando viene effettuata una chiamata a un server di destinazione gRPC, l'unico trailer che viene restituito è il trailer "grpc-status". Tutti gli altri trailer vengono rimossi dalla risposta.