Monitoring AWS Auto Scaling

Instana comprehensively monitors your AWS Auto Scaling groups and provides visibility into your environment by using the AWS Auto Scaling sensor. After you install the Instana agent, the AWS Auto Scaling sensor is automatically deployed and installed. You can view metrics that are related to AWS Auto Scaling groups in the Instana UI.

The AWS Auto Scaling service automatically adjusts application capacity to ensure consistent performance. The AWS Auto Scaling group contains a collection of EC2 instances that are treated as a logical grouping for the purposes of automatic scaling and management. For other supported AWS services, see the AWS topic.

Required IAM permissions

The AWS Auto Scaling sensor requires the following AWS IAM permissions to monitor your AWS Auto Scaling groups:

  • cloudwatch:GetMetricData
  • cloudwatch:GetMetricStatistics
  • autoscaling:DescribeAutoScalingGroups

Enabling Auto Scaling group metrics

To monitor AWS Auto Scaling group by using Instana, enable the Auto Scaling group metrics collection option.

To enable Auto Scaling group metrics by using console, see Enable Auto Scaling group metrics (console).

To enable Auto Scaling group metrics by using AWS CLI, see Enable Auto Scaling group metrics (AWS CLI).

Configuring the AWS Auto Scaling sensor

After the Instana agent is installed, the AWS Auto Scaling sensor is enabled by default. Metrics for AWS Auto Scaling groups are pulled every 60 seconds. You can change this setting in the <agent_install_dir>/etc/instana/configuration.yml file:

com.instana.plugin.aws.autoscaling:
  cloudwatch_period: 60

Enabling proxy configuration

To enable the AWS Auto Scaling sensor to use the proxy configuration, add the following agent configuration settings:

com.instana.plugin.aws.autoscaling:
  proxy_host: 'example.com' # proxy host name or ip address
  proxy_port: 3128 # proxy port
  proxy_protocol: 'HTTP' # proxy protocol: HTTP or HTTPS
  proxy_username: 'username' # OPTIONAL: proxy username
  proxy_password: 'password' # OPTIONAL: proxy password

Disabling the AWS Auto Scaling sensor

To disable monitoring of Auto Scaling groups, use the following configuration:

com.instana.plugin.aws.autoscaling:
  enabled: false

Configuring monitoring for AWS Auto Scaling across multiple AWS accounts

To set up monitoring of multiple AWS accounts with one AWS agent in the same region, you can use two approaches. For more information, see Monitoring multiple AWS accounts.

AWS-named profiles approach

To override the profiles that monitor AWS Auto Scaling, use the following configuration:

com.instana.plugin.aws.autoscaling:
  profile_names:
    - 'profile2'
    - 'profile3'

If you define profiles on a service level, the global AWS profile configuration is overridden.

AWS STS approach

To override IAM roles that monitor the AWS Auto Scaling group, use the following configuration:

com.instana.plugin.aws.autoscaling:
  role_arns:
    - 'arn:aws:iam::<account_1_id>:role/<role_1_name>'
    - 'arn:aws:iam::<account_2_id>:role/<role_2_name>'

If you define IAM roles on a service level, the global AWS IAM role configuration is overridden.

Filtering by defining tags

Instana monitors all AWS Auto Scaling groups by default. You can also filter which AWS Auto Scaling groups Instana monitors by defining tags in the configuration.yaml file. If you don't want to filter groups, you needn't define the tags.

To define multiple tags, separate them with commas. Define tags as a key-value pair. To simplify configuration, you can define which tags you want to include in discovery or exclude from discovery. If you define a tag in both lists (include and exclude), the exclude list take precedence. It’s not mandatory to define all values to enable filtering.

You can specify how often sensors poll the AWS tagged resources by using the tagged-services-poll-rate configuration property. By default, the value is 300 seconds.

Tags are only available with the AWS agent.

To define how often sensors poll the tagged resources, use the following configuration:

com.instana.plugin.aws:
  tagged-services-poll-rate: 60 #default 300

To include AWS Auto Scaling groups with tags into discovery, use the following configuration:

com.instana.plugin.aws.autoscaling:
  include_tags: # Comma separated list of tags in key:value format (e.g. env:prod,env:staging)

To exclude AWS Auto Scaling groups with tags from discovery, use the following configuration:

com.instana.plugin.aws.autoscaling:
  exclude_tags: # Comma separated list of tags in key:value format (e.g. env:dev,env:test)

AWS services without tags are monitored by default, but can be excluded by setting the include_untagged field to false:

com.instana.plugin.aws.autoscaling:
  include_untagged: false # True value by default

Viewing metrics

To view the metrics, complete the following steps:

  1. From the navigation menu in the Instana UI, select Infrastructure.
  2. Click a specific monitored AWS Auto Scaling group.

You can see the AWS Auto Scaling group dashboard with all the collected metrics.

Configuration data

The AWS Auto Scaling sensor collects the following configuration data:

Name Description
Name The name of the Auto Scaling group.
ARN The Amazon Resource Name (ARN) of the Auto Scaling group.
Created time The date and time the group was created.
Minimum capacity The minimum size of the group.
Maximum capacity The maximum size of the group.
Desired capacity The required size of the group.

Metrics

The AWS Auto Scaling Group sensor collects the following metrics:

Name Description
Group In Service Instances The number of instances that are running as a part of the Auto Scaling group. This metric does not include instances that are pending or terminating.
Group Pending Instances The number of instances that are pending. A pending instance is not yet in service. This metric does not include instances that are in service or terminating.
Group Standby Instances The number of instances that are in a standby state. Instances in this state are still running but are not actively in service.
Group Terminating Instances The number of instances that are in the process of terminating. This metric does not include instances that are in service or pending.
Group Total Instances The total number of instances in the Auto Scaling group. This metric identifies the number of instances that are in service, pending, and terminating.
Group In Service Capacity The number of capacity units that are running as part of the Auto Scaling group. This metric is displayed only if mixed instances policy is set.
Group Pending Capacity The number of capacity units that are pending. This metric is displayed only if mixed instances policy is set.
Group Standby Capacity The number of capacity units that are in a standby state. This metric is displayed only if mixed instances policy is set.
Group Terminating Capacity The number of capacity units that are in the process of terminating. This metric is displayed only if mixed instances policy is set.
Group Total Capacity The total number of capacity units in the Auto Scaling group. This metric is displayed only if mixed instances policy is set.
Predictive Scaling Load Forecast The amount of load that's anticipated to be generated by your application.
Predictive Scaling Capacity Forecast The anticipated amount of capacity that is needed to meet the application demand.
Predictive Scaling Metric Pair Correlation The correlation between the scaling metric and the per-instance average of the load metric.