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 the Timescale Service it is attached to. If you have Timescale Services running in multiple regions, create an exporter for each region.

  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.
Screenshot of the menu for adding a Datadog exporter

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 the Timescale Service it is attached to. If you have Timescale Services running in multiple regions, create an exporter for each region.

  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:

TagExample variableDescription
hostus-east-1.timescale.cloud
project-id
service-id
regionus-east-1Timescale region
rolereplica or primaryFor services with replicas
node-idFor multi-node services

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

  1. Navigate to Integrations.
  2. Beside the exporter you want to edit, click the menu button. Click Edit.
  3. Edit the exporter fields and save your changes.

Delete any data exporters that you no longer need.

  1. Before deleting a data exporter, remove all connected services.
  2. For each connected service, navigate to the service Operations tab.
  3. Click Integrations.
  4. Click the trash can icon to remove the exporter from the service. This doesn't delete the exporter itself.
  5. In the main menu, navigate to Integrations.
  6. Beside the exporter you want to delete, click the menu button. Click Delete.
  7. Confirm that you want to delete.

Keywords

Found an issue on this page?

Report an issue!