Monitoring AWS CloudFront

CloudFront distribution details

The following CloudFront details are collected by the AWS CloudFront sensor:

Metrics

Instana collects metrics on CloudFront distribution and associated functions.

Configuring the AWS CloudFront sensor

To change the configuration of the AWS CloudFront sensor, edit the com.instana.plugin.aws.cloudfront properties of the agent configuration in the <agent_install_dir>/etc/instana/configuration.yml file.

The AWS CloudFront sensor pulls metrics for CloudFront once every 5 minutes. To change this frequency, use the cloudwatch_period property:

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

Enabling function monitoring incurs additional financial costs due to an increase in gathered CloudWatch metrics.

To enable monitoring of CloudFront functions, set the enable_function_monitoring: true property:

com.instana.plugin.aws.cloudfront:
   enable_function_monitoring: true

To disable monitoring of CloudFront distributions, set the enabled: false property:

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

Configuring the AWS CloudFront sensor to use a proxy

To make the AWS CloudFront sensor use a proxy, add the following properties to the agent configuration in the <agent_install_dir>/etc/instana/configuration.yml file:

com.instana.plugin.aws.cloudfront:
  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 multiple AWS accounts

To set up monitoring of multiple AWS accounts with one AWS agent in the same region, see the Monitoring multiple AWS accounts topic.

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

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

Filtering

You can define tags that are to be used to include services in discovery or to exclude services from discovery. If you don't need to filter services, you don't need to define the tags.

You can define multiple tags, which are separated by a comma. Define each tag as a key-value pair. To make configuration easier, you can define which tags you want to include in discovery or exclude from discovery. If you define the same tag in both lists (include and exclude), the exclude list has higher priority. It’s not mandatory to define all values to enable filtering.

Tags are only available with the AWS Agent.

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.

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 services by tags into discovery, use the following configuration:

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

To exclude services by tags from discovery, use the following configuration:

com.instana.plugin.aws.cloudfront:
  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.cloudfront:
  include_untagged: false # True value by default