monitors

x

monitors command

The monitors command is used to manage your monitors. You can import, update, delete, trigger, view and list your monitors using this command.

Usage:

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

—access-token, -t="": OpenStatus API Access Token

monitors apply subcommand

Create or update monitors.

openstatus monitors apply [options]

Creates or updates monitors according to the OpenStatus configuration file.

You can find some examples in the OpenStatus Template repository:

https://github.com/openstatusHQ/cli-template/

Usage:

$ openstatus [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	openstatus.yaml	none
--access-token="…" (-t)	OpenStatus API Access Token		OPENSTATUS_API_TOKEN
--auto-accept (-y)	Automatically accept the prompt	false	none

monitors import subcommand

Import all your monitors.

openstatus monitors import [options]

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:

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

The following flags are supported:

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

monitors info subcommand

Get a monitor information.

openstatus monitors info [MonitorID]

Fetch the monitor information. The monitor information includes details such as name, description, endpoint, method, frequency, locations, active status, public status, timeout, degraded after, and body. The body is truncated to 40 characters.

Usage:

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

The following flags are supported:

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

monitors list subcommand

List all monitors.

openstatus monitors list [options]

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

Usage:

$ openstatus [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)	OpenStatus API Access Token		OPENSTATUS_API_TOKEN

monitors trigger subcommand

Trigger a monitor execution.

openstatus monitors trigger [MonitorId] [options]

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

Usage:

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

The following flags are supported:

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