> ## Documentation Index > Fetch the complete documentation index at: https://deepline.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # deepline monitors > Discover, deploy, and manage Deepline monitors. ## monitors ```text theme={"languages":{"custom":["/languages/deepline-prompt.json"]}} 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] Show a single deployed monitor by its public key. test [options] Validate an explicit payload against a monitor’s webhook contract. validate [options] 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] [patch] Update a deployed monitor by its public key. delete [options] Delete a deployed monitor by its public key. reactivate [options] Reactivate a previously disabled deployed monitor. start [options] Apply the retained definition for a stopped monitor. stop [options] 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 ```text theme={"languages":{"custom":["/languages/deepline-prompt.json"]}} Usage: deepline monitors audit [options] Re-read what the provider actually holds for your monitors. Options: --fleet Audit one fleet instead of every monitor --watch Keep polling health until the scope settles --timeout How long --watch waits, e.g. 90s, 5m, 1h (default 10m) --json Emit JSON output -h, --help display help for command ``` ## monitors repair ```text theme={"languages":{"custom":["/languages/deepline-prompt.json"]}} Usage: deepline monitors repair [options] Converge the monitors whose desired and observed states disagree. Options: --fleet 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 Stable retry key (generated when omitted) --json Emit JSON output -h, --help display help for command ``` ## monitors health ```text theme={"languages":{"custom":["/languages/deepline-prompt.json"]}} Usage: deepline monitors health [options] Delivery and convergence health for your monitors. Options: --fleet Report on one fleet instead of every monitor --json Emit JSON output -h, --help display help for command ``` ## monitors batch ```text theme={"languages":{"custom":["/languages/deepline-prompt.json"]}} 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] Read batch progress and one bounded evidence page. help [command] display help for command ``` ## monitors batch deploy ```text theme={"languages":{"custom":["/languages/deepline-prompt.json"]}} 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 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 Stable retry key (generated when omitted) --json Emit JSON output -h, --help display help for command ``` ## monitors batch lint ```text theme={"languages":{"custom":["/languages/deepline-prompt.json"]}} Usage: deepline monitors batch lint [options] Validate and normalize Batch JSON without network or provider work. Options: --file Batch JSON file, or - for stdin --json Emit JSON output -h, --help display help for command ``` ## monitors batch audit ```text theme={"languages":{"custom":["/languages/deepline-prompt.json"]}} Usage: deepline monitors batch audit [options] Durably audit a selection; defaults to --target all. Options: --target One of: all, all-active, billing-suspended, needs-repair --fleet Select one Fleet --keys Up to 100 comma-separated monitor keys --dry-run Record the same bounded plan without provider changes --idempotency-key Stable retry key (generated when omitted) --json Emit JSON output -h, --help display help for command ``` ## monitors batch repair ```text theme={"languages":{"custom":["/languages/deepline-prompt.json"]}} Usage: deepline monitors batch repair [options] Durably re-audit and converge a selection through the existing lifecycle fences. Options: --target One of: all, all-active, billing-suspended, needs-repair --fleet Select one Fleet --keys Up to 100 comma-separated monitor keys --dry-run Record the same bounded plan without provider changes --idempotency-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 ```text theme={"languages":{"custom":["/languages/deepline-prompt.json"]}} Usage: deepline monitors batch deactivate [options] Durably deactivate a selection through provider batch deletes. Options: --target One of: all, all-active, billing-suspended, needs-repair --fleet Select one Fleet --keys Up to 100 comma-separated monitor keys --dry-run Record the same bounded plan without provider changes --idempotency-key Stable retry key (generated when omitted) --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 ```text theme={"languages":{"custom":["/languages/deepline-prompt.json"]}} Usage: deepline monitors batch reactivate [options] Durably reactivate a selection after a suspension. Options: --target One of: all, all-active, billing-suspended, needs-repair --fleet Select one Fleet --keys Up to 100 comma-separated monitor keys --dry-run Record the same bounded plan without provider changes --idempotency-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 ```text theme={"languages":{"custom":["/languages/deepline-prompt.json"]}} Usage: deepline monitors batch get [options] Read batch progress and one bounded evidence page. Options: --cursor Read the next retained evidence page --json Emit JSON output -h, --help display help for command ``` ## monitors batches ```text theme={"languages":{"custom":["/languages/deepline-prompt.json"]}} 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] Publish the complete desired member set and return one Monitor Job. start [options] Reapply the retained member set through one Monitor Job. stop [options] Publish an empty desired set while retaining members for start. get [options] Read named Batch intent and its latest Monitor Job. help [command] display help for command ``` ## monitors batches sync ```text theme={"languages":{"custom":["/languages/deepline-prompt.json"]}} Usage: deepline monitors batches sync [options] Publish the complete desired member set and return one Monitor Job. Options: --file Canonical Batch JSON file, or - for stdin --dry-run Validate and show the desired count without publishing --expected-generation Reject a stale concurrent update --idempotency-key Stable retry key --json Emit JSON output -h, --help display help for command ``` ## monitors batches start ```text theme={"languages":{"custom":["/languages/deepline-prompt.json"]}} Usage: deepline monitors batches start [options] Reapply the retained member set through one Monitor Job. Options: --dry-run Show the retained-intent operation without publishing --idempotency-key Stable retry key --json Emit JSON output -h, --help display help for command ``` ## monitors batches stop ```text theme={"languages":{"custom":["/languages/deepline-prompt.json"]}} Usage: deepline monitors batches stop [options] Publish an empty desired set while retaining members for start. Options: --dry-run Show the retained-intent operation without publishing --idempotency-key Stable retry key --json Emit JSON output -h, --help display help for command ``` ## monitors batches get ```text theme={"languages":{"custom":["/languages/deepline-prompt.json"]}} Usage: deepline monitors batches get [options] Read named Batch intent and its latest Monitor Job. Options: --json Emit JSON output -h, --help display help for command ``` ## monitors status ```text theme={"languages":{"custom":["/languages/deepline-prompt.json"]}} 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 ```text theme={"languages":{"custom":["/languages/deepline-prompt.json"]}} Usage: deepline monitors list [options] List the monitors you have deployed. Options: --state Filter by customer state: active (default), provisioning, billing_suspended, disabled, or all --status Deprecated compatibility filter; use --state (active, provisioning, billing_suspended, disabled, or all) --limit Limit the number of deployed monitors returned --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 ```text theme={"languages":{"custom":["/languages/deepline-prompt.json"]}} Usage: deepline monitors get [options] Show a single deployed monitor by its public key. Options: --json Emit JSON output -h, --help display help for command ``` ## monitors test ```text theme={"languages":{"custom":["/languages/deepline-prompt.json"]}} Usage: deepline monitors test [options] Validate an explicit payload against a monitor’s webhook contract. Options: --json Emit JSON output -h, --help display help for command ``` ## monitors validate ```text theme={"languages":{"custom":["/languages/deepline-prompt.json"]}} Usage: deepline monitors validate [options] Validate a deployed monitor’s provider configuration. Options: --json Emit JSON output -h, --help display help for command ``` ## monitors check ```text theme={"languages":{"custom":["/languages/deepline-prompt.json"]}} Usage: deepline monitors check [options] [definition] Validate a monitor definition without deploying it. Options: -f, --file Read the definition JSON from a file, or - for stdin --json Emit JSON output -h, --help display help for command ``` ## monitors preview ```text theme={"languages":{"custom":["/languages/deepline-prompt.json"]}} Usage: deepline monitors preview [options] [definition] Sample a few recent matches for a monitor definition before deploying it. Costs credits. Options: -f, --file Read the definition JSON from a file, or - for stdin --limit Matches to sample, 1-3 (default 3) --idempotency-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 ```text theme={"languages":{"custom":["/languages/deepline-prompt.json"]}} Usage: deepline monitors deploy [options] [definition] Deploy a monitor from a definition. Options: -f, --file 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 ```text theme={"languages":{"custom":["/languages/deepline-prompt.json"]}} Usage: deepline monitors sync [options] [definition] Publish one complete desired monitor definition and return a Monitor Job. Options: -f, --file Read definition JSON from a file, or - for stdin --dry-run Validate and show the deploy plan without publishing --idempotency-key Stable retry key --json Emit JSON output -h, --help display help for command ``` ## monitors update ```text theme={"languages":{"custom":["/languages/deepline-prompt.json"]}} Usage: deepline monitors update [options] [patch] Update a deployed monitor by its public key. Options: -f, --file Read the patch JSON from a file, or - for stdin --json Emit JSON output -h, --help display help for command ``` ## monitors delete ```text theme={"languages":{"custom":["/languages/deepline-prompt.json"]}} Usage: deepline monitors delete [options] 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 ```text theme={"languages":{"custom":["/languages/deepline-prompt.json"]}} Usage: deepline monitors reactivate [options] 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 ```text theme={"languages":{"custom":["/languages/deepline-prompt.json"]}} Usage: deepline monitors start [options] Apply the retained definition for a stopped monitor. Options: --dry-run Show the start plan without changing anything --idempotency-key Stable retry key --json Emit JSON output -h, --help display help for command ``` ## monitors stop ```text theme={"languages":{"custom":["/languages/deepline-prompt.json"]}} Usage: deepline monitors stop [options] Stop a monitor upstream while retaining its definition for `start`. Options: --dry-run Show the stop plan without changing anything --idempotency-key Stable retry key --json Emit JSON output -h, --help display help for command ``` ## monitors jobs ```text theme={"languages":{"custom":["/languages/deepline-prompt.json"]}} 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] Read the durable Monitor Job state. wait [options] Wait for real provider reconciliation, not request acceptance. logs [options] Read bounded operator logs for one Monitor Job. cancel [options] Stop unscheduled work and reconcile the partial result. help [command] display help for command ``` ## monitors jobs get ```text theme={"languages":{"custom":["/languages/deepline-prompt.json"]}} Usage: deepline monitors jobs get [options] Read the durable Monitor Job state. Options: --json Emit JSON output -h, --help display help for command ``` ## monitors jobs wait ```text theme={"languages":{"custom":["/languages/deepline-prompt.json"]}} Usage: deepline monitors jobs wait [options] Wait for real provider reconciliation, not request acceptance. Options: --timeout How long to wait (default 10m) --json Emit JSON output -h, --help display help for command ``` ## monitors jobs logs ```text theme={"languages":{"custom":["/languages/deepline-prompt.json"]}} Usage: deepline monitors jobs logs [options] Read bounded operator logs for one Monitor Job. Options: --limit Maximum log entries (1..200) --json Emit JSON output -h, --help display help for command ``` ## monitors jobs cancel ```text theme={"languages":{"custom":["/languages/deepline-prompt.json"]}} Usage: deepline monitors jobs cancel [options] Stop unscheduled work and reconcile the partial result. Options: --json Emit JSON output -h, --help display help for command ``` ## monitors fleets ```text theme={"languages":{"custom":["/languages/deepline-prompt.json"]}} 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] 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] Deactivate a fleet and the monitors it owns. reactivate|start [options] Explicitly recreate a fleet after a credit-triggered suspension. ``` ## monitors fleets deploy ```text theme={"languages":{"custom":["/languages/deepline-prompt.json"]}} Usage: deepline monitors fleets deploy [options] [fleet-id] Apply a table-backed Fleet definition; sync remains an exact alias. Options: -f, --file Fleet JSON file, or - for stdin --dry-run Show the table-backed convergence plan --wait Wait for the current Fleet generation to converge --timeout How long --wait may poll (default 10m) --expected-generation Optimistic generation fence --idempotency-key Stable retry key --json Emit JSON output -h, --help display help for command ``` ## monitors fleets lint ```text theme={"languages":{"custom":["/languages/deepline-prompt.json"]}} Usage: deepline monitors fleets lint [options] Validate and normalize Fleet JSON without network or provider work. Options: --file Fleet JSON file, or - for stdin --json Emit JSON output -h, --help display help for command ``` ## monitors fleets init ```text theme={"languages":{"custom":["/languages/deepline-prompt.json"]}} Usage: deepline monitors fleets init [options] Write an opinionated Fleet definition JSON file. Options: --source Customer DB source table --key Unique source-row key column --key-type text, uuid, int4, or int8 (default text) --tool Monitor tool to create per source row --payload Monitor payload JSON for --tool; use Handlebars fields such as {{domain}} for row values --where Optional source-row equality filter JSON; not arbitrary SQL --order-by Rank candidates; repeatable, with the source key appended for stability (default: []) --limit Maximum active members; ranking changes do not churn sticky members (default 1,000) --out Write the definition JSON to this path --json Emit JSON output -h, --help display help for command ``` ## monitors fleets sync ```text theme={"languages":{"custom":["/languages/deepline-prompt.json"]}} 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 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 How long --wait may poll: 500ms, 90s, 10m, 1h (default 10m) --expected-generation Refuse the write unless the fleet is at this generation --idempotency-key Stable retry key (generated and returned when omitted) --json Emit JSON output -h, --help display help for command ``` ## monitors fleets get ```text theme={"languages":{"custom":["/languages/deepline-prompt.json"]}} 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 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 ```text theme={"languages":{"custom":["/languages/deepline-prompt.json"]}} Usage: deepline monitors fleets deactivate|stop [options] 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 How long --wait may poll: 500ms, 90s, 10m, 1h (default 10m) --yes Skip the confirmation prompt (required non-interactively) --idempotency-key Stable retry key (generated and returned when omitted) --json Emit JSON output -h, --help display help for command ``` ## monitors fleets reactivate ```text theme={"languages":{"custom":["/languages/deepline-prompt.json"]}} Usage: deepline monitors fleets reactivate|start [options] Explicitly recreate a fleet after a credit-triggered suspension. Options: --wait Poll until the fleet reports converged --timeout How long --wait may poll: 500ms, 90s, 10m, 1h (default 10m) --yes Confirm recreating suspended provider monitors --idempotency-key Stable retry key --json Emit JSON output -h, --help display help for command ``` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.