Log del sincronizzatore

Stai visualizzando la versione 1.2 di Documentazione di Apigee hybrid. This version is end of life. You should upgrade to a newer version. Per ulteriori informazioni, vedi Versioni supportate.

Version 1.2 (unsupported)

Versioni supportate:

• v1.12 (più recente)                        
• v1.11                         
• v1.10                                        
• Elenco delle versioni supportate

Versioni non supportate:

• v1.9                                         
• v1.8                                         
• v1.7                                         
• v1.6                                         
• v1.5                                         
• v1.4                                         
• v1.3                                         
• v1.2                                         
• v1.1                                         

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

Voci di log del sincronizzatore

La seguente tabella descrive i campi che vedrai nella 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://api.enterprise.apigee.net

Informazioni sui log del sincronizzatore

Per risolvere un problema con il sincronizzatore, dai un'occhiata ai file di log. La tabella seguente può aiutarti risolvere gli errori che possono essere 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 fornito 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 sincronizzare
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 dell'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 iniziano 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:verifica che tutte le proprietà di configurazione vengono compilati con i valori appropriati.

sync.ConfigFileNotFound

Motivo: il sincronizzatore è stato impostato per leggere i suoi di configurazione di un file, ma non è stato possibile caricato

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

sync.IncorrectSettings

Motivo: una o più configurazioni richieste Proprietà non presenti nella configurazione del sincronizzatore non compresi nell'intervallo previsto. L'errore deve avere ulteriori dettagli sulla proprietà esatta che causa il problema. Questi errori sono integrati nel parser per garantire che, e gli errori di impostazione vengono rilevati anche prima dell'avvio del servizio.

Nella tabella seguente sono elencate alcune possibili impostazioni errate. errori:

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 limite consentito
configuration.json.IncorrectSettings: [com.apigee.sync.config.json] Error:/controlPlane/connectionTimeout numeric instance is lower than the required minimum (minimum: 10, found: 1)	Valore fornito al campo connectionTimeout in controlPlane la sezione è inferiore a quella consentita
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 sondaggio che si trova sotto il limite consentito di 60

Rimedio:correggi l'impostazione in modo da includere i valori richiesti. blocca

sync.ReplicationRootDoesNotExist

Motivo: al sincronizzatore è stato fornito radice di replica inesistente

Soluzione:assicurati che la cartella principale fornita esiste ed è scrivibile

sync.ReadOnlyReplicationRoot

Motivo: al sincronizzatore è stato fornito radice di replica che non dispone di autorizzazioni di scrittura

Soluzione:assicurati che la cartella principale fornita esiste ed è scrivibile

sync.ReplicationRootNotADir

Motivo: al sincronizzatore è stato fornito radice di replica, che potrebbe essere un file

Soluzione:assicurati che la cartella principale fornita esiste ed è scrivibile

sync.InvalidControlPlaneURL

Motivo: al sincronizzatore è stato fornito l'URL di configurazione, che è vuoto

Soluzione:assicurati che la cartella principale fornita esiste ed è scrivibile

sync.InvalidControlPlaneSubscriptionURL

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

Soluzione:correggi l'URL inserendo un URL di configurazione valido per Creazione di abbonamenti Pub/Sub per gestire gli indicatori dal piano di controllo.

sync.InvalidControlPlaneUnsubscriptionURL

Motivo: il sincronizzatore è stato fornito con un URL di configurazione errato, incompleto o vuoto per l'eliminazione dell'abbonamento.

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

sync.CannotCreateEnvironmentFolder

Motivo: il sincronizzatore ha tentato di creare un per la replica dell'ambiente ma non è stato possibile creare cartella richiesta

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

sync.DuplicateEnvironmentEntries

Motivo: nello stesso ambiente sono stati aggiunti più elementi volte nella configurazione.

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

sync.DiskExceedsAllowedCapacity

Motivo: il disco di archiviazione fornito si trova già nella posizione soglia fornita tramite le proprietà di configurazione.

Soluzione:assicurati che lo spazio su disco o controlla se le impostazioni di archiviazione possono essere modificate per consentire spazio.

sync.OwnershipClaimFailed

Motivo: il sincronizzatore ha tentato di rivendicare la proprietà sulla cartella dell'ambiente, ma non hanno

Rimedio: ogni sincronizzatore proverà prima a verifica che sia l'unico autore del file system. Errore indica il percorso e il motivo dell'errore. Gestire la radice causa

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à. La il piano di gestione non era raggiungibile

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

stato 404

Motivo: molto probabilmente il nome dell'organizzazione o dell'ambiente non è trovato sul server

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

stato 401

Motivo: molto probabilmente le credenziali fornite no disporre dei privilegi amministrativi dell'organizzazione.

Soluzione:assicurati che il piano di gestione le credenziali siano corrette e l'APIcontracts raggiungibile

stato 403

Motivo: indica l'ambiente sottoposto a polling per i quali non è configurato come ambiente ibrido

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

sync.OwnershipClaimedByOther

Motivo: durante l'operazione è stato trovato il sincronizzatore che alla radice del file è accessibile da parte di un'altra istanza di Sincronizzatore. (Questo può accadere quando un file system viene condiviso tra Synchronizers.)

Soluzione:risolvi il problema principale per verificare che due istanze di sincronizzazione non condividono lo stesso file system. La Il programma di sincronizzazione si sarebbe spostato in basso non recuperabile. Si assicura anche che l'altro Il sincronizzatore che accede alla stessa radice del file riceve una notifica tramite i file di proprietà

sync.DiskExceedsAllowedCapacity

Motivo: durante l'operazione, Sincronizzatore notato che l'occupazione del disco ha superato il limite consentito limite.

Rimedio: a questo punto il sincronizzatore viene interrotto eventuali download e prova un'operazione di pulizia dei file inattivi. Tuttavia, questo potrebbe diventare una condizione ricorrente e l'unico modo per è assicurarsi che il sincronizzatore abbia memoria su disco sufficiente per l'esecuzione delle operazioni.

Diagnosi degli errori di download del contratto

Se visualizzi "sondaggio sul contratto upstream" in un messaggio di errore, prova la chiamata all'API contratto e controllare i dettagli, dove Username il tuo nome utente Apigee (il tuo indirizzo email). Il contratto rappresenta l'intera raccolta di dati da cui il sincronizzatore scarica il piano di gestione.

curl https://api.enterprise.apigee.net/v1/organizations/org/environments/env/contracts/1.0 -u username