Visualizza i log in Cloud Logging

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 le 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, consulta Limitazioni e Prezzi.

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

Prima di iniziare

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

  1. Nella console Google Cloud , vai alla pagina Integrazione di applicazioni.

    Vai ad Application Integration

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

    Viene visualizzata la pagina Integrazioni, che elenca tutte le integrazioni disponibili nel progetto Google Cloud .

  3. Seleziona un'integrazione esistente o creane una nuova per cui vuoi attivare Cloud Logging.

    Si apre l'integrazione nell'editor integrazioni.

  4. Seleziona la versione DRAFT dell'integrazione. Non puoi modificare le impostazioni di una versione pubblicata o non pubblicata che non è in modalità bozza. Per un elenco delle versioni delle integrazioni, vedi Versioni.
  5. Fai clic su (Riepilogo integrazione) nella barra degli strumenti del designer. Viene visualizzata la pagina di riepilogo dell'integrazione.
    1. In Impostazioni log, fai clic sul pulsante di attivazione/disattivazione Attiva Cloud Logging e poi seleziona il tipo di gravità dei log che vuoi archiviare in Cloud Logging dall'elenco Gravità:
      • 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, vedi Stati di esecuzione.

    2. Fai clic su Salva.

Visualizza i log

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

  1. Nella console Google Cloud , vai alla pagina 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.
    • Nel menu di navigazione, fai clic su Log, quindi su Visualizza nel campo 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 Disattivato.
    • Nell'editor dell'integrazione, dopo aver testato un'integrazione, fai clic su Visualizza log cloud nel riquadro Testa integrazione.

    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 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 un ID esecuzione specifico:

    • Cerca solo le esecuzioni principali con l'ID esecuzione specificato: 
          resource.type="integrations.googleapis.com/IntegrationVersion"
    jsonPayload.executionId="EXECUTION_ID"
    • Ricerca delle esecuzioni principali e secondarie 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 integrazione 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 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 altre query di esempio, consulta Query di esempio di Cloud Logging.

Limitazioni

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

  • Cloud Logging supporta solo le voci di log di dimensioni massime pari a 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, consulta Prezzi di Cloud Logging.

Passaggi successivi