Skip to main content

Goal

Balance detection speed, output quality, and usage cost for your workload.

Shared Tuning Principle

Start from a reliable condition, then adjust only one parameter at a time.
  1. Validate stream with Validate Stream
  2. Validate condition with Check Once
  3. Launch monitor or digest
  4. Review runtime output via Get Job Details
  5. Iterate

Live Monitor Levers

interval_seconds

How often condition checks run.
  • lower values: faster detection, higher usage
  • higher values: slower detection, lower usage

Condition quality

Precise conditions reduce false triggers and wasted reruns. Guide: Writing Reliable Conditions

Live Digest Levers

window_minutes

How much time each summary covers.
  • shorter windows: more frequent summaries
  • longer windows: fewer summaries

capture_interval_seconds

How often frames are sampled.
  • lower intervals: richer detail, higher usage
  • higher intervals: lower usage, less detail

max_windows

Optional cap on number of summary windows per job.

Starting Profiles

Fast incident detection (live-monitor)

{
  "interval_seconds": 10
}

Balanced digest (live-digest)

{
  "window_minutes": 10,
  "capture_interval_seconds": 60
}

Cost-controlled digest (live-digest)

{
  "window_minutes": 30,
  "capture_interval_seconds": 180
}

Common Mistakes

  • Skipping check-once before long runs
  • Changing multiple parameters at once
  • Using vague conditions that inflate noise

Next Steps