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
- Enabling Auto Scaling group metrics
- Configuring the AWS Auto Scaling sensor
- Viewing metrics
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.
Viewing metrics
To view the metrics, complete the following steps:
- From the navigation menu in the Instana UI, select Infrastructure.
- 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. |