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

  • CumulativeBytesMetered

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

CumulativeBytesMetered

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

Units: Bytes

Dimensions: Operation

Valid Statistics:

  • Sum

MagneticStoreRejectedRecordCount

The number of magnetic store written records that were rejected asynchronously. This can happen if the new record has a version that is less than the current version or the new record has version equal to the current version but has different data.

Units: Count

Dimensions

  • DatabaseName

  • TableName

  • Operation

Valid Statistics:

  • Sum

  • SampleCount

MagneticStoreRejectedUploadUserFailures

The number of magnetic store rejected record reports that were not uploaded due to user errors. This can be due to IAM permissions not configured correctly or a deleted S3 bucket.

Units: Count

Dimensions

  • DatabaseName

  • TableName

  • Operation

Valid Statistics:

  • Sum

  • SampleCount

MagneticStoreRejectedUploadSystemFailures

The number of magnetic store rejected record reports that were not uploaded due to system errors.

Units: Count

Dimensions

  • DatabaseName

  • TableName

  • Operation

Valid Statistics:

  • Sum

  • SampleCount

ActiveMagneticStorePartitions

The number of magnetic store partitions actively ingesting data at a given time.

Units: Count

Dimensions

  • DatabaseName

  • Operation

Valid Statistics:

  • Sum

  • SampleCount

MagneticStorePendingRecordsLatency

The oldest write to a magnetic store that is not available for query. Records written to the magnetic store will be available for querying within 6 hours.

Units: Milliseconds

Dimensions

  • DatabaseName

  • TableName

  • Operation

Valid Statistics:

  • Minimum

  • Maximum

  • Average

  • SampleCount

  • P10

  • p50

  • p90

  • p95

  • p99

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

CumulativeBytesMetered, 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.