Visualizza log di esecuzione

Application Integration genera log di esecuzione dettagliati per ogni esecuzione di un'integrazione. Puoi utilizzare i log di esecuzione per risolvere i problemi relativi alle esecuzioni delle integrazioni non riuscite, identificare lo stato di esecuzione di ogni passaggio di un'integrazione e monitorare lo stato di esecuzione delle integrazioni principali e secondarie. Per saperne di più sul logging in Application Integration, consulta Introduzione ai log.

Nota: Application Integration conserva i log di esecuzione di un'integrazione per un periodo massimo di 32 giorni.

Visualizza i log di esecuzione dell'integrazione

Puoi visualizzare i log di esecuzione nella console Google Cloud o utilizzando l'API.

Nota: se le dimensioni dei log di esecuzione sono superiori a 300 MB, Application Integration genera l'errore Response size too large e i log non vengono caricati nella pagina Log di esecuzione. In questo caso, utilizza il metodo projects.locations.integrations.executions.list come spiegato nella scheda API.

Console

Per visualizzare i log di esecuzione nella console Google Cloud , segui questi passaggi:

1. Nella console Google Cloud , vai alla pagina Application Integration.

   Vai ad Application Integration

2. Nel menu di navigazione, fai clic su Log.

   Viene visualizzata la pagina Log di esecuzione, che elenca i log di esecuzione generati per le integrazioni nella regione predefinita. Per ogni messaggio di log di esecuzione vengono visualizzati i seguenti attributi:

   • Nome integrazione: il nome dell'integrazione.
   • ID esecuzione: un identificatore univoco generato per ogni esecuzione di un'integrazione.
   • Stato: lo stato dell'esecuzione dell'integrazione.
     • In corso: indica che l'integrazione è attualmente in fase di 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 e attende il 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.
     • Sospesa: 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 impiegato per l'esecuzione dell'integrazione.
     Nota: non utilizzare il valore Durata per calcolare la latenza di esecuzione end-to-end di un'integrazione. Il tempo visualizzato nella colonna Durata non riflette il tempo di esecuzione totale di un'integrazione, in quanto non tiene conto del tempo aggiuntivo impiegato dall'integrazione prima o dopo l'esecuzione. Ad esempio, il tempo impiegato per l'applicazione della quota o l'autenticazione non si riflette nel valore Durata.
   • Versione integrazione: la versione dell'integrazione eseguita.
   • ID trigger: il valore dell'ID del trigger.
   • Cloud Logging: indica se l'integrazione è configurata per scrivere i log in 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 Disabilitato.
   • Riproduzione da: se l'esecuzione dell'integrazione viene riprodotta, questo campo fornisce l'ID esecuzione dell'esecuzione che è stata riprodotta. Puoi riprodurre l'esecuzione di un'integrazione pubblicata quando vuoi eseguire nuovamente un'integrazione con gli stessi parametri dell'esecuzione precedente. Ad esempio, puoi riprodurre un'esecuzione se un'integrazione non è riuscita a causa di un errore di timeout o se l'output di un'integrazione non è quello previsto. Per scoprire come ripetere le esecuzioni, consulta Ripeti le esecuzioni.

3. Per visualizzare i log di esecuzione specifici per una regione, cambia la regione dall'elenco Regione.
4. Se vuoi, puoi fare clic su refresh Aggiorna log per ricaricare l'elenco dei log corrente.

   L'immagine seguente mostra una pagina di esempio dei log di esecuzione di Application Integration.

   

API

Se le dimensioni dei log di esecuzione sono superiori 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, segui questi passaggi:

1. Per ottenere l'ID esecuzione per cui vuoi visualizzare i log di esecuzione, crea una richiesta GET utilizzando il metodo projects.locations.integrations.executions.list con il parametro snapshotMetadataWithoutParams impostato su TRUE:

   curl -v -X GET \
       -G \
       -H "Content-Type: application/json" \
       -H "Authorization: Bearer $(gcloud auth print-access-token)" \
       'https://integrations.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/integrations/INTEGRATION_NAME/executions' \
       -d "snapshotMetadataWithoutParams=true"
   

   Sostituisci quanto segue:

   • PROJECT_ID: l'ID del tuo progetto Google Cloud.
   • LOCATION: la regione dell'integrazione.
   • INTEGRATION_NAME: il nome dell'integrazione.

   Gli ID esecuzione vengono restituiti nella risposta. Copia l'ID esecuzione per cui vuoi visualizzare i log.

