Package-level declarations

Types

Link copied to clipboard

You can use Amazon CloudWatch Synthetics to continually monitor your services. You can create and manage canaries, which are modular, lightweight scripts that monitor your endpoints and APIs from the outside-in. You can set up your canaries to run 24 hours a day, once per minute. The canaries help you check the availability and latency of your web services and troubleshoot anomalies by investigating load time data, screenshots of the UI, logs, and metrics. The canaries seamlessly integrate with CloudWatch ServiceLens to help you trace the causes of impacted nodes in your applications. For more information, see Using ServiceLens to Monitor the Health of Your Applications in the Amazon CloudWatch User Guide.

Properties

Link copied to clipboard
const val SdkVersion: String
Link copied to clipboard
Link copied to clipboard
const val ServiceId: String

Functions

Link copied to clipboard

Associates a canary with a group. Using groups can help you with managing and automating your canaries, and you can also view aggregated run results and statistics for all canaries in a group.

Link copied to clipboard

Creates a canary. Canaries are scripts that monitor your endpoints and APIs from the outside-in. Canaries help you check the availability and latency of your web services and troubleshoot anomalies by investigating load time data, screenshots of the UI, logs, and metrics. You can set up a canary to run continuously or just once.

Link copied to clipboard

Creates a group which you can use to associate canaries with each other, including cross-Region canaries. Using groups can help you with managing and automating your canaries, and you can also view aggregated run results and statistics for all canaries in a group.

Link copied to clipboard

Permanently deletes the specified canary.

Link copied to clipboard

Deletes a group. The group doesn't need to be empty to be deleted. If there are canaries in the group, they are not deleted when you delete the group.

Link copied to clipboard

This operation returns a list of the canaries in your account, along with full details about each canary.

Link copied to clipboard

Use this operation to see information from the most recent run of each canary that you have created.

Link copied to clipboard

Returns a list of Synthetics canary runtime versions. For more information, see Canary Runtime Versions.

Link copied to clipboard

Removes a canary from a group. You must run this operation in the Region where the canary exists.

Link copied to clipboard
inline suspend fun SyntheticsClient.getCanary(crossinline block: GetCanaryRequest.Builder.() -> Unit): GetCanaryResponse

Retrieves complete information about one canary. You must specify the name of the canary that you want. To get a list of canaries and their names, use DescribeCanaries.

Link copied to clipboard

Retrieves a list of runs for a specified canary.

Link copied to clipboard
inline suspend fun SyntheticsClient.getGroup(crossinline block: GetGroupRequest.Builder.() -> Unit): GetGroupResponse

Returns information about one group. Groups are a global resource, so you can use this operation from any Region.

Link copied to clipboard

Returns a list of the groups that the specified canary is associated with. The canary that you specify must be in the current Region.

Link copied to clipboard

This operation returns a list of the ARNs of the canaries that are associated with the specified group.

Link copied to clipboard
inline suspend fun SyntheticsClient.listGroups(crossinline block: ListGroupsRequest.Builder.() -> Unit): ListGroupsResponse

Returns a list of all groups in the account, displaying their names, unique IDs, and ARNs. The groups from all Regions are returned.

Link copied to clipboard

Displays the tags associated with a canary or group.

Link copied to clipboard

Use this operation to run a canary that has already been created. The frequency of the canary runs is determined by the value of the canary's Schedule. To see a canary's schedule, use GetCanary.

Link copied to clipboard
inline suspend fun SyntheticsClient.stopCanary(crossinline block: StopCanaryRequest.Builder.() -> Unit): StopCanaryResponse

Stops the canary to prevent all future runs. If the canary is currently running,the run that is in progress completes on its own, publishes metrics, and uploads artifacts, but it is not recorded in Synthetics as a completed run.

Link copied to clipboard

Assigns one or more tags (key-value pairs) to the specified canary or group.

Link copied to clipboard

Removes one or more tags from the specified resource.

Link copied to clipboard

Updates the configuration of a canary that has already been created.

Link copied to clipboard

Create a copy of the client with one or more configuration values overridden. This method allows the caller to perform scoped config overrides for one or more client operations.