Log del sincronizzatore

I log sono un buon modo per risolvere i problemi con l'installazione ibrida di Apigee. Per maggiori dettagli, consulta Logging.

Puoi visualizzare i log delle sincronizzazioni Apigee utilizzando il comando kubectl logs. Ad esempio: 
kubectl logs -n apigee apigee-synchronizer-apigee-example-test

Voci di log del sincronizzatore

Nella tabella seguente sono descritti i campi che verranno visualizzati nei file di log del programma di sincronizzazione.

Campo Indica
org: Nome dell'organizzazione
env: Nome ambiente
target: Percorso dell'entità a cui rappresenta la voce di log
action: Azione SYNC=Azione di sincronizzazione upstream

REPLICATE=Azione di replica/download
context-id: La versione del contratto, se applicabile

Ad esempio:

2019-02-05 00:00:59,098 org:hybrid env:test target: action:SYNC context-id: mode: Apigee-Timer-5 INFO  CONFIG-CHANGE - SyncContext.syncUpStream() : Upstream sync started with https://apigee.googleapis.com

Informazioni sui log del sincronizzatore

Per risolvere un problema con il sincronizzatore, esamina i file di log. La tabella seguente può aiutarti a risolvere gli errori visualizzati nei log del sincronizzatore. Vedi anche Logging.

Voce di log Che cosa significa
org:test env:dev target: action:SYNC context-id: mode: Apigee-Timer-0 INFO CONFIG-CHANGE - SyncContext.syncUpStream() : Upstream sync started with http://localhost:8080 Il sondaggio upstream è stato avviato per l'organizzazione e l'ambiente e ha ricevuto l'URL del piano di gestione
2019-01-21 16:58:02,275 org:test env:qa target: action:SYNC context-id: mode: Apigee-Timer-1 INFO CONFIG-CHANGE - ManagementServerBasedReplicationContext.getContract() : Upstream contract poll returned 200 Il contratto è stato ricevuto
2019-01-21 16:58:02,536 org:test env:dev target: action:SYNC context-id: mode: Apigee-Timer-0 INFO CONFIG-CHANGE - ManagementServerBasedReplicationContext.getContract() : Received a new contract version 20190121.090851.339 È stata ricevuta una versione del contratto
2019-01-21 17:58:56,530 org:test env:qa target:/organizations/test/environments/qa action:REPLICATE context-id:20190121.090859.699 mode: Apigee-Timer-1 INFO CONFIG-CHANGE - ConfigReplicator.startReplication() : Replication started Indica l'inizio della replica. I campi MDC indicano i dettagli di ciò che viene replicato
2019-01-21 17:58:56,654 org:test env:qa target:/organizations/test/environments/qa/resourcefiles/js/JavaScriptCallout.js action:REPLICATE context-id:20190121.090859.699 mode: Apigee-Timer-1 INFO CONFIG-CHANGE - ConfigReplicator.startReplication() : Replication complete Indica che la replica è stata completata. I campi MDC indicano i dettagli di ciò che viene replicato
2019-01-21 17:58:56,654 org:test env:qa target:/organizations/test/environments/qa action:REPLICATE context-id:20190121.090859.699 mode: Apigee-Timer-1 ERROR CONFIG-CHANGE - ConfigReplicator.startReplication() : Replication failed Indica un errore di replica
2019-01-21 17:59:00,246 org:test env:qa target: action:SYNC context-id: mode: Apigee-Timer-1 INFO CONFIG-CHANGE - SyncContext.syncUpStream() : Upstream sync finished in 4 seconds Indica la fine di un ciclo di sincronizzazione e fornisce anche il tempo necessario per la sincronizzazione
2019-01-21 18:00:00,249 org:test env:dev target: action:SYNC context-id: mode: Apigee-Timer-1 INFO CONFIG-CHANGE - ManagementServerBasedReplicationContext.getContract() : Upstream contract poll returned 304 Indica che non era disponibile un contratto più recente
2019-01-21 18:21:39,128 org:test env:qa target: action:SYNC context-id: mode: Apigee-Timer-1 ERROR CONFIG-CHANGE - ManagementServerBasedReplicationContext.getContract() : Upstream contract poll returned error 0 Indica che il piano di gestione non era raggiungibile
2019-01-21 18:21:39,128 org:test env:qa target: action:SYNC context-id: mode: Apigee-Timer-1 ERROR CONFIG-CHANGE - ManagementServerBasedReplicationContext.getContract() : Upstream contract poll returned error 404 Indica che il piano di gestione ha restituito una risposta 404 per il contratto
2019-01-21 18:22:39,217 org:test1 env:dev target: action:SYNC context-id: mode: Apigee-Timer-2 ERROR CONFIG-CHANGE - ManagementServerBasedReplicationContext.getContract() : Upstream contract poll returned error 403 Indica che l'ambiente per il polling non è abilitato per ambienti ibridi
2019-01-21 18:22:39,217 org:test1 env:dev target: action:SYNC context-id: mode: Apigee-Timer-2 ERROR CONFIG-CHANGE - ManagementServerBasedReplicationContext.getContract() : Upstream contract poll returned error 401 Le credenziali fornite presentano alcuni problemi

