Skip to main content
Datadog is a cloud-based monitoring and analytics platform that provides comprehensive visibility into applications, infrastructure, and systems through real-time monitoring, logging, and analytics. This page explains how to:

Prerequisites

To follow the steps on this page:
  • Create a target with time-series and analytics enabled. You need your connection details.

Monitor metrics with Datadog

Export telemetry data from your s with the time-series and analytics capability enabled to Datadog using a data exporter. The available metrics include CPU usage, RAM usage, and storage.

Create a data exporter

A data exporter sends telemetry data from a to a third-party monitoring tool. You create an exporter on the project level, in the same AWS region as your :

Manage a data exporter

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

Attach a data exporter to a

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

Monitor metrics

You can now monitor your 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.
TagExample variableDescription
hostus-east-1.timescale.cloud
project-id
service-id
regionus-east-1AWS region
rolereplica or primaryFor with replicas
node-idFor multi-node services

Edit a data exporter

To update a data exporter:

Delete a data exporter

To remove a data exporter that you no longer need:

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:
RegionZoneLocationURL
ap-southeast-1Asia PacificSingaporeirsa-oidc-discovery-prod-ap-southeast-1.s3.ap-southeast-1.amazonaws.com
ap-southeast-2Asia PacificSydneyirsa-oidc-discovery-prod-ap-southeast-2.s3.ap-southeast-2.amazonaws.com
ap-northeast-1Asia PacificTokyoirsa-oidc-discovery-prod-ap-northeast-1.s3.ap-northeast-1.amazonaws.com
ca-central-1CanadaCentralirsa-oidc-discovery-prod-ca-central-1.s3.ca-central-1.amazonaws.com
eu-central-1EuropeFrankfurtirsa-oidc-discovery-prod-eu-central-1.s3.eu-central-1.amazonaws.com
eu-west-1EuropeIrelandirsa-oidc-discovery-prod-eu-west-1.s3.eu-west-1.amazonaws.com
eu-west-2EuropeLondonirsa-oidc-discovery-prod-eu-west-2.s3.eu-west-2.amazonaws.com
sa-east-1South AmericaSão Pauloirsa-oidc-discovery-prod-sa-east-1.s3.sa-east-1.amazonaws.com
us-east-1United StatesNorth Virginiairsa-oidc-discovery-prod.s3.us-east-1.amazonaws.com
us-east-2United StatesOhioirsa-oidc-discovery-prod-us-east-2.s3.us-east-2.amazonaws.com
us-west-2United StatesOregonirsa-oidc-discovery-prod-us-west-2.s3.us-west-2.amazonaws.com

Configure Datadog Agent to collect metrics for your s

Datadog Agent includes a integration that you use to collect detailed database metrics about your s.
  1. Connect to your For , open an SQL editor in . For , use psql.
  2. Add the datadog user to your
    create user datadog with password '<password>';
    
    grant pg_monitor to datadog;
    
    grant SELECT ON pg_stat_database to datadog;
    
  3. Test the connection and rights for the datadog user Update the following command with your connection details, then run it from the command line:
     psql "postgres://datadog:<datadog password>@<host>:<port>/tsdb?sslmode=require" -c \
     "select * from pg_stat_database LIMIT(1);" \
     && echo -e "\e[0;32mPostgres connection - OK\e[0m" || echo -e "\e[0;31mCannot connect to Postgres\e[0m"
    
    You see the output from the pg_stat_database table, which means you have given the correct rights to datadog.
  4. Connect Datadog to your
    1. Open the datadog agent configuration file, usually located at:
      • Linux: /etc/datadog-agent/conf.d/postgres.d/conf.yaml
      • MacOS: /opt/datadog-agent/etc/conf.d/postgres.d/conf.yaml
      • Windows: C:\ProgramData\Datadog\conf.d\postgres.d\conf.yaml
    2. Integrate Datadog Agent with your Use your connection details to update the following and add it to the datadog agent configuration file:
      init_config:
      
      instances:
      - host: <host>
        port: <port>
        username: datadog
        password: <datadog's password>>
        dbname: tsdb
        disable_generic_tags: true
      
  5. Add metrics Tags to make it easier for build Datadog dashboards that combine metrics from the data exporter and Datadog Agent. Use your connection details to update the following and add it to <datadog_home>/datadog.yaml:
    tags:
      - project-id:<project-id>
      - service-id:<service-id>
      - region:<region>
    
  6. Restart Datadog Agent See how to Start, stop, and restart Datadog Agent.
Metrics for your are now visible in Datadog. Check the Datadog integration documentation for a comprehensive list of metrics collected.