---
title: Integrate Datadog with Tiger Cloud | Tiger Data Docs
description: Export telemetry data and collect metrics to monitor your service performance
---

[Datadog](https://www.datadoghq.com/) 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:

- [Monitor Tiger Cloud service metrics with Datadog](#monitor-tiger-cloud-service-metrics-with-datadog)

  This integration is available for [Scale and Enterprise](/docs/deploy/tiger-cloud/tiger-cloud-aws/pricing-and-account-management#features-included-in-each-pricing-plan/index.md) pricing plans.

- Configure Datadog Agent to collect metrics for your Tiger Cloud service

  This integration is available for all pricing plans.

## Prerequisites

To follow the steps on this page:

- Create a target [Tiger Cloud service](/docs/get-started/quickstart/create-service/index.md) with the Real-time analytics capability.

  You need your [connection details](/docs/integrate/find-connection-details/index.md).

* Sign up for [Datadog](https://www.datadoghq.com/).

  You need your [Datadog API key](https://docs.datadoghq.com/account_management/api-app-keys/#add-an-api-key-or-client-token) to follow this procedure.

* Install [Datadog Agent](https://docs.datadoghq.com/getting_started/agent/#installation).

## Monitor Tiger Cloud service metrics with Datadog

Export telemetry data from your Tiger Cloud services with the time-series and analytics capability enabled to Datadog using a Tiger Cloud data exporter. See [Exported metrics](/docs/integrate/observability-alerting/exported-metrics/index.md) for the full list of default and additional metrics you can export.

### Create a data exporter

A Tiger Cloud data exporter sends telemetry data from a Tiger Cloud service to a third-party monitoring tool. You create an exporter on the [project level](/docs/deploy/tiger-cloud/tiger-cloud-aws/security/members/index.md), in the same AWS region as your service:

1. **In Tiger Console, open Exporters**

2. **Click `New exporter`**

3. **Select `Metrics` for `Data type` and `Datadog` for provider**

   ![Adding a Datadog exporter in Tiger Console](/docs/_astro/tiger-cloud-integrations-datadog.DhcwoTmg_ZUvac9.webp)

4. **Choose your AWS region and provide the API key**

   The AWS region must be the same for your Tiger Cloud exporter and the Datadog provider.

5. **Set `Site` to your Datadog region**

6. **Export additional metrics**

   Optionally tick `PostgreSQL metrics` to export [additional metrics](/docs/integrate/observability-alerting/exported-metrics#postgresql-metrics/index.md), then click `Create exporter`.

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

### Attach a data exporter to a Tiger Cloud service

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

To attach an exporter:

1. **In Tiger Console, choose the service**
2. **Click `Operations` > `Exporters`**
3. **Select the exporter, then click `Attach exporter`**
4. **If you are attaching a first `Logs` data type exporter, restart the service**

You can now monitor your service metrics.

### Edit a data exporter

To update a data exporter:

1. **In Tiger Console, open Exporters**
2. **Next to the exporter you want to edit, click the menu > `Edit`**
3. **Edit the exporter fields and save your changes**

### Delete a data exporter

To remove a data exporter that you no longer need:

1. **Disconnect the data exporter from your Tiger Cloud service**

   1. In [Tiger Console](https://console.cloud.tigerdata.com/dashboard/services), choose the service.
   2. Click `Operations` > `Exporters`.
   3. Click the trash can icon next to the exporter.
   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.

2. **Delete the exporter on the project level**

   1. In Tiger Console, open [Exporters](https://console.cloud.tigerdata.com/dashboard/integrations)
   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`           |

## Configure Datadog Agent to collect metrics for your services

Datadog Agent includes a [PostgreSQL integration](https://docs.datadoghq.com/integrate/postgres/) that you use to collect detailed PostgreSQL database metrics about your Tiger Cloud services.

1. **Connect to your Tiger Cloud service**

   For Tiger Cloud, open an SQL editor in [Tiger Console](https://console.cloud.tigerdata.com/dashboard/services). For self-hosted TimescaleDB, use [`psql`](/docs/integrate/query-administration/psql/index.md).

2. **Add the `datadog` user to your Tiger Cloud service**

   ```
   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](/docs/integrate/find-connection-details/index.md), then run it from the command line:

   Terminal window

   ```
    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 Tiger Cloud service**

   1. Configure the [Datadog Agent PostgreSQL configuration file](https://docs.datadoghq.com/database_monitoring/setup_postgres/selfhosted?tab=postgres15); it is usually located on the Datadog Agent host 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 Tiger Cloud service:

      Use your [connection details](/docs/integrate/find-connection-details/index.md) to update the following and add it to the Datadog Agent PostgreSQL configuration file:

      ```
      init_config:


      instances:
      - host: <host>
        port: <port>
        username: datadog
        password: <datadog's password>>
        dbname: tsdb
        disable_generic_tags: true
      ```

5. **Add Tiger Cloud metrics**

   Tags to make it easier for build Datadog dashboards that combine metrics from the Tiger Cloud data exporter and Datadog Agent. Use your [connection details](/docs/integrate/find-connection-details/index.md) 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](https://docs.datadoghq.com/agent/configuration/agent-commands/#start-stop-and-restart-the-agent).

Metrics for your Tiger Cloud service are now visible in Datadog. Check the Datadog PostgreSQL integration documentation for a comprehensive list of [metrics](https://docs.datadoghq.com/integrate/postgres/?tab=host#metrics) collected.