Risoluzione degli errori

I log sono un ottimo modo per risolvere i problemi di installazione. Per maggiori dettagli, consulta Logging.

Impossibile avviare il programma di sincronizzazione

Di seguito sono riportati alcuni errori e la relativa correzione. Ciascuno di questi messaggi di errore inizia con un ErrorCode di tipo sync.xxxxx. Di seguito sono riportati alcuni possibili codici di errore

sync.NullOrEmptyConfig

Messaggio: configurazione nulla o vuota fornita tramite com.apigee.sync.config

Motivo: viene visualizzato questo messaggio di errore quando le proprietà di configurazione del sincronizzatore non sono state fornite correttamente.

Soluzione: assicurati che tutte le proprietà di configurazione siano compilate con i valori appropriati.

sync.ConfigFileNotFound

Motivo: il sincronizzatore è stato impostato per leggere le proprietà di configurazione da un file, ma non è stato possibile caricare il file

Rimedio: assicurati che il file sia disponibile e accessibile durante l'avvio del sincronizzatore

sync.IncorrectSettings

Motivo: una o più proprietà di configurazione obbligatorie mancano nella configurazione del sincronizzatore oppure presentano valori che non rientrano nell'intervallo previsto. L'errore dovrebbe includere maggiori dettagli sulla proprietà esatta che causa il problema. Questi errori sono integrati nell'analizzatore sintattico per fare in modo che e durante l'impostazione vengano rilevati anche prima dell'avvio del servizio.

Nella tabella seguente sono elencati alcuni possibili errori di ErrorSettings:

