doctl monitoring uptime create

Go to Navigation


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, from the eastern and western regions of the Unites States:

doctl monitoring uptime create --target --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

Global Flags

Option Description
--access-token, -t API V2 access token
--api-url, -u Override default API endpoint
--config, -c Specify a custom config file
  • macOS: ${HOME}/Library/Application Support/doctl/config.yaml
  • Linux: ${XDG_CONFIG_HOME}/doctl/config.yaml
  • Windows: %APPDATA%\doctl\config.yaml
--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