Monitoring AWS Beanstalk

Setting metrics collection interval

Beanstalk instances are refreshed every 60 seconds. Due to an asynchronous nature of detection, display of instance metrics in the Instana UI can be delayed. This delay depends on the specified poll rate (cloudwatch_period) in the agent configuration file.

By default, the AWS Beanstalk sensor pulls and displays instance metrics on the Instana dashboard every 60 seconds. To modify this setting, change the cloudwatch_period configuration parameter value in the agent configuration yaml file /opt/instana/agent/etc/instana/configuration.yml:

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

Setting proxy configuration

To configure the specific AWS Sensor to use proxy configuration, add the following agent configuration settings:

com.instana.plugin.aws.beanstalk:
  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

Monitoring AWS Beanstalk environments across multiple AWS accounts

You need to configure which profiles or roles must be used to monitor Beanstalk environments across multiple AWS accounts.

For more information about setting up monitoring of multiple AWS accounts with one AWS agent in the same region, see Monitoring multiple AWS accounts.

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

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

Filtering AWS Beanstalk instances for monitoring

After the AWS Beanstalk sensor is enabled, it monitors all instances of AWS Beanstalk by default. However, you can filter which of the AWS Beanstalk instances the sensor must discover and monitor based on AWS tags. To configure filtering, modify the AWS agent configuration file /opt/instana/agent/etc/instana/configuration.yaml.

Multiple tags can be defined, separated by a comma. Tags must be provided as a key-value pair separated by colon (:). To make configuration easier, you can define which tags to include in discovery or exclude from discovery. If you define a tag in both lists (include and exclude), the exclude list has a higher priority. If you don't need filtering services, do not define the configuration. It’s not mandatory to define all values to enable filtering.

You can specify how often sensors poll the AWS tagged resources that use the tagged-services-poll-rate configuration property (default 300 seconds). For more information, see Modifying poll Rate.

Tags are only available with the AWS agent.

To include Beanstalk instances with specified tags into discovery, add their tags to the following configuration:

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

To exclude Beanstalk instances with specified tags from discovery, add their tags to the following configuration:

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

Beanstalk instances without tags are monitored by default but can be excluded by setting the include_untagged field to false:

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

Modifying poll rate

To define how often sensors poll the tagged resources, modify the tagged-services-poll-rate in the following configuration:

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

Environment details

The sensor tracks the following environment details:

• Application name
• Environment ID
• Environment Name
• Environment Description
• Environment ARN
• Environment Status
• Date created
• Version Label
• Solution Stack
• Environment URL
• Application name
• Application name
• Application name
• Grouping zone (region)

Instance details

The sensor tracks the following instance details:

• Instance ID
• Instance Status
• Instance Type
• Instance started Date

Environment metrics

The following table displays the environment metrics that the sensor collects:

Instance metrics

The following table displays the instance metrics that the sensor collects:

Environment and instance metrics

The following table displays the environment and instance metrics that the sensor collects: