Give Feedback

doctl monitoring uptime create

Generated on 9 Apr 2025 from doctl version v1.124.0

Usage

doctl monitoring uptime create <uptime-check-name> [flags]

Creates an uptime check on your account. Uptime checks monitor any endpoint that is accessible over HTTP, HTTPS, ping (ICMP).

You can use this check to set up an alert policy using the `doctl monitoring uptime alert` commands.

The following example creates an uptime check that monitors the URL, example.com from the eastern and western regions of the Unites States:

doctl monitoring uptime create --target https://example.com --type https --regions us_east,us_west --enabled true

Option	Description
`--enabled`	Whether or not the uptime check is enabled. Defaults to true Default: `true`
`--format`	Columns for output in a comma-separated list. Possible values: `ID`, `Name`, `Type`, `Target`, `Regions`, `Enabled`.
`--help`, `-h`	Help for this command
`--no-header`	Return raw data with no headers Default: `false`
`--regions`	A comma-separated list of regions to monitor the target from. Possible values: `us_east`, `us_west`, `eu_west`, `se_asia`. Defaults to `us_east` Default: `[us_east]`
`--target`	A valid URL to monitor (required)
`--type`	The protocol to use to monitor the target URL. Possible values: `ping`, `http`, `https`. Defaults to either `http` or `https`, depending on the URL target provided

Command	Description
doctl monitoring uptime	Display commands to manage uptime checks

Option	Description
`--access-token`, `-t`	API V2 access token
`--api-url`, `-u`	Override default API endpoint
`--config`, `-c`	Specify a custom config file Default:
`--context`	Specify a custom authentication context name
`--http-retry-max`	Set maximum number of retries for requests that fail with a 429 or 500-level error Default: `5`
`--http-retry-wait-max`	Set the minimum number of seconds to wait before retrying a failed request Default: `30`
`--http-retry-wait-min`	Set the maximum number of seconds to wait before retrying a failed request Default: `1`
`--interactive`	Enable interactive behavior. Defaults to true if the terminal supports it (default false) Default: `false`
`--output`, `-o`	Desired output format [text\|json] Default: `text`
`--trace`	Show a log of network activity while performing a command Default: `false`
`--verbose`, `-v`	Enable verbose output Default: `false`