AWS

To provide visibility and insight into Amazon Web Services based cloud environments, Instana automatically discovers and monitors your AWS services.

Amazon Web Services monitoring:

  • Provides real-time insights into metadata, configuration, and metrics.
  • Observes the health of each service and alerts on issues.
  • Enables service discovery leveraging service information (see our Service Configuration docs).
  • Places this insight within the context of the rest of your infrastructure and services.

Due to the nature of the AWS CloudWatch API, a delay in metrics retrieval is possible. The displayed values for the metrics are also delayed to ensure consistency. This delay depends on the actual AWS service and availability of data at that time, but usually is around 10 minutes.

The default metric retrieval rates are described on each service page below, and their values are AWS defined defaults.

Agent Installation & Configuration

To install our agent in your AWS infrastructure, see our AWS agent installation docs. For each service, you need to add the required permissions noted below on the individual service pages. To exclude a service from monitoring, leave out the respective permission.

Another way to exclude a service from monitoring is to add the appropriate enabled flag in <agent_install_dir>/etc/instana/configuration.yml as described on the individual service pages below.

Filtering and tagging

To determine which AWS services are discovered, Instana supports filtering by AWS tags. To configure those filters for a complete AWS subscription, modify the agent configuration file <agent_install_dir>/etc/instana/configuration.yaml:

Available options in the configuration file are:

com.instana.plugin.aws:
    # Comma-separated list of tags in key:value format. 
    # Any AWS resource containing at least one of the specified tags is discovered.
    include_tags: 
    # Comma-separated list of tags in key:value format. 
    # Any AWS resource containing at least one of the specified tags is omitted from discovery. 
    exclude_tags: 

Multiple tags can be defined, separated by a comma. Tags should be a key-value pair separated by :. When defining tags in both lists (include and exclude), the exclude list has higher priority. If there is no need for services filtering, the configuration should not be defined.

The Instana agent automatically discovers all AWS resources that have no tags assigned.

NOTE: To enable filtering, the IAM permission tag:GetResources should be included.

Configure filtering

To specify how often sensors poll the AWS tagged resource, use the tagged-servies-poll-rate configuration property. The default is 300 seconds.

The poll-rate configuration for the tagged resources is:

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

To include services by tags in the discovery, use the following configuration:

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

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

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

Discovery filtering can also be configured on the service level. In this case, the default configuration is overridden. For more details about discovery filtering by specific service, see the specified service documentation.

AWS Services