AWS Auto Scaling monitoring integration

Access to this feature depends on your subscription level. Requires Infrastructure Pro.

The Amazon 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:

  1. Make sure you have installed the Infrastructure agent before you activate AWS integrations from your Infrastructure account.
  2. Follow standard procedures to connect AWS services to Infrastructure.
  3. Enable Auto Scaling group metrics so that Amazon Auto Scaling will send sampled data to CloudWatch every minute.

To enable group metrics using the console:

  1. Open the Amazon EC2 console at https://console.aws.amazon.com/ec2/.
  2. From the navigation pane, select Auto Scaling Groups > (select your group).
  3. 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 ALB 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 in Infrastructure, go to infrastructure.newrelic.com > Integrations > Amazon Web Services, then select one of the AWS Auto Scaling integration links.

In New Relic Insights, data is attached to these event types:

  • AutoScalingInstanceSample
  • AutoScalingGroupSample
  • AutoScalingLaunchConfigurationSample
  • AutoScalingPolicySample
  • AutoScalingRegionLimitSample

Metric data

This New Relic Infrastructure integration collects the following Amazon 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

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

/aws/autoscaling/group inventory

Inventory 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

Inventory 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

Inventory 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

Inventory 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

Inventory 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.

For more help

Recommendations for learning more: