Monitoring Amazon Timestream

To enable the Amazon Timestream sensor to use the proxy configuration, add the following agent configuration settings:

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

To disable monitoring of the Amazon Timestream databases, use the following configuration:

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

To set up monitoring of multiple AWS accounts with one AWS agent in the same region, you can use two approaches. For more information, see Monitoring multiple AWS accounts.

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

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

Instana monitors all Amazon Timestream databases by default. You can also filter which Amazon Timestream databases Instana monitors by defining tags in the configuration.yaml file. If you don't want to filter databases, you needn't define the tags.

To define multiple tags, separate them with commas. Define tags as a key-value pair. To simplify configuration, you can define which tags you want to include in discovery or exclude from discovery. If you define a tag in both lists (include and exclude), the exclude list take precedence. It’s not mandatory to define all values to enable filtering.

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 Amazon Timestream databases with tags into discovery, use the following configuration:

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

To exclude Amazon Timestream databases with tags from discovery, use the following configuration:

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

The Amazon Timestream sensor collects the following configuration data:

Name	Description
ARN	The Amazon Resource Name (ARN) of the Timestream database.
Database name	The name of the Timestream database.
Created time	The date and time of creation of the database.
Type	LiveAnalytics is available. Monitoring of InfluxDB instances is not supported.

The Amazon Timestream sensor collects the following metrics:

Name	Description
Successful Request Latency	The latency of successful requests to Timestream for LiveAnalytics during the specified time period. This metric is available for the following statistics: Minimum, Maximum, Average, and SampleCount.
Magnetic Store Rejected Record Count	The number of magnetic store-written records that are rejected asynchronously.
Active Magnetic Store Partitions	The number of magnetic store partitions that actively ingest data at a particular time.
Magnetic Store Pending Records Latency	The oldest write to a magnetic store that is not available for query.
Magnetic Store Rejected Upload User Failures	The number of magnetic store-rejected record reports that are not uploaded due to user errors.
Magnetic Store Rejected Upload System Failures	The number of magnetic store rejected record reports that are not uploaded due to system errors.