Integrate Timescale services with third-party monitoring tools

You can export your service telemetry to a third-party monitoring tool, such as Datadog or AWS CloudWatch. Exported metrics include CPU usage, RAM usage, and storage.

Export telemetry data by:

1. Creating a data exporter
2. Attaching the exporter to a database service

Important

Your exporter must be in the same AWS region as your database service. If you have databases in multiple regions, you can create multiple exporters.

Datadog

AWS CloudWatch

Creating a data exporter for Datadog

1. In the Timescale console, navigate to Integrations.
2. Click Create exporter.
3. Choose the telemetry data type that you would like to send to a provider.
4. Under Choose a provider, choose Datadog.
5. Choose an AWS region for your exporter to live within Timescale. The exporter is only available to database services in the same AWS region.
6. Name your exporter. This name appears in the Cloud console, so choose a descriptive name.
7. Add a Datadog API key. If you don't have an API key yet, you can create one by following the instructions in the Datadog documentation.
8. Under Site, choose your Datadog region. You can choose a region to meet any regulatory requirements or application needs you might have.
9. Click Create exporter.

Expand image

Once you create a data exporter, you can attach it to a service. The exporter then exports that service's telemetry data.

You can only have one exporter per service.

Important

Your exporter must be in the same AWS region as your database service. If you have databases in multiple regions, you can create multiple exporters.

Attaching a data exporter to a service

1. Navigate to Services. Click on the service you want to connect to your exporter.
2. Navigate to Operations, then Integrations.
3. Select an exporter and click Attach exporter.

Warning

If you would like to attach a logs exporter to an already existing service, you do not need to restart the service. The service only needs to be restarted when you attach the first logs exporter.

You can now monitor your service metrics from the metrics explorer in Datadog, or query them from the cloudWatch metrics page in AWS Console. For more information, see the Datadog or Cloudwatch documentation.

When you have set up your integration, you can check that it is working correctly by looking for the metrics that Timescale exports. The metric names are:

• 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, Timescale exports tags that you can use to filter your results. You can also check that these tags are being correctly exported:

You can edit a data exporter after you create it. Some fields, such as the provider and AWS region, can't be changed.

Delete any data exporters that you no longer need.