Visualizzare Cloud Logging per Dataform

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

Ogni chiamata al flusso di lavoro Dataform viene registrata utilizzando Cloud Logging. La registrazione è attivata automaticamente per le invocazioni del flusso di lavoro Dataform, che possono comportare addebiti di fatturazione di Cloud Logging. Per ulteriori informazioni, consulta Prezzi di Dataform.

Autorizzazioni e ruoli

Il ruolo Visualizzatore log (roles/logging.viewer) ti consente di accedere di sola lettura a tutte le funzionalità di Logging. Per saperne di più sui ruoli e sulle autorizzazioni IAM applicati 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 di Dataform vengono indicizzati dal repository Dataform.

Formato del log

Dataform invia i messaggi di log di chiamata 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"
}

Che cosa viene registrato nei log

Le voci di log di Dataform contengono informazioni utili per monitorare ed eseguire il debug delle invocazioni del flusso di lavoro.

Le voci dei 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

Configurare metriche e avvisi con Cloud Monitoring

Puoi utilizzare Cloud Monitoring per osservare le tendenze nei log e per ricevere notifiche quando si verificano le condizioni che descrivi.

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 inviano notifiche delle modifiche nel tempo.
    • Per creare grafici che mostrano le variazioni nel tempo.
  • Avvisi basati su log, che ti avvisano ogni volta che un evento specifico viene visualizzato in un log.

Per ulteriori informazioni sulle metriche e sugli avvisi basati su log, consulta Monitorare i log.

Per scoprire come configurare gli avvisi basati su log per le invocazioni del flusso di lavoro Dataform, consulta Configurare gli avvisi per le invocazioni del flusso di lavoro non riuscite.

Passaggi successivi