createApplicationStatusCheck

Creates an application status check for monitoring the health of applications running on your instances. You can configure the protocol, port, path, and thresholds for the health check. The following rules apply:

  • You can create a maximum of 50 application status checks for each account.

  • You must associate the check with instances or tags using AssociateApplicationStatusCheck before health checks start.

  • You must set the Timeout value to less than the Interval value.

  • You must start the Path with a forward slash (/). Default: /.

  • You can specify Aggregation as included or excluded. If you do not specify a value, it defaults to included, which means the check contributes to the instance-level application status.

  • You can use the following default values: Interval is 60 seconds, Timeout is 6 seconds, FailureThreshold is 2, SuccessThreshold is 2, StatusCodeMatcher is 200, InitializationGracePeriodSeconds is 300 seconds.

  • You can tag the application status check during creation. For more information, see Tag your Amazon EC2 resources.

Samples

// This example creates an application status check that monitors HTTP health on port 80.
val resp = ec2Client.createApplicationStatusCheck {
    protocol = NetworkProtocolEnum.fromValue("http")
    port = 80
    path = "/health"
    aggregation = AggregationStatusEnum.fromValue("included")
}