Consulta i connettori supportati per Application Integration.

Visualizza log di esecuzione

Application Integration genera messaggi di log di 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, a un'attività o a un evento non riusciti. Per ulteriori informazioni sulla registrazione in Integration Service, 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

Per visualizzare la pagina Log di esecuzione, seleziona una delle opzioni:

Console

1. In Application Integration, vai alla pagina Log.

   Vai a Log di Application Integration

2. 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.
   Nota: se le dimensioni dei log di esecuzione sono superiori a 300 MB, l'integrazione delle applicazioni 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.
3. Nell'elenco Regione, seleziona la regione per visualizzare i log di esecuzione specifici della regione dell'integrazione. Puoi anche fare clic su Aggiorna Aggiorna log per ricaricare l'elenco corrente dei log.

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

   

   Per ogni messaggio del 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 è in fase di esecuzione.
     • Riuscito: indica che l'integrazione è stata eseguita correttamente.
     • Non riuscito: 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 in attesa del completamento di un evento o di un'azione.
     • Riprovare in attesa: indica che l'esecuzione dell'integrazione non è riuscita e che è 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 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 necessario per l'integrazione prima o dopo la sua esecuzione. Ad esempio, il tempo necessario per l'applicazione delle quote o l'autenticazione non viene indicato nel valore Duration.
   • Versione integrazione: versione dell'integrazione eseguita.
   • ID attivatore: valore ID dell'attivatore.
   • Cloud Logging: indica se l'integrazione è configurata per eseguire il logging 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 Disabled (Disabilitato).
   • Ripeti da: se l'esecuzione dell'integrazione viene riprodotta, questo campo fornisce l'ID dell'esecuzione riprodotta. Puoi riprodurre un'esecuzione dell'integrazione pubblicata quando vuoi eseguire di nuovo 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 riprodurre le esecuzioni, consulta Riprodurre le esecuzioni.

4. Nel campo Filtro, aggiungi i filtri. Puoi filtrare i log in base a criteri quali nome dell'integrazione, ID esecuzione, intervallo di date o ore, 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.

   Per aggiungere un filtro per le esecuzioni degli scenari di test, utilizza il formato seguente:

   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 il quale vuoi elencare le esecuzioni del test.

   Ad esempio, Integration name:example-integration-name:example-test-case.

API

Se le dimensioni dei log di esecuzione sono superiori a 300 MB, l'integrazione delle applicazioni 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:

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 -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.

2. Per ottenere il log di esecuzione per l'ID esecuzione, crea una richiesta POST utilizzando il metodo projects.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, consulta 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 i problemi di integrazione

I messaggi di log di esecuzione possono essere risorse preziose durante la risoluzione dei problemi delle 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 Risolvi l'errore:

1. Cerca o seleziona l'integrazione da risolvere dai problemi dall'elenco Integrazioni e fai clic per aprire l'Editor integrazioni.
2. Fai clic su Log nella barra degli strumenti dell'editor dell'integrazione per visualizzare i messaggi di log.
3. Nel campo Execution log filter (Filtro log di esecuzione), seleziona Integration name (Nome integrazione) e inserisci il nome dell'integrazione per la quale vuoi visualizzare i log.
4. Fai clic su Invio.
5. Per visualizzare le integrazioni non riuscite, nel campo Filtro log esecuzione, seleziona Stato esecuzione per visualizzare l'elenco degli stati e poi seleziona Non riuscita.
6. Per visualizzare le integrazioni non riuscite tra un intervallo di tempo specifico, nel campo Filtro log di esecuzione seleziona Data di inizio successiva e inserisci l'ora desiderata nel formato valido. Quindi, seleziona Data di fine precedente e inserisci l'ora desiderata. 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 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 completa dello stack dell'eccezione.

Nota: I parametri evento del messaggio di log di esecuzione (stringa o JSON) vengono troncati con un limite di 2000 caratteri.

Errori del connettore di traccia

Puoi utilizzare i messaggi del log di esecuzione per risolvere i problemi e monitorare le esecuzioni delle attività dei connettori non riuscite. 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 dei log di un'attività dei connettori non riuscita sono disponibili in Esplora log solo se Cloud Logging è attivato per la rispettiva connessione in Integration Connectors. Per ulteriori dettagli, consulta Visualizzare i log del connettore.

Per accedere ai dati dei log di un'attività del connettore non riuscita da Integrazione applicazioni:

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 nella riga contenente l'attività dei connettori non riuscita.
3. Nella colonna Stato, fai clic su Non riuscito.

   

L'integrazione delle applicazioni esegue automaticamente la query richiesta per l'attività dei connettori non riuscita e apre la pagina Esplora log per visualizzare i dati dettagliati dei 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 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 è disattivato per un'integrazione, i log di esecuzione non vengono generati per quell'integrazione.

Passaggi successivi

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