Consulta i connettori supportati per Application Integration.

Visualizza i log in Cloud Logging

Questa pagina descrive come abilitare Cloud Logging per un'integrazione, visualizzare i log in Cloud Logging e alcune query di esempio per visualizzare i log di integrazione in Cloud Logging.

Panoramica

In Cloud Logging puoi visualizzare i log di esecuzione dell'integrazione contenenti i dettagli dell'integrazione, come stato, prestazioni, versione dell'integrazione, parametri di richiesta e risposta, nonché configurazioni di trigger e attività. Per saperne di più sui log di esecuzione in Cloud Logging, consulta Log di esecuzione dell'integrazione in Cloud Logging. Per informazioni sulle limitazioni e sui prezzi, consulta le sezioni Limitazioni e Prezzi.

Per impostazione predefinita, Cloud Logging è disabilitato per le integrazioni. Puoi abilitare il logging per un'integrazione modificando la versione non pubblicata dell'integrazione.

Abilita Cloud Logging

Per archiviare i log di esecuzione dell'integrazione in Cloud Logging, devi prima abilitare Cloud Logging per l'integrazione. Per farlo, segui questi passaggi:

  1. Nella console Google Cloud, vai alla pagina Application Integration (Integrazione di applicazioni).

    Vai ad Application Integration

  2. Nel menu di navigazione, fai clic su Integrations (Integrazioni).

    Viene visualizzata la pagina Integrazioni, in cui sono elencate tutte le integrazioni disponibili nel progetto Google Cloud.

  3. Seleziona un'integrazione esistente o creane una nuova per la quale vuoi abilitare Cloud Logging.

    L'integrazione viene aperta nell'editor di integrazione.

  4. Seleziona la versione DRAFT della tua integrazione. Non puoi modificare le impostazioni per una versione pubblicata o non pubblicata che non sia in modalità bozza. Per un elenco delle versioni delle integrazioni, consulta Versioni.
  5. Fai clic su (Riepilogo dell'integrazione) nella barra degli strumenti del designer. Viene visualizzata la pagina di riepilogo dell'integrazione.
    1. In Impostazioni log, fai clic sull'opzione di attivazione/disattivazione Abilita Cloud Logging, quindi, dall'elenco Gravità, seleziona il tipo di gravità dei log che vuoi archiviare in Cloud Logging:
      • Informazioni: seleziona questa opzione per acquisire tutti gli stati di esecuzione: SUCCEEDED, FAILED, PROCESSING, PENDING, SUSPENDED, RETRY_ON_HOLD e CANCELLED.
      • Errore: seleziona questa opzione per acquisire i seguenti stati di esecuzione: FAILED e CANCELLED.
      • Avviso: seleziona questa opzione per acquisire i seguenti stati di esecuzione: FAILED e CANCELLED.

        • Per un elenco degli stati di esecuzione dell'integrazione, consulta Stati di esecuzione.

    2. Fai clic su Salva.

Visualizza i log

Per visualizzare i log in Cloud Logging, devi prima abilitare Cloud Logging, quindi seguire questi passaggi:

  1. Nella console Google Cloud, vai alla pagina Application Integration (Integrazione di applicazioni).

    Vai ad Application Integration

  2. Per visualizzare i log di esecuzione dell'integrazione in Cloud Logging, utilizza uno dei seguenti metodi:
    • Nel menu di navigazione, fai clic su Log, quindi su Visualizza log cloud.
    • Nell'editor di integrazione, dopo aver testato un'integrazione, nella finestra di dialogo Testa l'integrazione, fai clic su Visualizza log cloud.

    Viene visualizzata la pagina Esplora log. I log vengono visualizzati per le ultime tre ore per la seguente query predefinita: 

    resource.type=integrations.googleapis.com/IntegrationVersion

    3. Per comprendere il formato dei log dei log di Application Integration, consulta il payload log_entries.

Query di esempio

Puoi utilizzare le seguenti query per visualizzare i log in Cloud Logging:

  • Per visualizzare tutti i log di esecuzione dell'integrazione:

        resource.type="integrations.googleapis.com/IntegrationVersion"

  • Puoi visualizzare i log di esecuzione dell'integrazione per uno specifico ID di esecuzione:

    • Cerca solo le esecuzioni padre con l'ID esecuzione specificato: 
          resource.type="integrations.googleapis.com/IntegrationVersion"
    jsonPayload.executionId="EXECUTION_ID"
    • Ricerche di esecuzioni padre e figlio avviate dall'ID esecuzione specificato: 
          resource.type="integrations.googleapis.com/IntegrationVersion"
    "EXECUTION_ID"

  • Per visualizzare i log di esecuzione dell'integrazione per un'integrazione specifica:

        resource.type="integrations.googleapis.com/IntegrationVersion"
    "INTEGRATION_NAME"
    Oppure 
        resource.type="integrations.googleapis.com/IntegrationVersion"
    jsonPayload.integration="INTEGRATION_NAME"

  • Per visualizzare le esecuzioni di integrazioni non riuscite per un'integrazione specifica:

        resource.type="integrations.googleapis.com/IntegrationVersion"
    jsonPayload.integrationExecutionDetails.integrationExecutionState="FAILED"
    jsonPayload.integration="INTEGRATION_NAME"

  • Per visualizzare i log con il nome specifico del parametro di richiesta. Ad esempio, la seguente query richiede i log per il parametro requestUrl:

        resource.type="integrations.googleapis.com/IntegrationVersion"
    "requestUrl"

    • Per altri esempi di query, consulta Query di esempio di Cloud Logging.

Limitazioni

I log di integrazione in Cloud Logging sono soggetti alle seguenti limitazioni:

  • Cloud Logging supporta solo voci di log con una dimensione massima di 256 KiB. Se i log superano questo limite, i parametri della richiesta e della risposta non vengono visualizzati nei dettagli del logging. Per informazioni sulle quote e sui limiti di Cloud Logging, consulta Quote e limiti. Per risolvere questo errore, aggiorna le variabili di integrazione in modo che il valore non superi il limite. In alternativa, puoi anche visualizzare questi log in Application Integration.
  • Se il logging locale è disabilitato, i log di esecuzione non vengono inviati a Cloud Logging anche se Cloud Logging è abilitato.

Prezzi

Per informazioni sui prezzi di Cloud Logging, consulta i prezzi di Cloud Logging.

Passaggi successivi