Visualizza Cloud Logging per Dataform

Questo documento mostra come visualizzare i log di Cloud Logging per le chiamate del flusso di lavoro Dataform.

Ogni chiamata del flusso di lavoro Dataform viene registrata utilizzando Cloud Logging. Logging è abilitato automaticamente per le chiamate del flusso di lavoro Dataform, che può comportare addebiti di Cloud Logging. Per ulteriori informazioni, consulta i prezzi di Dataform.

Autorizzazioni e ruoli

Il ruolo Visualizzatore log (roles/logging.viewer) consente l'accesso di sola lettura a tutte le funzionalità di Logging. Per ulteriori informazioni sulle autorizzazioni e sui ruoli IAM che si applicano ai dati di Cloud Logging, consulta la guida al controllo dell'accesso di Cloud Logging.

Visualizza i log

Per visualizzare i log, vai a Esplora log.

Vai a Esplora log

Per informazioni su come filtrare i log di Cloud Logging in Esplora log, consulta Visualizzare i log utilizzando Esplora log.

I log Dataform sono indicizzati dal repository Dataform.

Formato log

Dataform invia messaggi di log delle chiamate del flusso di lavoro nel seguente formato:

{
  "insertId": "14ip1tza5",
  "jsonPayload": {
    "terminalState": "SUCCEEDED",
    "workflowInvocationId": "1678383230-ac4ed48c-eb70-4555-b2b0-cda54d13edfa",
    "@type": "type.googleapis.com/google.cloud.dataform.logging.v1.WorkflowInvocationCompletionLogEntry"
  },
  "resource": {
    "type": "dataform.googleapis.com/Repository",
    "labels": {
      "repository_id": "repository-name-example",
      "resource_container": "PROJECT_ID",
      "location": "us-central1"
    }
  },
  "timestamp": "2023-03-09T17:34:06.965981805Z",
  "severity": "INFO",
  "logName": "projects/project-name-example/logs/dataform.googleapis.com%2Fworkflow_invocation_completion",
  "receiveTimestamp": "2023-03-09T17:34:07.362371980Z"
}

Cosa viene registrato

Le voci di log Dataform contengono informazioni utili per il monitoraggio e il debug delle chiamate del flusso di lavoro.

Le voci di log contengono i seguenti tipi di informazioni:

  • receiveTimestamp
  • release_config_id
  • repository_id
  • resource_container
  • workflow_invocation_id
  • workflow_config_id
  • severity: può essere INFO, WARNING o ERROR
  • terminalState: può essere SUCCEEDED, CANCELED o FAILED
  • timestamp
  • @type

Configura metriche e avvisi con Cloud Monitoring

Puoi utilizzare Cloud Monitoring per osservare le tendenze nei log e per ricevere una notifica quando si verificano le condizioni descritte.

Per fornire a Cloud Monitoring i dati dei tuoi log, Cloud Logging offre quanto segue:

  • Metriche basate su log, che puoi utilizzare come segue:
    • Per creare criteri di avviso che ti informino delle modifiche apportate nel tempo.
    • Per creare grafici che mostrano le variazioni nel tempo.
  • Avvisi basati su log, che ti avvisano ogni volta che un evento specifico compare in un log.

Per saperne di più sulle metriche basate su log e sugli avvisi basati su log, consulta Monitorare i log.

Per informazioni su come configurare avvisi basati su log per le chiamate del flusso di lavoro Dataform, vedi Configurare gli avvisi per le chiamate al flusso di lavoro non riuscite.

Passaggi successivi