CLI Reference

CLI interface - orbtymon

Manage status pages, monitors, and incidents from the terminal.

Usage:

$ orbtymon [GLOBAL FLAGS] [COMMAND] [COMMAND FLAGS] [ARGUMENTS...]

Global flags:

Name	Description	Default value	Environment variables
--json	Output results as JSON	false	none
--no-color	Disable colored output	false	none
--quiet (-q)	Suppress non-error output	false	none
--debug	Enable debug output	false	none

monitors command (aliases: m)

Manage your monitors.

Usage:

$ orbtymon [GLOBAL FLAGS] monitors [ARGUMENTS...]

monitors apply subcommand

Create or update monitors.

orbtymon monitors apply orbtymon monitors apply —config custom.yaml -y orbtymon monitors apply —dry-run

Creates or updates monitors according to the OrbtyMon configuration file. Compares your orbtymon.yaml with the current state and applies changes.

Usage:

$ orbtymon [GLOBAL FLAGS] monitors apply [COMMAND FLAGS] [ARGUMENTS...]

The following flags are supported:

Name	Description	Default value	Environment variables
--config="…" (-c)	The configuration file containing monitor information	orbtymon.yaml	none
--access-token="…" (-t)	OrbtyMon API Access Token		OPENSTATUS_API_TOKEN
--auto-accept (-y)	Automatically accept the prompt	false	none
--dry-run (-n)	Show what would be changed without applying	false	none

monitors create subcommand

Create monitors.

orbtymon monitors create orbtymon monitors create —config custom.yaml -y

Create the monitors defined in the orbtymon.yaml file.

Usage:

$ orbtymon [GLOBAL FLAGS] monitors create [COMMAND FLAGS] [ARGUMENTS...]

The following flags are supported:

Name	Description	Default value	Environment variables
--config="…" (-c)	The configuration file containing monitor information	orbtymon.yaml	none
--access-token="…" (-t)	OrbtyMon API Access Token		OPENSTATUS_API_TOKEN
--auto-accept (-y)	Automatically accept the prompt	false	none

monitors delete subcommand

Delete a monitor.

orbtymon monitors delete MonitorID orbtymon monitors delete 12345 -y

Usage:

$ orbtymon [GLOBAL FLAGS] monitors delete [COMMAND FLAGS] [ARGUMENTS...]

The following flags are supported:

Name	Description	Default value	Environment variables
--access-token="…" (-t)	OrbtyMon API Access Token		OPENSTATUS_API_TOKEN
--auto-accept (-y)	Automatically accept the prompt	false	none

monitors import subcommand

Import all your monitors.

orbtymon monitors import orbtymon monitors import —output monitors.yaml

Import all your monitors from your workspace to a YAML file; it will also create a lock file to manage your monitors with ‘apply’.

Usage:

$ orbtymon [GLOBAL FLAGS] monitors import [COMMAND FLAGS] [ARGUMENTS...]

The following flags are supported:

Name	Description	Default value	Environment variables
--access-token="…" (-t)	OrbtyMon API Access Token		OPENSTATUS_API_TOKEN
--output="…" (-o)	The output file name	orbtymon.yaml	none

monitors info subcommand

Get a monitor information.

orbtymon monitors info MonitorID orbtymon monitors info 12345 orbtymon monitors info 12345 —time-range 7d

Fetch the monitor information including configuration, live status per region, and summary metrics.

Usage:

$ orbtymon [GLOBAL FLAGS] monitors info [COMMAND FLAGS] [ARGUMENTS...]

The following flags are supported:

Name	Description	Default value	Environment variables
--access-token="…" (-t)	OrbtyMon API Access Token		OPENSTATUS_API_TOKEN
--time-range="…"	Time range for summary metrics (1d, 7d, 14d)	1d	none

monitors list subcommand

List all monitors.

orbtymon monitors list orbtymon monitors list —all

List all monitors. The list shows all your monitors attached to your workspace. It displays the ID, name, URL, and kind of each monitor.

Usage:

$ orbtymon [GLOBAL FLAGS] monitors list [COMMAND FLAGS] [ARGUMENTS...]

The following flags are supported:

Name	Description	Default value	Environment variables
--all	List all monitors including inactive ones	false	none
--access-token="…" (-t)	OrbtyMon API Access Token		OPENSTATUS_API_TOKEN

monitors trigger subcommand

Trigger a monitor execution.

orbtymon monitors trigger MonitorID orbtymon monitors trigger 12345

Trigger a monitor execution on demand. This command allows you to launch your tests on demand.

Usage:

$ orbtymon [GLOBAL FLAGS] monitors trigger [COMMAND FLAGS] [ARGUMENTS...]

The following flags are supported:

Name	Description	Default value	Environment variables
--access-token="…" (-t)	OrbtyMon API Access Token		OPENSTATUS_API_TOKEN

status-report command (aliases: sr)

Manage status reports.

Usage:

$ orbtymon [GLOBAL FLAGS] status-report [ARGUMENTS...]

status-report list subcommand

List all status reports.

orbtymon status-report list orbtymon status-report list —status investigating —limit 10

Usage:

$ orbtymon [GLOBAL FLAGS] status-report list [COMMAND FLAGS] [ARGUMENTS...]

The following flags are supported:

Name	Description	Default value	Environment variables
--access-token="…" (-t)	OrbtyMon API Access Token		OPENSTATUS_API_TOKEN
--status="…"	Filter by status (investigating, identified, monitoring, resolved)		none
--limit="…"	Maximum number of reports to return (1-100)	0	none

