Consulta i connettori supportati per Application Integration.
Visualizza i log di esecuzione in Application Integration
Application Integration genera messaggi di log dell'esecuzione per ogni esecuzione di un'integrazione. I messaggi di log contengono informazioni che possono essere utili per determinare lo stato di ogni passaggio di un'integrazione o per risolvere i problemi relativi a un'integrazione, un'attività o un evento non riusciti. Per saperne di più sul logging in Application Integration, consulta Introduzione ai log.
Visualizza i log di esecuzione dell'integrazione
Per visualizzare la pagina Log di esecuzione, seleziona una delle opzioni:
Console
- In Application Integration, vai alla pagina Log.
- Nel menu di navigazione, fai clic su Log. In alternativa, nel menu di navigazione, fai clic su Integration (Integrazione) e seleziona l'integrazione di cui vuoi visualizzare i log. Poi, fai clic su Visualizza i log di esecuzione per questa integrazione. Viene visualizzata la pagina Log di esecuzione.
- Dall'elenco Regione, seleziona la regione per visualizzare i log di esecuzione dell'integrazione specifici per regione. Puoi anche fare clic su
refresh
Aggiorna log per ricaricare l'elenco di log corrente.
L'immagine seguente mostra una pagina di esempio Log di esecuzione di Application Integration.
Per ogni messaggio di log dell'esecuzione vengono visualizzati i seguenti attributi.
- Integration name (Nome dell'integrazione): il nome dell'integrazione.
- ID esecuzione: un identificatore univoco generato per ogni esecuzione di un'integrazione.
- Stato: stato dell'esecuzione dell'integrazione.
- In corso: indica che l'integrazione è attualmente in esecuzione.
- Riuscito:indica che l'integrazione è stata eseguita correttamente.
- Non riuscita: indica che l'esecuzione dell'integrazione non è riuscita.
- Annullata: indica che l'esecuzione dell'integrazione è stata annullata dall'utente.
- In attesa:indica che l'esecuzione dell'integrazione è temporaneamente in pausa ed è in attesa del completamento di un evento o di un'azione.
- Riprova in attesa: indica che l'esecuzione dell'integrazione non è riuscita ed è in attesa di un nuovo tentativo.
- Sospeso: indica che l'esecuzione dell'integrazione è temporaneamente in pausa e richiede un intervento manuale per riprendere l'integrazione.
- Ora di inizio:timestamp di inizio dell'esecuzione dell'integrazione.
- Durata: tempo necessario per l'esecuzione dell'integrazione.
- Integration Version (Versione dell'integrazione): la versione dell'integrazione eseguita.
- ID attivatore: valore ID dell'attivatore.
- Cloud Logging:indica se l'integrazione è configurata per accedere a Cloud Logging. Se Cloud Logging è abilitato, questo campo fornisce un link per visualizzare i log in Cloud Logging. Se Cloud Logging non è abilitato, questo campo è impostato su Disabled (Disabilitato).
- Aggiungi filtri nel campo Filtro. Puoi filtrare i log in base a criteri come nome integrazione, ID esecuzione, intervallo di data o ora, stato di esecuzione, tipo di variabile e nome o valore della variabile. Per una ricerca più personalizzata, utilizza il metodo
projects.locations.integrations.executions.list
come spiegato nella scheda API.
API
Se la dimensione dei log di esecuzione è superiore a 300 MB, Application Integration genera l'errore Response too large error
e i log non vengono caricati nella pagina Log di esecuzione. In questo caso, devi utilizzare il metodo projects.locations.integrations.executions.list
per ottenere i log. Per visualizzare i log utilizzando il metodo API:
- Per ottenere l'ID esecuzione per cui vuoi visualizzare i log di esecuzione, crea una richiesta
GET
utilizzando il metodoprojects.locations.integrations.executions.list
con il parametrosnapshotMetadataWithoutParams
impostato suTRUE
:curl -v -X -G GET -H "Content-Type: application/json" -H "Authorization: Bearer $(gcloud auth print-access-token)" -d 'snapshotMetadataWithoutParams=true' 'https://integrations.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/integrations/INTEGRATION_NAME/executions'
Gli ID esecuzione vengono restituiti nella risposta. Copia l'ID esecuzione per il quale vuoi visualizzare i log.
- Per ottenere il log di esecuzione per l'ID esecuzione, crea una richiesta
POST
utilizzando il metodoprojects.locations.integrations.executions.list
con un filtro sull'ID esecuzione che hai copiato nel passaggio precedente:curl -v -X -G GET -H "Content-Type: application/json" -H "Authorization: Bearer $(gcloud auth print-access-token)" -d 'filter=execution_id="EXECUTION_ID"' 'https://integrations.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/integrations/INTEGRATION_NAME/executions'
Nella risposta, vedi il campo
ExecutionDetails
per visualizzare i dettagli del log.In alternativa, nella console Google Cloud, puoi filtrare i log di esecuzione in base all'ID esecuzione.
Esempio: filtrare i log
Se vuoi filtrare la risposta in modo da elencare i log per tutte le integrazioni previste per un'unica integrazione, utilizza il formato seguente:
curl -v -X -G GET -H "Content-Type: application/json" -H "Authorization: Bearer $(gcloud auth print-access-token)" -d 'filter= workflowName!="INTEGRATION_NAME"' 'https://integrations.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/integrations/-/executions'
Utilizzare i log per risolvere i problemi
La sezione seguente spiega come risolvere gli errori utilizzando il log di esecuzione di Application Integration.
Risolvere gli errori di integrazione
I messaggi di log di esecuzione possono essere risorse preziose quando si esegue la risoluzione dei problemi di integrazioni non riuscite.
Ad esempio, se non è stato possibile eseguire un'integrazione in un periodo di tempo specifico, segui questi passaggi per accedere ai log e filtrarli in modo da risolvere l'errore:
- Cerca o seleziona l'integrazione di cui risolvere i problemi dall'elenco Integrazioni e fai clic per aprire l'editor delle integrazioni.
- Fai clic su Log nella barra degli strumenti dell'editor dell'integrazione per visualizzare i messaggi di log.
- Fai clic su Aggiungi un filtro per visualizzare l'elenco dei filtri disponibili.
- Seleziona Integration name (Nome integrazione).
- Inserisci il nome dell'integrazione e poi fai clic su Applica.
- Fai clic su Aggiungi un filtro per visualizzare l'elenco dei filtri disponibili.
- Seleziona Stato esecuzione per visualizzare l'elenco degli stati.
- Seleziona la casella di controllo NON RIUSCITA, quindi fai clic su Applica per visualizzare le integrazioni non riuscite.
- Fai clic su Aggiungi un filtro per visualizzare l'elenco dei filtri disponibili.
- Seleziona Intervallo di data/ora e inserisci l'intervallo di tempo desiderato per verificare l'eventuale presenza di errori. Ad esempio, inserisci:
- Da data: seleziona
2020-12-16
- Da ora: seleziona
04:00:00 PM
- A oggi: seleziona
2019-12-16
- All'ora di arrivo: seleziona
05:00:00 PM
.
Per impostazione predefinita, più filtri vengono combinati utilizzando la condizione AND.
- Fai clic su Applica.
- Da data: seleziona
Se l'integrazione non è riuscita durante il periodo di tempo filtrato, la pagina Log di esecuzione mostra un elenco dei messaggi di log. Ogni messaggio di log corrisponde a una specifica esecuzione dell'integrazione non riuscita.
Visualizza eccezioni analisi dello stack
Per visualizzare l'elenco delle eccezioni, fai clic su qualsiasi messaggio di log. Fai clic sui link in ogni messaggio di eccezione per visualizzare l'analisi dello stack completa dell'eccezione.
Errori del connettore di traccia
Puoi utilizzare i messaggi del log di esecuzione per risolvere i problemi e tracciare le esecuzioni non riuscite di attività dei connettori. I dati di log di un'attività del connettore non riuscita vengono archiviati utilizzando Cloud Logging e possono essere visualizzati in Esplora log.
Per accedere ai dati di log di un'attività del connettore non riuscita da Application Integration, segui questi passaggi:
- Vai alla pagina Log di esecuzione dell'integrazione che ti interessa.
- Espandi il messaggio di log dell'esecuzione non riuscita e l'analisi dello stack nella riga contenente l'attività dei connettori non riuscita.
- Nella colonna Stato, fai clic su Non riuscito.
Application Integration esegue automaticamente la query richiesta per l'attività dei connettori non riuscita e apre la pagina Esplora log per visualizzare i dati di log dell'esecuzione dettagliata.
Per recuperare manualmente i dati di log di un'attività dei connettori non riuscita, puoi eseguire la seguente query nella pagina Query di Esplora log. Per saperne di più su come utilizzare Esplora log, consulta Interfaccia di Esplora log.
Formato query
resource.type="connectors.googleapis.com/Connection" jsonPayload.integration_connectors_trace_id="EXECUTION_ID_EXECUTION_TASK_ID_EXECUTION_ATTEMPT_NUMBER"
Esempio
resource.type="connectors.googleapis.com/Connection" jsonPayload.integration_connectors_trace_id="9db51e4b-7d57-473d-931f-cc27b282dfad_1_2"
Limitazione
- Se il logging locale è disabilitato per un'integrazione, i log di esecuzione non vengono generati per quella integrazione.
Passaggi successivi
- Per informazioni sui log in Application Integration, consulta Introduzione ai log.