Timestream Metrics and Dimensions - Amazon Timestream

Timestream Metrics and Dimensions

When you interact with Timestream, it sends the following metrics and dimensions to Amazon CloudWatch. All metrics are aggregated and reported every minute. You can use the following procedures to view the metrics for Timestream.

To view metrics using the CloudWatch console

Metrics are grouped first by the service namespace, and then by the various dimension combinations within each namespace.

  1. Open the CloudWatch console at https://console.aws.amazon.com/cloudwatch/.

  2. If necessary, change the Region. On the navigation bar, choose the Region where your AWS resources reside. For more information, see AWS Service Endpoints.

  3. In the navigation pane, choose Metrics.

  4. Under the All metrics tab, choose AWS/Timestream.

To view metrics using the AWS CLI

  • At a command prompt, use the following command.

    aws cloudwatch list-metrics --namespace "AWS/Timestream"

Timestream Metrics and Dimensions

The following CloudWatch metrics are available in Timestream:

  • SuccessfulRequestLatency

  • SystemErrors

  • UserErrors

  • DataScannedBytes

The following dimensions are available:

  • Operation

  • DatabaseName

  • TableName

Timestream Metrics

Amazon CloudWatch aggregates the following Timestream metrics:

Note

All metrics are aggregated at one-minute intervals.

Metric Description

SystemErrors

The requests to Timestream that generate a SystemError during the specified time period. A SystemError usually indicates an internal service error.

Units: Count

Dimensions: Operation

Valid Statistics:

  • Sum

  • SampleCount

UserErrors

Requests to Timestream that generate an InvalidRequest error during the specified time period. An InvalidRequest usually indicates a client-side error, such as an invalid combination of parameters, an attempt to update a nonexistent table, or an incorrect request signature. UserErrors represents the aggregate of invalid requests for the current AWS Region and the current AWS account.

Units: Count

Dimensions: Operation

Valid Statistics:

  • Sum

  • SampleCount

SuccessfulRequestLatency

The successful requests to Timestream during the specified time period.  SuccessfulRequestLatency can provide two different kinds of information:

  • The elapsed time for successful requests (Minimum, Maximum,Sum, or Average).

  • The number of successful requests (SampleCount).

SuccessfulRequestLatency reflects activity only within Timestream and does not take into account network latency or client-side activity.

Units: Milliseconds

Dimensions

  • DatabaseName

  • TableName

  • Operation

Valid Statistics:

  • Minimum

  • Maximum

  • Average

  • SampleCount

  • P10

  • p50

  • p90

  • p95

  • p99

DataScannedBytes

The amount of data scanned by queries sent to Timestream, in bytes.

Units: Bytes

Dimensions: Operation

Valid Statistics:

  • Sum

Important

Not all statistics, such as Average or Sum, are applicable for every metric. However, all of these values are available through the Timestream console, or by using the CloudWatch console, AWS CLI, or AWS SDKs for all metrics.

Important

DataScannedBytes, UserErrors and SystemErrors metrics only have the Operation dimension. SuccessfulRequestLatency metrics always have Operation dimension, bu may also have the DatabaseName and TableName dimensions too, depending on the value of Operation. This is because Timestream table-level operations have DatabaseName and TableName as dimensions, but account level operations do not. See Dimensions for Timestream Metrics.

Dimensions for Timestream Metrics

The metrics for Timestream are qualified by the values for the account, table name, or operation. You can use the CloudWatch console to retrieve Timestream data along any of the dimensions in the following table:

Dimension Description
DatabaseName

This dimension limits the data to a specific Timestream database. This value can be any database in the current Region and the current AWS account

Operation

This dimension limits the data to one of the Timestream operations. See the Timestream Query API Reference for a list of available values.

TableName

This dimension limits the data to a specific table in a Timestreams database.