dcloud monitoring checks create

Create an uptime check

IAM monitoring:CreateCheckChanges state

The check runs within a minute, then every intervalSeconds. A failed run is retried once after 3 s; failureThreshold failed runs in a row make it DOWN, two successful runs make it UP again, and both are mailed to notifyEmails and POSTed to webhookUrl. Unconfirmed runs are repeated after a minute. At most 50 checks per organization, and at most 6 requests a minute to one host across every check on Deutsche Cloud.

Synopsis

dcloud monitoring checks create --name name --url url [flags]

Flags

  • --nameRequired

    string

    Unique in the organization, up to 128 characters

  • --typeOptional

    enum

    http: the status decides; keyword: the body must (not) contain a text too

    One of: http, keyword

  • --urlRequired

    string

    http:// or https:// on a public address; any port except 25, 465 and 587

  • --methodOptional

    enum

    GET by default; keyword checks use GET

    One of: GET, HEAD

  • --expected-status-minOptional

    number

    Lowest status that counts as up (default 200)

    Constraints: integer

  • --expected-status-maxOptional

    number

    Highest status that counts as up (default 399)

    Constraints: integer

  • --keywordOptional

    string

    For keyword checks: the text looked for in the first 1 MiB

    May be null.

  • --keyword-modeOptional

    enum

    contains (default) or not_contains

    One of: contains, not_contains

    May be null.

  • --timeout-msOptional

    number

    1000–30000, default 10000

    Constraints: integer

  • --interval-secondsOptional

    number

    60, 120, 300 (default), 600, 900, 1800 or 3600

    Constraints: integer

  • --follow-redirectsOptional

    boolean (--follow-redirects / --no-follow-redirects)

    Follow up to 5 redirects, each re-checked (default true)

  • --verify-tlsOptional

    boolean (--verify-tls / --no-verify-tls)

    Fail on an invalid certificate (default true)

  • --failure-thresholdOptional

    number

    Failed runs in a row before DOWN, 1–5 (default 2)

    Constraints: integer

  • --confirmationsOptional

    number

    Locations that must fail in one run for it to count as failed, 1–3 (default 2); fewer failing is "regional"

    Constraints: integer

  • --alert-on-regionalOptional

    boolean (--alert-on-regional / --no-alert-on-regional)

    Treat one failing location as failed, as if confirmations were 1 (default false)

  • --notify-emailsOptional

    array of string

    Up to 10 addresses mailed on DOWN and on UP again

  • --webhook-urlOptional

    string

    https URL on a public address, POSTed on DOWN and UP

    May be null.

Example

dcloud monitoring checks create --name example --url example

Generated from the API description, the same one the API checks requests against and the CLI is built from.