Export telemetry data to AWS Cloudwatch

You can export telemetry data from your Timescale Cloud services with the time-series and analytics capability enabled to Amazon CloudWatch. Available metrics include CPU usage, RAM usage, and storage. This integration is available for Scale or Enterprise pricing plans.

This page shows you how to create an Amazon CloudWatch exporter in Timescale Console, and manage the lifecycle of data exporters.

Prerequisites

To follow the steps on this page:

Create a target Timescale Cloud service with time-series and analytics enabled.

Create a data exporter

Timescale Cloud data exporters send telemetry data from a Timescale Cloud service to a third-party monitoring tools. You create an exporter on the project level, in the same AWS region as your service:

In Timescale Console, open Exporters
Click New exporter
Select the data type and specify AWS CloudWatch for provider
Provide your AWS CloudWatch configuration
- The AWS region must be the same for your Timescale Cloud exporter and AWS CloudWatch Log group.
- The exporter name appears in Cloud console, best practice is to make this name easily understandable.
- For CloudWatch credentials, either use an existing CloudWatch Log group or create a new one. If you're uncertain, use the default values. For more information, see Working with log groups and log streams.
Choose the authentication method to use for the exporter
Select the AWS Region your CloudWatch services run in, then click Create exporter.

Manage a data exporter

This section shows you how to attach, monitor, edit, and delete a data exporter.

Attach a data exporter to a Timescale Cloud service

To send telemetry data to an external monitoring tool, you attach a data exporter to your Timescale Cloud service. You can attach only one exporter to a service.

To attach an exporter:

In Timescale Console, choose the service
Click Operations > Exporters
Select the exporter, then click Attach exporter
If you are attaching a first Logs data type exporter, restart the service

Monitor Timescale Cloud service metrics

You can now monitor your service metrics. Use the following metrics to check the service is running correctly:

timescale.cloud.system.cpu.usage.millicores
timescale.cloud.system.cpu.total.millicores
timescale.cloud.system.memory.usage.bytes
timescale.cloud.system.memory.total.bytes
timescale.cloud.system.disk.usage.bytes
timescale.cloud.system.disk.total.bytes

Additionally, use the following tags to filter your results.

Tag	Example variable	Description
`host`	`us-east-1.timescale.cloud`
`project-id`
`service-id`
`region`	`us-east-1`	AWS region
`role`	`replica` or `primary`	For service with replicas
`node-id`		For multi-node services

Edit a data exporter

To update a data exporter:

In Timescale Console, open Exporters
Next to the exporter you want to edit, click the menu > Edit
Edit the exporter fields and save your changes

You cannot change fields such as the provider or the AWS region.

Delete a data exporter

To remove a data exporter that you no longer need:

Disconnect the data exporter from your Timescale Cloud services
1. In Timescale Console, choose the service.
2. Click Operations > Exporters.
3. Click the trash can icon.
4. Repeat for every service attached to the exporter you want to remove.
The data exporter is now unattached from all services. However, it still exists in your project.
Delete the exporter on the project level
1. In Timescale Console, open Exporters
2. Next to the exporter you want to edit, click menu > Delete
3. Confirm that you want to delete the data exporter.

Reference

When you create the IAM OIDC provider, the URL must match the region you create the exporter in. It must be one of the following:

Region	Zone	Location	URL
`ap-southeast-1`	Asia Pacific	Singapore	`irsa-oidc-discovery-prod-ap-southeast-1.s3.ap-southeast-1.amazonaws.com`
`ap-southeast-2`	Asia Pacific	Sydney	`irsa-oidc-discovery-prod-ap-southeast-2.s3.ap-southeast-2.amazonaws.com`
`ap-northeast-1`	Asia Pacific	Tokyo	`irsa-oidc-discovery-prod-ap-northeast-1.s3.ap-northeast-1.amazonaws.com`
`ca-central-1`	Canada	Central	`irsa-oidc-discovery-prod-ca-central-1.s3.ca-central-1.amazonaws.com`
`eu-central-1`	Europe	Frankfurt	`irsa-oidc-discovery-prod-eu-central-1.s3.eu-central-1.amazonaws.com`
`eu-west-1`	Europe	Ireland	`irsa-oidc-discovery-prod-eu-west-1.s3.eu-west-1.amazonaws.com`
`eu-west-2`	Europe	London	`irsa-oidc-discovery-prod-eu-west-2.s3.eu-west-2.amazonaws.com`
`sa-east-1`	South America	São Paulo	`irsa-oidc-discovery-prod-sa-east-1.s3.sa-east-1.amazonaws.com`
`us-east-1`	United States	North Virginia	`irsa-oidc-discovery-prod.s3.us-east-1.amazonaws.com`
`us-east-2`	United States	Ohio	`irsa-oidc-discovery-prod-us-east-2.s3.us-east-2.amazonaws.com`
`us-west-2`	United States	Oregon	`irsa-oidc-discovery-prod-us-west-2.s3.us-west-2.amazonaws.com`

Related Content