status-report info subcommand

Get status report details.

orbtymon status-report info ReportID orbtymon status-report info 12345

Usage:

$ orbtymon [GLOBAL FLAGS] status-report info [COMMAND FLAGS] [ARGUMENTS...]

The following flags are supported:

Name	Description	Default value	Environment variables
--access-token="…" (-t)	OrbtyMon API Access Token		OPENSTATUS_API_TOKEN

status-report create subcommand

Create a status report.

orbtymon status-report create —title “API Degradation” —status investigating —message “Investigating increased latency” —page-id 123

Usage:

$ orbtymon [GLOBAL FLAGS] status-report create [COMMAND FLAGS] [ARGUMENTS...]

The following flags are supported:

Name	Description	Default value	Environment variables
--access-token="…" (-t)	OrbtyMon API Access Token		OPENSTATUS_API_TOKEN
--title="…"	Title of the status report		none
--status="…"	Initial status (investigating, identified, monitoring, resolved)		none
--message="…"	Initial message describing the incident		none
--page-id="…"	Status page ID to associate with this report		none
--component-ids="…"	Comma-separated page component IDs		none
--notify	Notify subscribers about this status report	false	none
--date="…"	Date when the event occurred (RFC 3339 format, defaults to now)		none

status-report update subcommand

Update status report metadata.

orbtymon status-report update ReportID [—title “New title”] [—component-ids id1,id2]

Usage:

$ orbtymon [GLOBAL FLAGS] status-report update [COMMAND FLAGS] [ARGUMENTS...]

The following flags are supported:

Name	Description	Default value	Environment variables
--access-token="…" (-t)	OrbtyMon API Access Token		OPENSTATUS_API_TOKEN
--title="…"	New title for the report		none
--component-ids="…"	Comma-separated page component IDs (replaces existing list)		none

status-report delete subcommand

Delete a status report.

orbtymon status-report delete ReportID orbtymon status-report delete 12345 -y

Usage:

$ orbtymon [GLOBAL FLAGS] status-report delete [COMMAND FLAGS] [ARGUMENTS...]

The following flags are supported:

Name	Description	Default value	Environment variables
--access-token="…" (-t)	OrbtyMon API Access Token		OPENSTATUS_API_TOKEN
--auto-accept (-y)	Automatically accept the prompt	false	none

status-report add-update subcommand

Add an update to a status report.

orbtymon status-report add-update ReportID —status resolved —message “Issue has been resolved”

Usage:

$ orbtymon [GLOBAL FLAGS] status-report add-update [COMMAND FLAGS] [ARGUMENTS...]

The following flags are supported:

Name	Description	Default value	Environment variables
--access-token="…" (-t)	OrbtyMon API Access Token		OPENSTATUS_API_TOKEN
--status="…"	New status (investigating, identified, monitoring, resolved)		none
--message="…"	Message describing what changed		none
--date="…"	Date for the update (RFC 3339 format, defaults to now)		none
--notify	Notify subscribers about this update	false	none

status-page command (aliases: sp)

Manage status pages.

Usage:

$ orbtymon [GLOBAL FLAGS] status-page [ARGUMENTS...]

status-page list subcommand

List all status pages.

orbtymon status-page list orbtymon status-page list —limit 10

Usage:

$ orbtymon [GLOBAL FLAGS] status-page list [COMMAND FLAGS] [ARGUMENTS...]

The following flags are supported:

Name	Description	Default value	Environment variables
--access-token="…" (-t)	OrbtyMon API Access Token		OPENSTATUS_API_TOKEN
--limit="…"	Maximum number of pages to return (1-100)	0	none

status-page info subcommand

Get status page details.

orbtymon status-page info PageID orbtymon status-page info 12345

Usage:

$ orbtymon [GLOBAL FLAGS] status-page info [COMMAND FLAGS] [ARGUMENTS...]

The following flags are supported:

Name	Description	Default value	Environment variables
--access-token="…" (-t)	OrbtyMon API Access Token		OPENSTATUS_API_TOKEN

run command (aliases: r)

Run your uptime tests.

orbtymon run orbtymon run —config custom-config.yaml

Run the uptime tests defined in the config.orbtymon.yaml. The config file should be in the following format: tests: ids: - monitor-id-1 - monitor-id-2.

Usage:

$ orbtymon [GLOBAL FLAGS] run [COMMAND FLAGS] [ARGUMENTS...]

The following flags are supported:

Name	Description	Default value	Environment variables
--config="…"	The configuration file	config.orbtymon.yaml	none
--access-token="…" (-t)	OrbtyMon API Access Token		OPENSTATUS_API_TOKEN

whoami command (aliases: w)

Get your workspace information.

orbtymon whoami

Get your current workspace information. Displays the workspace name, slug, and plan.

Usage:

$ orbtymon [GLOBAL FLAGS] whoami [COMMAND FLAGS] [ARGUMENTS...]

The following flags are supported:

Name	Description	Default value	Environment variables
--access-token="…" (-t)	OrbtyMon API Access Token		OPENSTATUS_API_TOKEN

login command

Save your API token.

orbtymon login

Saves your OrbtyMon API token for use in subsequent commands. Get your API token from the OrbtyMon dashboard.

Usage:

$ orbtymon [GLOBAL FLAGS] login [ARGUMENTS...]

logout command

Remove saved API token.

orbtymon logout

Usage:

$ orbtymon [GLOBAL FLAGS] logout [ARGUMENTS...]