Monitoring Amazon Simple Notification Service (SNS)

Disabling the Amazon SNS sensor

To disable monitoring of Amazon SNS instances, use the following configuration:

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

Setting the metric collection interval

By default, metrics for SNS are pulled every 5 minutes. To change this frequency, edit the cloudwatch_period value in the agent configuration file <agent_install_dir>/etc/instana/configuration.yml as shown in the following example:

com.instana.plugin.aws.sns:
  cloudwatch_period: 300

Setting proxy configurations

To configure the Amazon SNS sensor to use proxy configuration, add the following agent configuration settings:

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

Configuring monitoring of Amazon SNS across multiple AWS accounts

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

To configure the Instana agent to monitor Amazon SNS across multiple AWS accounts, use any one of the following approaches:

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

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

Filtering Amazon SNS services by defining tags

If you want to monitor all Amazon SNS services without filtering, avoid defining any configuration.

Instana monitors all Amazon SNS services by default. However, if you don't want to monitor all services, define which tags you want to include or exclude from discovery in the agent configuration.yaml file. If you define a tag or resource group in both lists (include and exclude), the exclude list takes precedence.

To define multiple tags, separate them with commas. Define tags as a key-value pair that is separated by a colon (:). You needn't define all values to enable filtering.

To include services by tags in discovery, update the configuration.yaml file as shown in the following example:

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

To exclude services by tags from discovery, update the configuration.yaml file as shown in the following example:

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

Amazon SNS services without tags are monitored by default but can be excluded by setting the include_untagged field to false as shown in the following example:

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

Setting poll rate

You can specify how often sensors poll the AWS tagged resources by using the tagged-services-poll-rate configuration property. By default, 300 seconds.

Tags are only available with the AWS Agent.

To define how often sensors poll the tagged resources, update the configuration.yaml file as shown in the following example:

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

Tracked configuration

Metrics