Agent Trajectory Monitor

string · required

The agent whose spans the monitor reads. Agent monitors name an agent instead of a table; the warehouse source is derived from it. The value takes one of two forms, told apart by its shape:

• Warehouse platform agents (e.g. Snowflake Cortex, Databricks) — a <database>:<schema>.<name> reference, where <name> is the agent's display name when it has one (otherwise its underlying identifier). No trace_table.
• OpenTelemetry agents — the agent's bare service_name. By default the OpenTelemetry trace store is resolved automatically; set trace_table only when the spans live in a specific warehouse table.

agent: my-otel-agent

string · optional

<database>:<schema>.<table> naming the warehouse trace table that holds an OpenTelemetry agent's spans. Required when the spans live in your warehouse, or when the warehouse holds more than one OpenTelemetry trace table. Omit it for platform agents and for agents resolved from the default OpenTelemetry trace store.

trace_table: "ingest:opentelemetry.traces"

object · required

Defines what to alert on. A set of span conditions combined by a boolean operator (AND / OR). Each condition is one of:

• SPAN_OCCURRENCE — a span (identified by span_field) occurs more/less/exactly a count of times. Fields: span_field, predicate, comparison_operator (MORE_THAN · LESS_THAN · EXACTLY), count.
• SPAN_RELATION — a span relates to one or more other spans (related_span_fields).

span_field targets a span by workflow, task, and/or span_name (each a literal), following the workflow → task → span_name hierarchy.

agent_span_alert_condition:
  operator: OR
  conditions:
    - type: SPAN_OCCURRENCE
      span_field:
        workflow:
          literal: retrieval
      predicate:
        name: occurs
      comparison_operator: MORE_THAN
      count: 1

object · required

The lookback window the condition is evaluated over. time_field must be the ingest_ts field; lookback_in_hrs must be at least 1.

time_filter:
  time_field:
    field: ingest_ts
  lookback_in_hrs: 10

object · optional

A predicate tree (FilterGroup) that further restricts which spans are considered, beyond the agent and the alert condition.

array of objects · optional

For trajectory monitors only the agent dimension is meaningful here; span-level refinements (workflow/task/span_name) are rejected — express those in agent_span_alert_condition instead. The agent is already set by agent, so this is rarely needed.

object · required

type (fixed or manual), interval_minutes, start_time, timezone. Dynamic schedules are not supported for trajectory monitors.

schedule:
  type: fixed
  interval_minutes: 60
  start_time: "2025-01-01T00:00:00+00:00"

The shared rule-monitor envelope:

• name string · optional — unique identifier (auto-generated if omitted); renaming creates a new monitor.
• description string · optional — max 512 characters.
• warehouse string · optional — UUID or name; overrides the montecarlo.yml default.
• connection_name string · optional — query engine to use within the warehouse.
• timeout integer · optional — query timeout in seconds.
• notes string · optional — shown in the UI, not in notifications.
• audiences / failure_audiences array of strings · optional — notification channels.
• priority enum · optional — P1–P5.
• event_rollup_count integer · optional — minimum 2; roll up repeated breaches into one incident.
• tags array of objects · optional — name (required) + value (optional).
• data_quality_dimension enum · optional — ACCURACY · COMPLETENESS · CONSISTENCY · TIMELINESS · UNIQUENESS · VALIDITY.
• domains array of strings · optional (required on accounts created after January 2025).