Riferimento alle tabelle del sistema di allerta

Questa pagina include informazioni sulle tabelle del sistema di allarme, inclusa una panoramica dello schema di ciascuna tabella. Usa queste tabelle per interrogare direttamente in SQL gli avvisi del tuo spazio di lavoro e la loro cronologia di valutazione, così puoi controllare le definizioni degli avvisi, analizzare le tendenze di valutazione e monitorare i carichi di lavoro degli avvisi su larga scala.

Lo system.alert schema contiene due tabelle:

• system.alert.alerts: La configurazione di ogni avviso, inclusa la sua definizione, il calendario, le soglie di valutazione, gli abbonati e i timestamp del ciclo di vita.
• system.alert.alert_evaluation_history: Una riga per ogni valutazione dell'allerta, che cattura lo stato valutato, i valori dei risultati, lo stato della consegna delle notifiche e i dettagli dell'errore.

Requirements

Di default, solo gli utenti con ruoli sia di account admin che di metastore hanno accesso alle tabelle del sistema di avviso. Per condividere i dati di una tabella con un utente o un gruppo, Databricks raccomanda di creare una visuale dinamica per ogni utente o gruppo. Vedere Creare una visualizzazione dinamica.

Schema della tabella di configurazione degli allarmi

La system.alert.alerts tabella è una tabella delle dimensioni che cambia lentamente. Ogni riga cattura la configurazione di un avviso in un determinato momento, quindi un singolo avviso ha più righe quando la sua configurazione cambia.

Percorso della tabella: Questa tabella di sistema si trova in system.alert.alerts.

La system.alert.alerts tabella usa lo schema seguente:

Schema della tabella della storia della valutazione degli allerti

La system.alert.alert_evaluation_history tabella registra una riga per ogni valutazione dell'allerta, catturando lo stato e le statistiche correlate.

Percorso della tabella: Questa tabella di sistema si trova in system.alert.alert_evaluation_history.

La system.alert.alert_evaluation_history tabella usa lo schema seguente:

Interrogazioni di esempio

Le seguenti query di esempio mostrano modi comuni per analizzare la configurazione degli allarmi e la cronologia delle valutazioni. Ogni query utilizza marker di parametri nominati per gli ID di avviso e workspace, quindi ti vengono chiesti i valori quando esegui la query.

Trova la valutazione più recente per un avviso

Questa query restituisce l'ultima configurazione di un avviso specifico insieme alla sua valutazione più recente.

SELECT
  c.alert_id,
  c.display_name,
  c.compute,
  c.schedule.quartz_cron_schedule AS schedule,
  c.evaluation_comparison_operator AS operator,
  c.evaluation_threshold.value.double_value AS threshold,
  c.change_time AS config_last_updated,
  e.evaluated_state,
  e.start_time AS evaluation_time,
  e.end_time,
  TIMESTAMPDIFF(SECOND, e.start_time, e.end_time) AS eval_duration_seconds
FROM (
  SELECT *
  FROM system.alert.alerts
  WHERE alert_id = :your_alert_id
    AND delete_time IS NULL
  ORDER BY change_time DESC
  LIMIT 1
) c
LEFT JOIN (
  SELECT *
  FROM system.alert.alert_evaluation_history
  WHERE alert_id = :your_alert_id
  ORDER BY start_time DESC
  LIMIT 1
) e ON TRUE;

Trova quali avvisi si sono attivati maggiormente negli ultimi sette giorni

Questa query conta quante volte ogni avviso è stato attivato in uno spazio di lavoro negli ultimi sette giorni.

SELECT
  alert_id,
  COUNT(*) AS trigger_count_7d
FROM system.alert.alert_evaluation_history
WHERE workspace_id = :your_workspace_id
  AND start_time >= CURRENT_DATE() - INTERVAL 7 DAY
  AND evaluated_state = 'TRIGGERED'
GROUP BY alert_id
ORDER BY trigger_count_7d DESC;

Monitora come lo stato di un allarme è cambiato nel tempo

Questa query riassume il conteggio giornaliero di ciascuno stato valutato per un allarme specifico negli ultimi 30 giorni. Usalo per costruire una dashboard che monitori l'affidabilità degli allarmi.

SELECT
  DATE_TRUNC('day', start_time) AS eval_day,
  COUNT_IF(evaluated_state = 'OK') AS ok_count,
  COUNT_IF(evaluated_state = 'TRIGGERED') AS triggered_count,
  COUNT_IF(evaluated_state = 'ERROR') AS error_count
FROM system.alert.alert_evaluation_history
WHERE alert_id = :your_alert_id
  AND start_time >= CURRENT_DATE() - INTERVAL 30 DAY
GROUP BY 1
ORDER BY eval_day ASC;

Elenca gli avvisi attivi in uno spazio di lavoro

Questa query restituisce l'ultima configurazione di ogni avviso che non viene eliminata né messa in pausa in uno spazio di lavoro.

WITH latest AS (
  SELECT
    *,
    ROW_NUMBER() OVER (PARTITION BY alert_id ORDER BY change_time DESC) AS rn
  FROM system.alert.alerts
  WHERE workspace_id = :your_workspace_id
    AND delete_time IS NULL
)
SELECT
  alert_id,
  display_name,
  compute,
  schedule.quartz_cron_schedule AS cron_schedule,
  schedule.pause_status
FROM latest
WHERE rn = 1
  AND schedule.pause_status != 'PAUSED';