monitors
Usage: deepline monitors [options] [command]
Discover, deploy, and manage Deepline monitors.
Options:
-h, --help display help for command
Commands:
audit [options] Re-read what the provider actually holds for
your monitors.
repair [options] Converge the monitors whose desired and
observed states disagree.
health [options] Delivery and convergence health for your
monitors.
batch Submit or inspect durable bulk monitor
operations.
batches [options] Manage stable named Batches whose omitted
members are stopped.
status [options] Check whether you have access to Deepline
monitors.
list [options] List the monitors you have deployed.
get [options] <key> Show a single deployed monitor by its public
key.
test [options] <key> <payload> Validate an explicit payload against a
monitor’s webhook contract.
validate [options] <key> Validate a deployed monitor’s provider
configuration.
check [options] [definition] Validate a monitor definition without
deploying it.
preview [options] [definition] Sample a few recent matches for a monitor
definition before deploying it. Costs credits.
deploy [options] [definition] Deploy a monitor from a definition.
sync [options] [definition] Publish one complete desired monitor
definition and return a Monitor Job.
update [options] <key> [patch] Update a deployed monitor by its public key.
delete [options] <key> Delete a deployed monitor by its public key.
reactivate [options] <key> Reactivate a previously disabled deployed
monitor.
start [options] <key> Apply the retained definition for a stopped
monitor.
stop [options] <key> Stop a monitor upstream while retaining its
definition for `start`.
jobs [options] Read, wait for, inspect, or cancel Monitor
Jobs.
fleets [options] Manage table-backed Fleets.
help [command] display help for command
monitors audit
Usage: deepline monitors audit [options]
Re-read what the provider actually holds for your monitors.
Options:
--fleet <fleet-id> Audit one fleet instead of every monitor
--watch Keep polling health until the scope settles
--timeout <duration> How long --watch waits, e.g. 90s, 5m, 1h (default 10m)
--json Emit JSON output
-h, --help display help for command
monitors repair
Usage: deepline monitors repair [options]
Converge the monitors whose desired and observed states disagree.
Options:
--fleet <fleet-id> Repair one fleet instead of every monitor
--dry-run Record the bounded repair plan without provider
changes
--yes Confirm the asynchronous provider repair
--idempotency-key <key> Stable retry key (generated when omitted)
--json Emit JSON output
-h, --help display help for command
monitors health
Usage: deepline monitors health [options]
Delivery and convergence health for your monitors.
Options:
--fleet <fleet-id> Report on one fleet instead of every monitor
--json Emit JSON output
-h, --help display help for command
monitors batch
Usage: deepline monitors batch [options] [command]
Submit or inspect durable bulk monitor operations.
Options:
-h, --help display help for command
Commands:
deploy [options] Create a Monitor Job from canonical Batch JSON;
legacy NDJSON remains available with --yes or
--dry-run.
lint [options] Validate and normalize Batch JSON without
network or provider work.
audit [options] Durably audit a selection; defaults to --target
all.
repair [options] Durably re-audit and converge a selection
through the existing lifecycle fences.
deactivate [options] Durably deactivate a selection through provider
batch deletes.
reactivate [options] Durably reactivate a selection after a
suspension.
get [options] <operation-id> Read batch progress and one bounded evidence
page.
help [command] display help for command
monitors batch deploy
Usage: deepline monitors batch deploy [options]
Create a Monitor Job from canonical Batch JSON; legacy NDJSON remains available
with --yes or --dry-run.
Options:
--file <path> Batch JSON
({"version":1,"kind":"batch","monitors":[...]}), or
legacy NDJSON with --yes/--dry-run
--dry-run Preview a retained legacy NDJSON batch operation
--yes Confirm a retained legacy NDJSON batch operation
--idempotency-key <key> Stable retry key (generated when omitted)
--json Emit JSON output
-h, --help display help for command
monitors batch lint
Usage: deepline monitors batch lint [options]
Validate and normalize Batch JSON without network or provider work.
Options:
--file <path> Batch JSON file, or - for stdin
--json Emit JSON output
-h, --help display help for command
monitors batch audit
Usage: deepline monitors batch audit [options]
Durably audit a selection; defaults to --target all.
Options:
--target <target> One of: all, all-active, billing-suspended,
needs-repair
--fleet <fleet-id> Select one Fleet
--keys <keys> Up to 100 comma-separated monitor keys
--dry-run Record the same bounded plan without provider changes
--idempotency-key <key> Stable retry key (generated when omitted)
--json Emit JSON output
-h, --help display help for command
monitors batch repair
Usage: deepline monitors batch repair [options]
Durably re-audit and converge a selection through the existing lifecycle fences.
Options:
--target <target> One of: all, all-active, billing-suspended,
needs-repair
--fleet <fleet-id> Select one Fleet
--keys <keys> Up to 100 comma-separated monitor keys
--dry-run Record the same bounded plan without provider changes
--idempotency-key <key> Stable retry key (generated when omitted)
--yes Confirm the asynchronous provider repair
--json Emit JSON output
-h, --help display help for command
monitors batch deactivate
Usage: deepline monitors batch deactivate [options]
Durably deactivate a selection through provider batch deletes.
Options:
--target <target> One of: all, all-active, billing-suspended,
needs-repair
--fleet <fleet-id> Select one Fleet
--keys <keys> Up to 100 comma-separated monitor keys
--dry-run Record the same bounded plan without provider changes
--idempotency-key <key> Stable retry key (generated when omitted)
--reason <reason> Declared policy reason; required with --target and
omitted for a customer-requested --keys teardown
--yes Confirm the asynchronous provider deactivation
--json Emit JSON output
-h, --help display help for command
monitors batch reactivate
Usage: deepline monitors batch reactivate [options]
Durably reactivate a selection after a suspension.
Options:
--target <target> One of: all, all-active, billing-suspended,
needs-repair
--fleet <fleet-id> Select one Fleet
--keys <keys> Up to 100 comma-separated monitor keys
--dry-run Record the same bounded plan without provider changes
--idempotency-key <key> Stable retry key (generated when omitted)
--yes Confirm provider reactivation and possible billing
--json Emit JSON output
-h, --help display help for command
monitors batch get
Usage: deepline monitors batch get [options] <operation-id>
Read batch progress and one bounded evidence page.
Options:
--cursor <cursor> Read the next retained evidence page
--json Emit JSON output
-h, --help display help for command
monitors batches
Usage: deepline monitors batches [options] [command]
Manage stable named Batches whose omitted members are stopped.
Options:
--json Emit JSON output
-h, --help display help for command
Commands:
sync [options] <batch-id> Publish the complete desired member set and return
one Monitor Job.
start [options] <batch-id> Reapply the retained member set through one
Monitor Job.
stop [options] <batch-id> Publish an empty desired set while retaining
members for start.
get [options] <batch-id> Read named Batch intent and its latest Monitor
Job.
help [command] display help for command
monitors batches sync
Usage: deepline monitors batches sync [options] <batch-id>
Publish the complete desired member set and return one Monitor Job.
Options:
--file <path> Canonical Batch JSON file, or - for stdin
--dry-run Validate and show the desired count without
publishing
--expected-generation <n> Reject a stale concurrent update
--idempotency-key <key> Stable retry key
--json Emit JSON output
-h, --help display help for command
monitors batches start
Usage: deepline monitors batches start [options] <batch-id>
Reapply the retained member set through one Monitor Job.
Options:
--dry-run Show the retained-intent operation without publishing
--idempotency-key <key> Stable retry key
--json Emit JSON output
-h, --help display help for command
monitors batches stop
Usage: deepline monitors batches stop [options] <batch-id>
Publish an empty desired set while retaining members for start.
Options:
--dry-run Show the retained-intent operation without publishing
--idempotency-key <key> Stable retry key
--json Emit JSON output
-h, --help display help for command
monitors batches get
Usage: deepline monitors batches get [options] <batch-id>
Read named Batch intent and its latest Monitor Job.
Options:
--json Emit JSON output
-h, --help display help for command
monitors status
Usage: deepline monitors status [options]
Check whether you have access to Deepline monitors.
Options:
--json Emit JSON output
-h, --help display help for command
monitors list
Usage: deepline monitors list [options]
List the monitors you have deployed.
Options:
--state <state> Filter by customer state: active (default), provisioning,
billing_suspended, disabled, or all
--status <status> Deprecated compatibility filter; use --state (active,
provisioning, billing_suspended, disabled, or all)
--limit <n> Limit the number of deployed monitors returned
--cursor <cursor> Page past a truncated result using the next_cursor from a
prior list response
--compact Deprecated no-op; complete records are always returned
--include-consumers Include current SQL-listener consumer health (requires
--limit 20 or fewer)
--json Emit JSON output
-h, --help display help for command
monitors get
Usage: deepline monitors get [options] <key>
Show a single deployed monitor by its public key.
Options:
--json Emit JSON output
-h, --help display help for command
monitors test
Usage: deepline monitors test [options] <key> <payload>
Validate an explicit payload against a monitor’s webhook contract.
Options:
--json Emit JSON output
-h, --help display help for command
monitors validate
Usage: deepline monitors validate [options] <key>
Validate a deployed monitor’s provider configuration.
Options:
--json Emit JSON output
-h, --help display help for command
monitors check
Usage: deepline monitors check [options] [definition]
Validate a monitor definition without deploying it.
Options:
-f, --file <path> Read the definition JSON from a file, or - for stdin
--json Emit JSON output
-h, --help display help for command
monitors preview
Usage: deepline monitors preview [options] [definition]
Sample a few recent matches for a monitor definition before deploying it. Costs
credits.
Options:
-f, --file <path> Read the definition JSON from a file, or - for stdin
--limit <n> Matches to sample, 1-3 (default 3)
--idempotency-key <key> Recover an earlier preview's result without paying
again. Required with --json
--json Emit JSON output
-h, --help display help for command
monitors deploy
Usage: deepline monitors deploy [options] [definition]
Deploy a monitor from a definition.
Options:
-f, --file <path> Read the definition JSON from a file, or - for stdin
--dry-run Validate and show the deploy plan (cost, reuse candidates)
without deploying
--json Emit JSON output
-h, --help display help for command
monitors sync
Usage: deepline monitors sync [options] [definition]
Publish one complete desired monitor definition and return a Monitor Job.
Options:
-f, --file <path> Read definition JSON from a file, or - for stdin
--dry-run Validate and show the deploy plan without publishing
--idempotency-key <key> Stable retry key
--json Emit JSON output
-h, --help display help for command
monitors update
Usage: deepline monitors update [options] <key> [patch]
Update a deployed monitor by its public key.
Options:
-f, --file <path> Read the patch JSON from a file, or - for stdin
--json Emit JSON output
-h, --help display help for command
monitors delete
Usage: deepline monitors delete [options] <key>
Delete a deployed monitor by its public key.
Options:
--dry-run Show the delete plan without deleting anything
--yes Skip the confirmation prompt (required non-interactively)
--json Emit JSON output
-h, --help display help for command
monitors reactivate
Usage: deepline monitors reactivate [options] <key>
Reactivate a previously disabled deployed monitor.
Options:
--dry-run Show the reactivation cost without reactivating
--json Emit JSON output
-h, --help display help for command
monitors start
Usage: deepline monitors start [options] <key>
Apply the retained definition for a stopped monitor.
Options:
--dry-run Show the start plan without changing anything
--idempotency-key <key> Stable retry key
--json Emit JSON output
-h, --help display help for command
monitors stop
Usage: deepline monitors stop [options] <key>
Stop a monitor upstream while retaining its definition for `start`.
Options:
--dry-run Show the stop plan without changing anything
--idempotency-key <key> Stable retry key
--json Emit JSON output
-h, --help display help for command
monitors jobs
Usage: deepline monitors jobs [options] [command]
Read, wait for, inspect, or cancel Monitor Jobs.
Options:
--json Emit JSON output
-h, --help display help for command
Commands:
get [options] <job-id> Read the durable Monitor Job state.
wait [options] <job-id> Wait for real provider reconciliation, not request
acceptance.
logs [options] <job-id> Read bounded operator logs for one Monitor Job.
cancel [options] <job-id> Stop unscheduled work and reconcile the partial
result.
help [command] display help for command
monitors jobs get
Usage: deepline monitors jobs get [options] <job-id>
Read the durable Monitor Job state.
Options:
--json Emit JSON output
-h, --help display help for command
monitors jobs wait
Usage: deepline monitors jobs wait [options] <job-id>
Wait for real provider reconciliation, not request acceptance.
Options:
--timeout <duration> How long to wait (default 10m)
--json Emit JSON output
-h, --help display help for command
monitors jobs logs
Usage: deepline monitors jobs logs [options] <job-id>
Read bounded operator logs for one Monitor Job.
Options:
--limit <n> Maximum log entries (1..200)
--json Emit JSON output
-h, --help display help for command
monitors jobs cancel
Usage: deepline monitors jobs cancel [options] <job-id>
Stop unscheduled work and reconcile the partial result.
Options:
--json Emit JSON output
-h, --help display help for command
monitors fleets
Usage: deepline monitors fleets [options] [command]
Manage table-backed Fleets.
Options:
--json Emit JSON output
-h, --help display help for command
Commands:
deploy [options] [fleet-id] Apply a table-backed Fleet definition; sync remains an exact alias.
lint [options] Validate and normalize Fleet JSON without network or provider work.
init [options] <fleet-id> Write an opinionated Fleet definition JSON file.
sync [options] [fleet-id] Apply a Fleet definition, or re-plan an existing fleet from its stored one.
get [options] [fleet-id] Read one fleet, or list every fleet when the id is omitted.
deactivate|stop [options] <fleet-id> Deactivate a fleet and the monitors it owns.
reactivate|start [options] <fleet-id> Explicitly recreate a fleet after a credit-triggered suspension.
monitors fleets deploy
Usage: deepline monitors fleets deploy [options] [fleet-id]
Apply a table-backed Fleet definition; sync remains an exact alias.
Options:
-f, --file <path> Fleet JSON file, or - for stdin
--dry-run Show the table-backed convergence plan
--wait Wait for the current Fleet generation to
converge
--timeout <duration> How long --wait may poll (default 10m)
--expected-generation <generation> Optimistic generation fence
--idempotency-key <key> Stable retry key
--json Emit JSON output
-h, --help display help for command
monitors fleets lint
Usage: deepline monitors fleets lint [options]
Validate and normalize Fleet JSON without network or provider work.
Options:
--file <path> Fleet JSON file, or - for stdin
--json Emit JSON output
-h, --help display help for command
monitors fleets init
Usage: deepline monitors fleets init [options] <fleet-id>
Write an opinionated Fleet definition JSON file.
Options:
--source <schema.table> Customer DB source table
--key <column> Unique source-row key column
--key-type <type> text, uuid, int4, or int8 (default text)
--tool <tool> Monitor tool to create per source row
--payload <json> Monitor payload JSON for --tool; use Handlebars
fields such as {{domain}} for row values
--where <json> Optional source-row equality filter JSON; not
arbitrary SQL
--order-by <column:direction> Rank candidates; repeatable, with the source
key appended for stability (default: [])
--limit <n> Maximum active members; ranking changes do not
churn sticky members (default 1,000)
--out <path> Write the definition JSON to this path
--json Emit JSON output
-h, --help display help for command
monitors fleets sync
Usage: deepline monitors fleets sync [options] [fleet-id]
Apply a Fleet definition, or re-plan an existing fleet from its stored one.
Options:
-f, --file <path> Apply definition JSON from a file, or -
for stdin
--dry-run Show the plan and the credits due without
changing state
--wait Poll until the fleet reaches a terminal
status
--timeout <duration> How long --wait may poll: 500ms, 90s, 10m,
1h (default 10m)
--expected-generation <generation> Refuse the write unless the fleet is at
this generation
--idempotency-key <key> Stable retry key (generated and returned
when omitted)
--json Emit JSON output
-h, --help display help for command
monitors fleets get
Usage: deepline monitors fleets get [options] [fleet-id]
Read one fleet, or list every fleet when the id is omitted.
Options:
--drift Include the members that have not settled, and why
--limit <n> Maximum drift rows to return
--check Exit 0 when converged and 6 otherwise, for scripts and agents
--json Emit JSON output
-h, --help display help for command
monitors fleets deactivate
Usage: deepline monitors fleets deactivate|stop [options] <fleet-id>
Deactivate a fleet and the monitors it owns.
Options:
--dry-run Show the blast radius without deactivating
--wait Poll until the fleet reports deactivated
--timeout <duration> How long --wait may poll: 500ms, 90s, 10m, 1h
(default 10m)
--yes Skip the confirmation prompt (required
non-interactively)
--idempotency-key <key> Stable retry key (generated and returned when
omitted)
--json Emit JSON output
-h, --help display help for command
monitors fleets reactivate
Usage: deepline monitors fleets reactivate|start [options] <fleet-id>
Explicitly recreate a fleet after a credit-triggered suspension.
Options:
--wait Poll until the fleet reports converged
--timeout <duration> How long --wait may poll: 500ms, 90s, 10m, 1h
(default 10m)
--yes Confirm recreating suspended provider monitors
--idempotency-key <key> Stable retry key
--json Emit JSON output
-h, --help display help for command