Consulta i connettori supportati per Application Integration.

Visualizza i log di esecuzione in Application Integration

Application Integration genera messaggi di log 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 integrazione, attività o evento non riusciti. Per ulteriori informazioni 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.
Vai ai log di Application Integration
Nel menu di navigazione, fai clic su Log. In alternativa, nel menu di navigazione, fai clic su Integrazione e seleziona l'integrazione per cui vuoi visualizzare i log. Quindi, 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, Application Integration genera l'errore Response size too large e i log non vengono caricati nella pagina Log di esecuzione. In questo caso, usa il metodo projects.locations.integrations.executions.list, come spiegato nella scheda API.
Nell'elenco Regione, seleziona la regione per visualizzare i log di esecuzione dell'integrazione specifici per la regione. Puoi anche fare clic su aggiorna Aggiorna log per ricaricare l'elenco di log attuale.

La seguente immagine mostra una pagina di esempio relativa ai log di esecuzione di Application Integration.

Per ogni messaggio di log di esecuzione vengono visualizzati i seguenti attributi.
- 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.
  - Sospesa: indica che l'esecuzione dell'integrazione è temporaneamente in pausa e richiede un intervento manuale per riprenderla.
- Ora di inizio:il timestamp relativo all'inizio dell'esecuzione dell'integrazione.
- Durata: tempo impiegato per l'esecuzione dell'integrazione.
  Nota: non utilizzare il valore Duration per calcolare la latenza dell'esecuzione end-to-end di un'integrazione. Il tempo visualizzato nella colonna Durata non riflette il tempo totale di esecuzione 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 per l'autenticazione non viene indicato nel valore Durata.
- Integration Version: la versione dell'integrazione eseguita.
- ID attivatore: valore dell'ID dell'attivatore.
Nel campo Filtro, aggiungi i filtri. Puoi filtrare i log in base a criteri come nome dell'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 le dimensioni dei log di esecuzione superano i 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 il quale 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.
Per ottenere il log Execution (ID esecuzione) per l'ID esecuzione, crea una richiesta POST utilizzando il metodo projects.locations.integrations.executions.list con un filtro sull'ID esecuzione 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'integrazione, utilizza il seguente formato:

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 dell'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 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 di integrazione.
Fai clic su Log nella barra degli strumenti dell'editor di integrazione per visualizzare i messaggi di log.
Fai clic su Aggiungi un filtro per visualizzare l'elenco dei filtri disponibili.
Seleziona Nome integrazione.
Inserisci il nome dell'integrazione, poi fai clic su Applica.
Fai clic su Aggiungi un filtro per visualizzare l'elenco dei filtri disponibili.
Seleziona Stato di esecuzione per visualizzare l'elenco degli stati.
Seleziona la casella di controllo FAILED, 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'errore. Ad esempio, inserisci:
- Data di inizio: seleziona 2020-12-16
- Da orario: seleziona 04:00:00 PM
- A oggi: seleziona 2019-12-16
- All'ora: seleziona 05:00:00 PM
- Fai clic su Applica.

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

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 completa dello stack dell'eccezione.

immagine che mostra errori di eccezione dei log espansi

Errori del connettore di Trace

Puoi utilizzare i messaggi di log dell'esecuzione per risolvere i problemi e tracciare le esecuzioni non riuscite delle 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, esegui questi passaggi:

Vai alla pagina Log di esecuzione dell'integrazione desiderata.
Espandi il messaggio di log dell'esecuzione non riuscita e l'analisi dello stack nella riga contenente l'attività Connettori non riuscita.
Nella colonna Stato, fai clic su Non riuscito.

Application Integration esegue automaticamente la query richiesta per l'attività dei connettori non riusciti 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 ulteriori informazioni su come utilizzare Esplora log, consulta Interfaccia 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 quell'integrazione.

Passaggi successivi

Per informazioni sui log in Application Integration, vedi Introduzione ai log.