2. Per ottenere il log di esecuzione per l'ID esecuzione, crea una richiesta GET utilizzando il metodo projects.locations.integrations.executions.list con un filtro sull'ID esecuzione che hai copiato nel passaggio precedente:

   curl -X GET \
       -G \
       -H "Content-Type: application/json" \
       -H "Authorization: Bearer $(gcloud auth print-access-token)" \
       'https://integrations.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/integrations/-/executions' \
       --data-urlencode 'filter=execution_id="EXECUTION_ID"'
   

   Sostituisci quanto segue:

   • PROJECT_ID: l'ID del tuo progetto Google Cloud.
   • LOCATION: la regione dell'integrazione.
   • EXECUTION_ID: l'ID esecuzione copiato dal passaggio precedente.

   Nella risposta, controlla 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: filtra i log

Se vuoi filtrare la risposta per elencare i log di tutte le integrazioni tranne una, utilizza il seguente formato:

curl -X GET \
    -G \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    'https://integrations.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/integrations/-/executions' \
    --data-urlencode 'filter=workflow_name!="INTEGRATION_NAME"'

Sostituisci quanto segue:

• PROJECT_ID: l'ID del tuo progetto Google Cloud.
• LOCATION: la regione dell'integrazione.
• INTEGRATION_NAME: il nome dell'integrazione.

Puoi filtrare in base ai seguenti campi:

• execution_id, workflow_name e trigger_id: racchiudi questi valori di stringa tra virgolette doppie.
• state: accetta un valore di stato ExecutionDetails, ad esempio FAILED o SUCCEEDED. Non utilizzare le virgolette (ad esempio, state=FAILED).
• create_timestamp e update_time: richiedono un timestamp RFC 3339 in UTC, che termina con Z. Non utilizzare le virgolette (ad esempio, create_timestamp>=2026-10-01T00:00:00Z).

Visualizza i dettagli dell'esecuzione dell'attività

Puoi visualizzare log dettagliati sull'esecuzione di ogni attività in un'integrazione o in una sottointegrazione. Per visualizzare i dettagli di esecuzione delle attività, vai alla pagina Log di esecuzione ed espandi il nome dell'integrazione per cui vuoi visualizzare i dettagli di esecuzione delle attività.

La pagina Log di esecuzione mostra un elenco dei log di esecuzione dell'integrazione. Ogni log di esecuzione corrisponde a un'esecuzione specifica dell'integrazione.

• Per visualizzare i dettagli di esecuzione di un'attività specifica, fai clic sul nome dell'attività. Viene visualizzato il riquadro Dettagli esecuzione attività, che mostra i dettagli di esecuzione dell'attività.
  Punto chiave: il riquadro Dettagli esecuzione attività mostra i valori completi e non troncati delle variabili delle attività, consentendoti di eseguire il debug in modo efficace.
  
• Per visualizzare i parametri di richiesta e risposta dell'attività, fai clic su Parametri di richiesta o Parametri di risposta.

  

• Per visualizzare i log di esecuzione di una sub-integrazione, espandi il nome dell'attività e fai clic sul nome della sub-integrazione. Questo vale per l'attività Call Integration, l'attività For Each Parallel, l'attività For Each Loop e l'attività While Loop.

Filtra log

Puoi filtrare i log in base a criteri quali nome dell'integrazione, ID esecuzione, intervallo di date o ore, stato dell'esecuzione, tipo di variabile e nome o valore della variabile. Per aggiungere un filtro per le esecuzioni degli scenari di test, utilizza il seguente formato:

Integration name:INTEGRATION_NAME:TEST_CASE_NAME.

Sostituisci quanto segue:

• INTEGRATION_NAME: il nome dell'integrazione che contiene i test funzionali.
• TEST_CASE_NAME: il nome dello scenario di test per cui vuoi elencare le esecuzioni dei test.

Esempio: Integration name:example-integration-name:example-test-case.

Utilizzare i log per risolvere i problemi

