If you’re using IBM’s Cloud Internet Services Global Load Balancing to load-balance across multiple origin servers or data centers, you can configure one of a Healthcheck monitor to actively check the availability of those servers over HTTP(S). This resource is associated with an IBM Cloud Internet Services instance.

Example Usage

resource "ibm_cis_healthcheck" "test" {
  cis_id = "${}"
  expected_body = "alive"
  expected_codes = "2xx"
  method = "GET"
  timeout = 7
  path = "/health"
  interval = 60
  retries = 5
  description = "example load balancer"

Argument Reference

The following arguments are supported:

  • cis_id - (Required) The ID of the CIS service instance
  • expected_body - (Required) A case-insensitive sub-string to look for in the response body. If this string is not found, the origin will be marked as unhealthy. A null value of “” is allowed to match on any content.
  • expected_codes - (Required) The expected HTTP response code or code range of the health check. Eg 2xx
  • method - (Optional) The HTTP method to use for the health check. Default: “GET”.
  • timeout - (Optional) The timeout (in seconds) before marking the health check as failed. Default: 5.
  • path - (Optional) The endpoint path to health check against. Default: “/”.
  • interval - (Optional) The interval between each health check. Shorter intervals may improve failover time, but will increase load on the origins as we check from multiple locations. Default: 60.
  • retries - (Optional) The number of retries to attempt in case of a timeout before marking the origin as unhealthy. Retries are attempted immediately. Default: 2.
  • type - (Optional) The protocol to use for the healthcheck. Currently supported protocols are ‘HTTP’ and 'HTTPS’. Default: “http”.
  • description - (Optional) Free text description.

Header is not currently supported in this version of the provider.

Attributes Reference

The following attributes are exported:

  • id - Load balancer monitor ID.
  • created_on - The RFC3339 timestamp of when the load balancer monitor was created.
  • modified_on - The RFC3339 timestamp of when the load balancer monitor was last modified.