Monitoring AWS EC2

Note: Learn about the other supported AWS services with our AWS documentation.

Sensor (Data Collection)

Tracked Configuration

• EC2 Instance Details

  • Public Hostname
  • Instance ID
  • Type
  • Availability Zone
  • Public IP
  • AMI ID
  • Reservation ID
  • Security Groups
  • Public Keys
• EC2 Availability Zone

Required Permissions

• ec2:DescribeInstances
• ec2:DescribeTags

Configuration

Tags for EC2 instances are pulled every 30 seconds, this can be changed via agent configuration in <agent_install_dir>/etc/instana/configuration.yml:

com.instana.plugin.aws.ec2:
  tags-poll-rate: 30

To disable tags retrieval of EC2 instances use the following configuration:

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

Monitoring multiple AWS accounts

Refer to the Monitoring multiple AWS accounts documentation to set up monitoring of multiple AWS accounts with one AWS agent in the same region.

AWS named profiles approach

To override which profiles should be used to monitor Elastic Cloud Computing, use the following configuration:

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

Note: Defining profiles on service level will override the global AWS profiles configuration.

AWS STS approach

To override which IAM Roles should be used to monitor Elastic Cloud Computing, use the following configuration:

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

Note: Defining IAM roles on service level will override the global AWS IAM roles configuration.

Instana Agent Tags

Please note that tags are only available in conjunction with the AWS Agent. More details on using tags are described here.