AWS EC2 Auto Scaling Connector

Latest Dynatrace
Reference
7-min read

Review the required AWS permissions and condition keys of the AWS EC2 Auto Scaling Connector actions to ensure that you grant Dynatrace only a minimum set of permissions. For more information, see AWS documentation.

Attach instances

Attaches one or more EC2 instances to the specified Auto Scaling group.

For more information, see the official documentation of Attach instances.

Required AWS permission: autoscaling:AttachInstances.

Inputs

Field	Type	Description	Required
Region	string	The region to use.	Required
AutoScalingGroupName	string	The name of the Auto Scaling group.	Required
InstanceIds	string[]	The IDs of the instances.	Optional

Output

Returns fields as described in AttachInstancesCommandOutput.

Describe Auto Scaling groups

Gets information about the Auto Scaling groups in the account and Region.

For more information, see the official documentation of Describe Auto Scaling groups.

Required AWS permission: autoscaling:DescribeAutoScalingGroups.

Inputs

Field	Type	Description	Required
Region	string	The region to use.	Required
AutoScalingGroupNames	string[]	The names of the Auto Scaling groups.	Optional
Filters	Filter[]	One or more filters to limit the results based on specific tags.	Optional
MaxRecords	number	The maximum number of items to return with this call.	Optional
NextToken	string	The token for the next set of items to return.	Optional

Output

Returns fields as described in DescribeAutoScalingGroupsCommandOutput.

Describe Auto Scaling instances

Gets information about the Auto Scaling instances in the account and Region.

For more information, see the official documentation of Describe Auto Scaling instances.

Required AWS permission: autoscaling:DescribeAutoScalingInstances.

Inputs

Field	Type	Description	Required
Region	string	The region to use.	Required
InstanceIds	string[]	The IDs of the instances.	Optional
MaxRecords	number	The maximum number of items to return with this call.	Optional
NextToken	string	The token for the next set of items to return.	Optional

Output

Returns fields as described in DescribeAutoScalingInstancesCommandOutput.

Describe instance refreshes

Gets information about the instance refreshes for the specified Auto Scaling group from the previous six weeks.

For more information, see the official documentation of Describe instance refreshes.

Required AWS permission: autoscaling:DescribeInstanceRefreshes.

Inputs

Field	Type	Description	Required
Region	string	The region to use.	Required
AutoScalingGroupName	string	The name of the Auto Scaling group.	Required
InstanceRefreshIds	string[]	One or more instance refresh IDs.	Optional
MaxRecords	number	The maximum number of items to return with this call.	Optional
NextToken	string	The token for the next set of items to return.	Optional

Output

Returns fields as described in DescribeInstanceRefreshesCommandOutput.

Describe scaling activities

Gets information about the scaling activities in the account and Region.

For more information, see the official documentation of Describe scaling activities.

Required AWS permission: autoscaling:DescribeScalingActivities.

Inputs

Field	Type	Description	Required
Region	string	The region to use.	Required
ActivityIds	string[]	The activity IDs of the desired scaling activities.	Optional
AutoScalingGroupName	string	The name of the Auto Scaling group.	Optional
MaxRecords	number	The maximum number of items to return with this call.	Optional
NextToken	string	The token for the next set of items to return.	Optional

Output

Returns fields as described in DescribeScalingActivitiesCommandOutput.

Detach instances

Removes one or more instances from the specified Auto Scaling group.

For more information, see the official documentation of Detach instances.

Required AWS permission: autoscaling:DetachInstances.

Inputs

Field	Type	Description	Required
Region	string	The region to use.	Required
AutoScalingGroupName	string	The name of the Auto Scaling group.	Required
ShouldDecrementDesiredCapacity	boolean	Indicates whether the Auto Scaling group decrements the desired capacity value by the number of instances detached.	Required
InstanceIds	string[]	The IDs of the instances.	Optional

Output

Returns fields as described in DetachInstancesCommandOutput.

Execute policy

Executes the specified policy.

For more information, see the official documentation of Execute policy.

Required AWS permission: autoscaling:ExecutePolicy.

Inputs

Field	Type	Description	Required
Region	string	The region to use.	Required
PolicyName	string	The name or ARN of the policy.	Required
AutoScalingGroupName	string	The name of the Auto Scaling group.	Optional
BreachThreshold	number	The breach threshold for the alarm.	Optional
HonorCooldown	boolean	Indicates whether Amazon EC2 Auto Scaling waits for the cooldown period to complete before executing the policy.	Optional
MetricValue	number	The metric value to compare to `BreachThreshold`.	Optional

Output

Returns fields as described in ExecutePolicyCommandOutput.

Set desired capacity

Sets the size of the specified Auto Scaling group.

For more information, see the official documentation of Set desired capacity.

Required AWS permission: autoscaling:SetDesiredCapacity.

Inputs

Field	Type	Description	Required
Region	string	The region to use.	Required
AutoScalingGroupName	string	The name of the Auto Scaling group.	Required
DesiredCapacity	number	The desired capacity is the initial capacity of the Auto Scaling group after this operation completes and the capacity it attempts to maintain.	Required
HonorCooldown	boolean	Indicates whether Amazon EC2 Auto Scaling waits for the cooldown period to complete before initiating a scaling activity to set your Auto Scaling group to its new capacity.	Optional

Output

Returns fields as described in SetDesiredCapacityCommandOutput.

Start instance refresh

Starts an instance refresh.

For more information, see the official documentation of Start instance refresh.

Required AWS permission: autoscaling:StartInstanceRefresh.

Inputs

Field	Type	Description	Required
Region	string	The region to use.	Required
AutoScalingGroupName	string	The name of the Auto Scaling group.	Required
DesiredConfiguration	DesiredConfiguration	The desired configuration.	Optional
Preferences	RefreshPreferences	Sets your preferences for the instance refresh so that it performs as expected when you start it.	Optional

Output

Returns fields as described in StartInstanceRefreshCommandOutput.

Update Auto Scaling group

We strongly recommend that all Auto Scaling groups use launch templates to ensure full functionality for Amazon EC2 Auto Scaling and Amazon EC2.

For more information, see the official documentation of Update Auto Scaling group.

Required AWS permission: autoscaling:UpdateAutoScalingGroup.

Optional AWS permissions:

iam:PassRole

Inputs

Field	Type	Description	Required
Region	string	The region to use.	Required
AutoScalingGroupName	string	The name of the Auto Scaling group.	Required
DesiredCapacity	number	The desired capacity is the initial capacity of the Auto Scaling group after this operation completes and the capacity it attempts to maintain.	Optional
MaxSize	number	The maximum size of the Auto Scaling group.	Optional
MinSize	number	The minimum size of the Auto Scaling group.	Optional

Output

Returns fields as described in UpdateAutoScalingGroupCommandOutput.