Configurare avvisi e notifiche per le attività Dataplex

Questa pagina descrive come configurare gli avvisi per le esecuzioni di job non riuscite di un'attività Dataplex.

Puoi configurare gli avvisi utilizzando uno dei seguenti elementi:

  • Esplora log nella console Google Cloud
  • API Monitoring

Terminologia

  • Durata della chiusura automatica dell'incidente: la durata dopo la quale un incidente si chiude. se non esistono voci di log corrispondenti.
  • Tempo tra le notifiche: la quantità di tempo minimo tra la ricezione di una notifica e l'altra. per i log che corrispondono a un filtro. Eventuali log corrispondenti entro il periodo di tempo minimo vengono saltati. Il tempo minimo che puoi impostare è 5 minuti.

Configura le notifiche utilizzando Esplora log

  1. Apri la console Google Cloud nel browser.
  2. Fai clic su Menu di navigazione > Logging > Esplora log.

  3. Fai clic sul pulsante di attivazione/disattivazione Mostra query.

    1. Per configurare un avviso per l'esecuzione non riuscita di un job di qualsiasi attività Dataplex in un progetto, digita la seguente query:

      severity=ERROR
resource.type = "dataplex.googleapis.com/Task"
logName = "projects/PROJECT_NAME/logs/dataplex.googleapis.com%2Fprocess"
jsonPayload.state = "FAILED"

    2. Per configurare un avviso per un'esecuzione di job non riuscita per un'attività Dataplex specifica in un progetto, digita la seguente query:

      severity=ERROR
resource.type = "dataplex.googleapis.com/Task"
resource.labels.task_id = TASK_ID
logName = "projects/PROJECT_NAME/logs/dataplex.googleapis.com%2Fprocess"
jsonPayload.state = "FAILED"

  4. Fai clic su Crea avviso.

  5. Nel campo Nome criterio di avviso, inserisci un nome per il nuovo avviso.

  6. Nel campo Documentazione, inserisci la descrizione che vuoi includere nella la notifica. Per ulteriori informazioni sui contenuti che puoi includere nel campo della documentazione di un criterio di avviso, consulta Utilizzo di Markdown e variabili nei modelli di documentazione.

  7. Fai clic su Avanti.

  8. Scegli i log da includere nell'avviso e fai clic su Avanti.

  9. Imposta il tempo tra le notifiche e la durata della chiusura automatica degli incidenti. e fai clic su Avanti.

  10. (Facoltativo) Seleziona un canale di notifica. Per ulteriori informazioni sulla configurazione dei canali di notifica tramite la console Google Cloud, consulta Gestire i canali di notifica.

  11. Fai clic su Salva.

Configura le notifiche utilizzando l'API Monitoring

  1. Attiva l'API di monitoraggio e autorizza gli utenti ad accedervi. Per ulteriori informazioni, consulta Attivare l'API Monitoring.
  2. Imposta i ruoli o le autorizzazioni necessari per creare un criterio di avviso. Per ulteriori informazioni, consulta Autorizzazione richiesta per creare criteri di avviso.
  3. Crea un canale di notifica utilizzando la console Google Cloud oppure Google Cloud CLI.

  4. Ottieni il channel_id utilizzando il seguente comando: 

    gcloud beta monitoring channels list

  5. Crea un file policy.json con i seguenti contenuti per log-based-alerting-policy:

    1. Per configurare un avviso per un'esecuzione di job non riuscita di qualsiasi attività Dataplex in un progetto, utilizza il seguente codice:

      {
"displayName": "Alert Using Monitoring API",
"documentation": {
  "content": "Log-based alert in project PROJECT.",
  "mimeType": "text/markdown"
},

"conditions": [
  {
    "displayName": "Log match condition: Failed Job Execution",
    "conditionMatchedLog": {
      "filter": "severity=\"ERROR\" resource.type = \"dataplex.googleapis.com/Task\" logName = \"projects/PROJECT_ID/logs/dataplex.googleapis.com%2Fprocess\" jsonPayload.state = \"FAILED\"",
    },
  }
],
"combiner": "OR",

"alertStrategy": {
  "notificationRateLimit": {
    "period": "300s"
  },
  "autoClose": "604800s",
},

"notificationChannels": [
  "projects/PROJECT_ID/notificationChannels/CHANNEL_ID"
]
}

    2. Per configurare un avviso per un'esecuzione di job non riuscita per un'attività Dataplex specifica in un progetto, utilizza il seguente codice:

      {
"displayName": "Alert Using Monitoring API",
"documentation": {
  "content": "Log-based alert in project PROJECT.",
  "mimeType": "text/markdown"
},

"conditions": [
  {
    "displayName": "Log match condition: Failed Job Execution",
    "conditionMatchedLog": {
      "filter": "severity=\"ERROR\" resource.type = \"dataplex.googleapis.com/Task\" logName = \"projects/PROJECT_ID/logs/dataplex.googleapis.com%2Fprocess\" jsonPayload.state = \"FAILED\" resource.labels.task_id = \"TASK_ID\"",
    },
  }
],
"combiner": "OR",

"alertStrategy": {
  "notificationRateLimit": {
    "period": "300s"
  },
  "autoClose": "604800s",
},

"notificationChannels": [
  "projects/PROJECT_ID/notificationChannels/CHANNEL_ID"
]
}

  6. Passa il file policy.json all'interfaccia a riga di comando gcloud utilizzando il seguente comando:

    gcloud alpha monitoring policies create --policy-from-file="policy.json"

    In caso di esito positivo, il comando restituisce il nome risorsa del nuovo criterio. Ad esempio:

    Created alert policy [projects/PROJECT_ID/alertPolicies/*POLICY_ID*].

Passaggi successivi