AWS Auto Scaling monitoring integration

Important

Enable the AWS CloudWatch Metric Streams integration to monitor all CloudWatch metrics from your AWS services, including custom namespaces. Individual integrations are no longer our recommended option.

The AWS Auto Scaling service allows launching or terminating Amazon EC2 instances automatically. It helps dynamically adapt Amazon EC2 capacity based on user-defined policies, schedules, and health checks.

New Relic infrastructure integrations include an AWS Auto Scaling integration that reports data about groups from your Auto Scaling service to New Relic products. This document explains how to activate this integration and describes the data that can be reported.

Activate integration

To enable this integration:

Follow standard procedures to connect AWS services to New Relic.
Enable Auto Scaling group metrics so that AWS Auto Scaling will send sampled data to CloudWatch every minute.

To enable group metrics using the console:

Open the Amazon EC2 console at console.aws.amazon.com/ec2/.
From the navigation pane, select Auto Scaling Groups > (select your group).
From the Monitoring tab, select Auto Scaling Metrics > Enable Group Metrics Collection or Display > Auto Scaling.

Configuration and polling

Default polling information for the AWS Auto Scaling integration:

New Relic polling interval: 5 minutes
Amazon CloudWatch data interval: 1 minute by default

To change the polling frequency and filter data, use configuration options.

Find and use data

To view integration data, go to one.newrelic.com > Infrastructure > AWS, then select one of the AWS Auto Scaling integration links.

You can query and explore your data using these event types:

AutoScalingInstanceSample
AutoScalingGroupSample
AutoScalingLaunchConfigurationSample
AutoScalingPolicySample
AutoScalingRegionLimitSample

Metric data

This infrastructure integration collects the following AWS Auto Scaling data:

Metric	Description
`groupDesiredCapacity`	The number of instances that the Auto Scaling group attempts to maintain.
`groupInServiceInstances`	The number of instances that are running as part of the Auto Scaling group.
`groupMaxSize`	The maximum size of the Auto Scaling group.
`groupMinSize`	The minimum size of the Auto Scaling group.
`groupPendingInstances`	The number of instances that are pending and not yet in service.
`groupStandbyInstances`	The number of instances that are in a "standby" state.
`groupTerminatingInstances`	The number of instances that are in the process of terminating.
`groupTotalInstances`	The total number of instances in the Auto Scaling group.

Inventory data

EOL NOTICE

After March 2022, we're discontinuing support for several capabilities, including inventory data for cloud integrations. For more details, including how you can easily prepare for this transition, see our Explorers Hub post.

Inventory data provides information about the service's state and configuration. Auto Scaling configuration options are reported as inventory data.

/aws/autoscaling/group inventory

Name	Description
`autoScalingGroupArn`	The Amazon Resource Name (ARN) of the group.
`autoScalingGroupName`	The name of the group.
`awsRegion`	The region of the Auto Scaling group.
`desiredCapacity`	The preferred size of the group.
`enabledMetrics`	A list of structures representing the metrics enabled for the group.
`healthCheckPeriod`	The amount of time, in seconds, that Auto Scaling waits before checking the health status of an EC2 instance that has come into service.
`healthCheckType`	The service to use for the health checks.
`instances`	A list of structures representing the EC2 instances associated with the group.
`launchConfiguration`	The launch configuration associated with the instance.
`loadBalancers`	One or more load balancers associated with the group.
`maxSize`	The maximum size of the group.
`minSize`	The minimum size of the group.
`status`	The current state of the group when delete-auto-scaling-group is in progress.
`tags`	A list of structures representing the tags for the group.

/aws/autoscaling/instance inventory

Name	Description
`autoScalingGroupName`	The group names.
`awsRegion`	The region of the Auto Scaling group.
`id`	The ID of the instance.
`launchConfigurationName`	The launch configuration used to launch the instance.
`lifeCycle`	The lifecycle state for the instance.
`status`	The last reported health status of this instance.

/aws/autoscaling/launch-configuration inventory

Name	Description
`awsRegion`	The AWS region where the launch configuration is defined.
`createdAt`	The creation date and time for the launch configuration.
`kernelId`	The ID of the kernel associated with the AMI.
`keyName`	The name of the key pair.
`iamInstanceProfile`	The name or Amazon Resource Name (ARN) of the instance profile associated with the IAM role for the instance.
`imageId`	The ID of the Amazon Machine Image (AMI).
`instanceMonitoring`	A boolean. It will be true when the instances in this group are launched with detailed monitoring.
`instanceType`	The instance type for the instances.
`launchConfigurationArn`	The Amazon Resource Name (ARN) of the launch configuration.
`launchConfigurationName`	The name of the launch configuration.
`name`	The name of the launch configuration.
`placementTenacy`	The tenancy of the instance.
`securityGroups`	The security groups to associate with the instances.
`spotPrice`	The price to bid when launching Spot Instances.

/aws/autoscaling/policy inventory

Name	Description
`adjustmentType`	The adjustment type, which specifies how ScalingAdjustment is interpreted.
`alarms`	A list of structures representing the CloudWatch alarms related to the policy.
`autoScalingGroupName`	The name of the Auto Scaling group associated with this scaling policy.
`awsRegion`	The AWS region where the policy is defined.
`coolDown`	The amount of time, in seconds, after a scaling activity completes before any further dynamic scaling activities can start.
`estimatedWarmUp`	The estimated time, in seconds, until a newly launched instance can contribute to the CloudWatch metrics.
`metricAggregationType`	The aggregation type for the CloudWatch metrics.
`name`	The name of the Auto Scaling group.
`policyArn`	The Amazon Resource Name (ARN) of the policy.
`policyType`	The policy type.
`stepAdjustments` list of structures	A list of structures representing a set of adjustments that allow scaling based on the size of the alarm breach.

/aws/autoscaling/region-limit inventory

Name	Description
`accountName`	AWS account name.
`autoScalingGroups`	The current number of groups for the AWS account.
`awsRegion`	The AWS region where the region limit is defined.
`launchConfigurations`	The current number of launch configurations for the AWS account.
`maxAutoScalingGroups`	The maximum number of groups allowed for the AWS account.
`maxLaunchConfigurations`	The maximum number of launch configurations allowed for the AWS account.