Errore Qual è il problema
configuration.json.IncorrectSettings: [com.apigee.sync.config.json] Error:/controlPlane/retries numeric instance is greater than the required maximum (maximum: 3, found: 20) Il valore fornito al campo Nuovi tentativi nella sezione controlPlane ha superato il valore consentito
configuration.json.IncorrectSettings: [com.apigee.sync.config.json] Error:/controlPlane/connectionTimeout numeric instance is lower than the required minimum (minimum: 10, found: 1) Il valore fornito al campo connectionTimeout nella sezione controlPlane è inferiore a quanto consentito
configuration.json.IncorrectSettings: [com.apigee.sync.config.json] Error:/controlPlane object has missing required properties ([\"contractProvider\"]) Nella sezione controlPlane manca il campo obbligatorio contractProvider
configuration.json.IncorrectSettings: [com.apigee.sync.config.json] Error:/controlPlane/contractProvider string \"http://\\uapi.apigee.com\" is not a valid URI L'URI del fornitore del contratto non è valido
configuration.json.IncorrectSettings: [com.apigee.sync.config.json] Error:/environments array is too short: must have at least 1 elements but instance has 0 elements L'array di ambienti deve avere almeno un ambiente
configuration.json.IncorrectSettings: [com.apigee.sync.config.json] Error:/environments/0 object has missing required properties ([\"environmentName\"]) Nell'ambiente all'indice 0 manca il campo obbligatorio environmentName
configuration.json.IncorrectSettings: [com.apigee.sync.config.json] Error:/environments/0 object has missing required properties ([\"organizationName\"]) Nell'ambiente all'indice 0 manca il campo obbligatorio organizationName
configuration.json.IncorrectSettings: [com.apigee.sync.config.json] Error:/environments/0/pollInterval numeric instance is lower than the required minimum (minimum: 60, found: 6) L'ambiente all'indice 0 ha un intervallo di polling che è inferiore al limite consentito di 60

Rimedio: correggi l'impostazione in modo da includere il blocco richiesto

sync.ReplicationRootDoesNotExist

Motivo: al sincronizzatore è stata fornita una radice di replica che non esiste

Rimedio: verifica che la cartella principale fornita esista e sia scrivibile

sync.ReadOnlyReplicationRoot

Motivo: al sincronizzatore è stata fornita una radice di replica che non dispone delle autorizzazioni di scrittura

Rimedio: verifica che la cartella principale fornita esista e sia scrivibile

sync.ReplicationRootNotADir

Motivo: il sincronizzatore è stato fornito con una radice di replica, che potrebbe essere un file

Rimedio: verifica che la cartella principale fornita esista e sia scrivibile

sync.InvalidControlPlaneURL

Motivo: al sincronizzatore è stato fornito un URL di configurazione vuoto

Rimedio:assicurati che la cartella principale fornita esista e sia scrivibile

sync.InvalidControlPlaneSubscriptionURL

Motivo: al sincronizzatore è stato fornito un URL di configurazione errato, incompleto o vuoto per la creazione dell'abbonamento.

Soluzione: correggi l'URL specificando un URL di configurazione valido per la creazione di abbonamenti Pub/Sub al fine di gestire gli indicatori dal piano di controllo.

sync.InvalidControlPlaneUnsubscriptionURL

Motivo: al sincronizzatore è stato fornito un URL di configurazione errato, incompleto o vuoto per l'eliminazione della sottoscrizione.

Soluzione: correggi l'URL specificando un URL di configurazione valido per l'eliminazione delle sottoscrizioni Pub/Sub al fine di gestire gli indicatori dal piano di controllo.

sync.CannotCreateEnvironmentFolder

Motivo: il sincronizzatore ha tentato di creare una cartella per la replica della domanda dell'ambiente, ma non è riuscito a creare la cartella richiesta

Soluzione: assicurati che la radice di replica non abbia un percorso in conflitto con lo stesso nome che sia di sola lettura di un file.

sync.DuplicateEnvironmentEntries

Motivo: lo stesso ambiente è stato aggiunto più volte nella configurazione.

Rimedio: ogni ambiente può essere specificato solo una volta.

sync.DiskExceedsAllowedCapacity

Motivo: il disco di archiviazione fornito ha già raggiunto la soglia di capacità fornita tramite le proprietà di configurazione.

Soluzione:assicurati che lo spazio su disco sia sufficiente o controlla se le impostazioni di archiviazione possono essere modificate per concedere più spazio su disco.

sync.OwnershipClaimFailed

Motivo: il sincronizzatore ha tentato di rivendicare la proprietà sulla cartella dell'ambiente, ma l'operazione non è riuscita

Rimedio: ogni sincronizzatore cercherà innanzitutto di verificare di essere l'unico autore del file system. L'errore indica il percorso e il motivo dell'errore. Risolvi la causa principale

Errori del sincronizzatore durante il runtime

Durante il runtime possono verificarsi i seguenti errori del sincronizzatore.

sync.replicators.PollReturnedError

Il messaggio associato includerà lo stato upstream. Di seguito sono riportati gli stati di errore

stato 0

Motivo: indica un problema di connettività. Il piano di gestione non era raggiungibile

Soluzione: assicurati che i dettagli del piano di gestione siano corretti e che l'API Contratti sia raggiungibile

stato 404

Motivo: molto probabilmente il nome dell'organizzazione/env non si trova sul server

Soluzione: assicurati che i dettagli del piano di gestione siano corretti e che l'API Contratti sia raggiungibile

stato 401

Motivo: molto probabilmente le credenziali fornite non dispongono dei privilegi di amministratore dell'organizzazione.

Soluzione: assicurati che le credenziali del piano di gestione siano corrette e che l'API Contratti sia raggiungibile.

stato 403

Motivo: indica che l'ambiente per cui si esegue il polling non è configurato come ambiente ibrido

Rimedio: assicurati che l'organizzazione abbia il flag obbligatorio "features.hybrid.enabled=true".

sync.OwnershipClaimedByOther

Motivo: durante l'operazione, synchronousr ha rilevato che la radice del file è accessibile da parte di un'altra istanza di Syncr. (Questo può accadere quando un file system viene condiviso tra i sincronizzatori.)

Soluzione: risolvi il problema principale per assicurarti che due istanze del sincronizzatore non condividano lo stesso file system. Il programma di sincronizzazione si sarebbe contrassegnato e si troverebbe in una posizione non recuperabile. Assicurarsi inoltre che l'altro sincronizzatore che accede alla stessa radice file riceva una notifica al riguardo tramite i propri file di proprietà.

sync.DiskExceedsAllowedCapacity

Motivo: durante l'operazione, il sincronizzatore si è reso conto che l'occupazione del disco ha superato il limite consentito.

Soluzione: a questo punto, il sincronizzatore interrompe tutti i download e prova un'operazione di pulizia dei file inattivi. Tuttavia, questa potrebbe diventare una condizione ricorrente e l'unico modo per un ripristino completo è assicurarsi che il sincronizzatore disponga di memoria su disco sufficiente per funzionare.

Diagnosi degli errori di download del contratto

Se visualizzi "polling del contratto upstream" in un messaggio di errore, prova a chiamare l'API del contratto e controlla i dettagli, dove nome utente è il tuo nome utente Apigee (il tuo indirizzo email). Il contratto rappresenta l'intera raccolta di dati che il sincronizzatore scarica dal piano di gestione.

curl https://apigee.googleapis.com/v1/organizations/org/environments/env/contracts/1.0 -u username