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 e 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 su limitazioni e prezzi, vedi 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.

    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 crea una nuova integrazione per la quale vuoi abilitare Cloud Logging.

    L'integrazione viene aperta nell'editor dell'integrazione.

  4. Seleziona la versione DRAFT della tua integrazione. Non puoi modificare le impostazioni di una versione pubblicata o non pubblicata che non si trovi in modalità bozza. Per un elenco delle versioni delle integrazioni, vedi Versioni.
  5. Fai clic su (Riepilogo dell'integrazione) nella barra degli strumenti di 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 delle integrazioni, consulta Stati di esecuzione.

    2. Fai clic su Salva.

visualizza i log

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

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

    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 e poi su Visualizza log cloud.
    • Nell'editor dell'integrazione, dopo aver testato un'integrazione, nel riquadro Testa l'integrazione, fai clic su Visualizza log Cloud.

    Viene visualizzata la pagina Esplora log. I log sono 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, vedi il Payload log_entries.

Query di esempio

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

  • Per visualizzare tutti i log di esecuzione delle integrazioni:

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

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

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

  • Per visualizzare i log di esecuzione delle integrazioni 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 delle integrazioni non riuscite per una specifica integrazione:

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

  • Per visualizzare i log con un nome di parametro di richiesta specifico. 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 di richiesta e risposta non vengono visualizzati nei dettagli di logging. Per informazioni su quote e 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, vedi Prezzi di Cloud Logging.

Passaggi successivi