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.

Per configurare gli avvisi, puoi utilizzare Esplora log nella console Google Cloud o l'API Monitoring.

Terminologia

  • Durata chiusura automatica incidenti: la durata dopo la quale un incidente viene chiuso quando non sono presenti voci di log corrispondenti.
  • Tempo tra le notifiche: intervallo di tempo minimo tra la ricezione delle notifiche 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.

Configurare le notifiche utilizzando Esplora log

  1. Nella console Google Cloud, vai alla pagina Esplora log.

    Vai a Esplora log

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

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

  3. Fai clic su Crea avviso.

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

  5. Nel campo Documentazione, inserisci la descrizione da includere nella 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.

  6. Fai clic su Avanti.

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

  8. Imposta l'Intervallo tra le notifiche e la Durata chiusura automatica incidenti, quindi fai clic su Avanti.

  9. (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.

  10. Fai clic su Salva.

Configurare le notifiche utilizzando l'API Monitoring

  1. (Facoltativo) Abilita l'API Monitoring e autorizza gli utenti ad accedervi. Per ulteriori informazioni, consulta Attivare l'API Monitoring.
  2. (Facoltativo) Imposta i ruoli o le autorizzazioni necessarie 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 o Google Cloud CLI.

  4. Ricevi il channel_id: 

    gcloud beta monitoring channels list

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

    1. Configura un avviso per un'esecuzione di job non riuscita di qualsiasi attività Dataplex in un progetto:

      {
"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. Configura un avviso per un'esecuzione di job non riuscita per un'attività Dataplex specifica in un progetto:

      {
"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:

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

    In caso di 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