Skip to main content

Add a custom monitor

This guide walks through adding a custom monitor from the Observability page or from the Catalog. For concepts, see How monitors work and Monitor types.

Start the Flow

  • From Observability: Go to Observability in the left sidebar, then click Add Monitor (top right).
  • From Catalog: Navigate to a table or column in the catalog; under the monitors column in the Overview tab click the + button. As the data asset is pre-selected, you skip step 1 (see below) and go straight to selecting monitor type.

Step 1 — Select Data Asset

  1. Search across your warehouse for a table or column.
  2. Select the table or column you want to monitor.
  3. Click Next.

The asset you choose determines which monitor types are available in step 2.

Step 2 — Select Monitor Type

Choose one monitor type. Options depend on whether you selected a table or a column and on the column data type:

  • Any asset (table or column): Custom SQL — track the result of a SQL query over time.
  • Column-level: Cardinality, Uniqueness, Nullness; for numeric columns also Maximum, Minimum, Mean, Percent negative, Percent zero, Standard deviation, Sum.
  • Table-level only: Column count — track the number of columns in the table.

Click Next.

Step 3 — Configure Monitor

Configure these options (all custom monitor types):

  • Name: A descriptive name for the monitor.
  • Recipient channels: One or more notification channels for alerts.
  • Anomaly detection approach: Automatic (Low/Medium/High sensitivity) or Manual (business rule: single value equal/not equal, or range with min/max).
  • Run frequency: Manual, Interval, or Cron.
  • Time window (optional): Restrict the query to a rolling time range (e.g. last 3 days) via a timestamp/date column to reduce cost for large tables.
  • Notification behavior override: Override the workspace default (e.g. notify on every anomalous run instead of only on issue create/resolve).

For Custom SQL, you also set the threshold evaluation method (row count vs single value) and provide the SQL query; use Test to validate before continuing.

Click Create Monitor. The monitor appears in the monitors table and on its details page.

After Creation

Use the monitor details page Status tab to see results over time and the Changelog tab for change history of the monitor configuration. Edit the monitor via the pencil icon in the sidebar to change name, channels, anomaly settings, frequency, or time window. See Monitor status and lifecycle.