La sezione seguente spiega come risolvere i problemi relativi ai seguenti casi d'uso:

• Risolvi i problemi di integrazione
• Visualizza le eccezioni dell'analisi dello stack
• Errori del connettore Trace

Risolvi gli errori di integrazione

I messaggi di log di esecuzione possono essere risorse preziose durante la risoluzione dei problemi delle integrazioni non riuscite.

Ad esempio, se un'integrazione non è stata eseguita in un periodo di tempo specifico, segui questi passaggi per accedere ai log e filtrarli per risolvere l'errore:

1. Cerca o seleziona l'integrazione per la risoluzione dei problemi dall'elenco Integrazioni e fai clic per aprire l'editor delle integrazioni.
2. Fai clic su Log nella barra degli strumenti dell'editor delle integrazioni per visualizzare i messaggi di log.
3. Nel campo Filtro log di esecuzione, seleziona Nome integrazione e inserisci il nome dell'integrazione per cui vuoi visualizzare i log.
4. Fai clic su Invio.
5. Per visualizzare le integrazioni non riuscite, nel campo Filtro log di esecuzione, seleziona Stato esecuzione per visualizzare l'elenco degli stati, quindi seleziona Non riuscita.
6. Per visualizzare le integrazioni non riuscite in un intervallo di tempo specifico, nel campo Filtro log di esecuzione, seleziona Data di inizio dopo e inserisci l'ora desiderata nel formato valido. Poi, seleziona Data di fine prima di e inserisci l'ora che preferisci. Per impostazione predefinita, più filtri vengono combinati utilizzando la condizione AND.

Se l'integrazione non è riuscita durante il periodo di tempo filtrato, nella pagina Log di esecuzione viene visualizzato un elenco di messaggi di log. Ogni messaggio di log corrisponde a un'esecuzione non riuscita specifica dell'integrazione.

Per informazioni sulla risoluzione dei problemi relativi ai log di esecuzione non riuscita utilizzando l'AI, consulta Risolvi i problemi relativi ai log di esecuzione non riuscita utilizzando l'AI.

Visualizza le eccezioni dell'analisi dello stack

Per visualizzare l'elenco delle eccezioni, fai clic su un messaggio di log. Fai clic sui link in ogni messaggio di eccezione per visualizzare l'analisi dello stack completa dell'eccezione.

Nota: i parametri evento dei messaggi di log di esecuzione (stringa o JSON) vengono troncati con un limite di 2000 caratteri.

Trace gli errori del connettore

Puoi utilizzare i messaggi di log di esecuzione per risolvere i problemi e tracciare le esecuzioni non riuscite della 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.

Nota: i dati di log di un'attività dei connettori non riuscita sono disponibili in Esplora log solo se Cloud Logging è abilitato per la rispettiva connessione in Integration Connectors. Per maggiori dettagli, consulta Visualizza i log del connettore.

Per accedere ai dati di log di un'attività del connettore non riuscita da Application Integration, segui questi passaggi:

1. Vai alla pagina Log di esecuzione dell'integrazione che ti interessa.
2. Espandi il messaggio di log dell'esecuzione non riuscita e l'analisi dello stack fino alla riga contenente l'attività Connectors non riuscita.
3. 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 dettagliati del log di esecuzione.

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 della 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"

Scarica i log

Puoi scaricare i log per un'esecuzione specifica dell'integrazione per facilitare il debug e l'analisi. I log contengono informazioni dettagliate sul processo di esecuzione, inclusi timestamp, eventi ed eventuali errori riscontrati.

Per scaricare i log di esecuzione di un'integrazione, segui questi passaggi:

1. Vai alla pagina Log di esecuzione.
2. Nella riga corrispondente all'esecuzione dell'integrazione per cui vuoi scaricare i log, fai clic su (menu Azioni) e poi seleziona Scarica.

I log di esecuzione vengono scaricati come file JSON nella cartella di download predefinita del browser.

Limitazione

• Se il logging locale è disabilitato per un'integrazione, i log di esecuzione non vengono generati per l'integrazione.

Passaggi successivi

• Per informazioni sui log in Application Integration, consulta Introduzione ai log.
• Scopri di più sugli scenari di test.