dcloud monitoring checks createCreate an uptime check
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
--nameRequiredstring
Unique in the organization, up to 128 characters
--typeOptionalenum
http: the status decides; keyword: the body must (not) contain a text too
One of:
http,keyword--urlRequiredstring
http:// or https:// on a public address; any port except 25, 465 and 587
--methodOptionalenum
GET by default; keyword checks use GET
One of:
GET,HEAD--expected-status-minOptionalnumber
Lowest status that counts as up (default 200)
Constraints: integer
--expected-status-maxOptionalnumber
Highest status that counts as up (default 399)
Constraints: integer
--keywordOptionalstring
For keyword checks: the text looked for in the first 1 MiB
May be null.
--keyword-modeOptionalenum
contains (default) or not_contains
One of:
contains,not_containsMay be null.
--timeout-msOptionalnumber
1000–30000, default 10000
Constraints: integer
--interval-secondsOptionalnumber
60, 120, 300 (default), 600, 900, 1800 or 3600
Constraints: integer
--follow-redirectsOptionalboolean (--follow-redirects / --no-follow-redirects)
Follow up to 5 redirects, each re-checked (default true)
--verify-tlsOptionalboolean (--verify-tls / --no-verify-tls)
Fail on an invalid certificate (default true)
--failure-thresholdOptionalnumber
Failed runs in a row before DOWN, 1–5 (default 2)
Constraints: integer
--confirmationsOptionalnumber
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-regionalOptionalboolean (--alert-on-regional / --no-alert-on-regional)
Treat one failing location as failed, as if confirmations were 1 (default false)
--notify-emailsOptionalarray of string
Up to 10 addresses mailed on DOWN and on UP again
--webhook-urlOptionalstring
https URL on a public address, POSTed on DOWN and UP
May be null.
Example
dcloud monitoring checks create --name example --url exampleGenerated from the API description, the same one the API checks requests against and the CLI is built from.