pingdom::http-check

Creates a HTTP Check.

Example

pingdom::http-check http-check-example
    name: "http-check-example"
    users: [$(pingdom::user sample-user)]

    # HTTP specific attributes
    url: "/"
    port: 443
    encryption: true
    should-contain: "hello"

    # Common check attributes
    resolution: 5
    hostname: "s7.mydomain.com"
    send-notification-when-down: 7
    notify-again-every: 4
    notify-when-back-up: true
    tags: ["abc", "xyz"]

    request-headers: {
        X-Request-Type: "api",
        X-Api-Key: "1234"
    }
end

Attributes

Attribute	Description
name	The name of the check. (Required)
hostname	The target host of the check. (Required)
integration-ids list	The list of integration identifiers. (Optional)
ipv6	Decides if ipv6 is used, rather than ipv4. (Optional)
notify-again-every	Notify every x cycles. (Optional)
notify-when-back-up	Decides if a notification is sent when the host is back up. (Optional)
paused	Decides if check is paused. (Optional)
resolution	Determines how often the host’s status is checked. (Optional)
response-time-threshold	Triggers an alert if the response time is over this many ms. (Optional)
send-notification-when-down	Determines if a notification is sent if the host goes down. (Optional)
tags set	The tags for the check. (Optional)
team-ids list	Ids of the teams that will be notified is the host is down. (Optional)
type	The type of the check. (Required)
users list	Users that will be notified is the host is down. (Optional)
probe-region	Filter probe location. Valid values are North America (NA) or Europe (EU) or Asia Pacific (APAC) or Latin America (LATAM).
url	URL to check on host.
encryption	Whether to connect to host using SSL.
port	The target port to connect to.
auth	Username/Password used for auth (HTTP Basic Auth). In formation “username:password”.
should-contain	String that should be in the response to consider check successful.
should-not-contain	String that should not be in the response to consider check successful.
post-data	POST data to send in check request.
request-headers map	Request headers to send along with check request.

Outputs

Attribute	Description
id	The returned ID of the check.