Configura avvisi e notifiche per le attività Dataplex

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

Puoi configurare gli avvisi utilizzando uno dei seguenti metodi:

  • Esplora log nella console Google Cloud
  • Cloud Monitoring

Terminologia

  • Durata della chiusura automatica degli incidenti: la durata dopo la quale un incidente si chiude quando non esistono voci di log corrispondenti.
  • Tempo tra le notifiche: tempo minimo tra la ricezione delle notifiche per i log che corrispondono a un filtro. Tutti i log corrispondenti entro il periodo di tempo minimo vengono ignorati. Il tempo minimo che puoi impostare è 5 minuti.

Configurare 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 l'esecuzione non riuscita di un job 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 notifica. Per ulteriori informazioni sui contenuti che puoi includere nel campo della documentazione di un criterio di avviso, consulta Utilizzare Markdown e le variabili nei modelli di documentazione.

  7. Tocca Avanti.

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

  9. Imposta Tempo tra le notifiche e Durata della chiusura automatica dell'incidente, poi fai clic su Avanti.

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

  11. Fai clic su Salva.

Configura le notifiche utilizzando l'API Monitoring

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

  4. Ottieni channel_id utilizzando il seguente comando: 

    gcloud beta monitoring channels list

  5. Crea un file policy.json con i seguenti contenuti per il criterio di avviso basato su log:

    1. Per configurare un avviso per l'esecuzione non riuscita di un job 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 l'esecuzione non riuscita di un job 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"

    Se l'esito è positivo, il comando restituisce il nome della risorsa del nuovo criterio. Ad esempio:

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

Passaggi successivi