Datadog is an observability platform for cloud-scale applications. You can integrate your Render services and databases with Datadog to enable fine-tuned metrics, monitoring, and automated alerting.

Although core Postgres metrics are available in the Render Dashboard, integrating with Datadog can provide more detailed metrics about the Postgres instance host environment. You can also use Datadog as a centralized location for dashboards and automated alerts.

Sign up for a Datadog account if you don't already have one. Then, create or retrieve an API key from your Datadog organization settings page:

Make sure to create an API key for your organization. The Datadog integration doesn't support using an application key or a user-scoped API key.

You can confirm that you've correctly generated an API key by calling Datadog's validate endpoint with your key.

Adding an API key enables a Datadog agent to run alongside your Render Postgres instance and report metrics to your Datadog account. All metrics reported by the agent are native to the Datadog platform, so you aren't billed for custom metrics.

Render currently supports only the Datadog sites US1, US3, US5, and EU1. Postgres monitoring is not supported with other Datadog sites (such as AP1, AP2, and US1-FED).

While creating a Postgres database, provide your Datadog API key in the corresponding field:

Add your Datadog API key from the Info tab of your database's page on the Render Dashboard (in the General section, click Add Datadog API Key).

This requires a restart of your Postgres instance, which causes brief downtime.

Render fully supports all of the following Datadog integrations (see the linked documentation for metrics details):

In addition, Render reports the following metrics:

You can view reported metrics from any Datadog dashboard or metrics explorer page. You can filter metrics by the database-id tag equal to your Render Postgres database ID.

Streaming service logs and metrics

You can use Datadog as your observability provider for Render log streams and metrics streams. This enables you to inspect logs and metrics from your Render services directly in your Datadog dashboard.

Currently, Render only supports TCP log forwarding with TLS.

Check the Datadog docs to confirm whether TCP log forwarding is supported for your site.

To set these up, follow the general setup instructions in the log stream docs and metrics stream docs.

In both cases, you specify your Datadog API key and Datadog site in the Render Dashboard. Note that both integrations require an organization-level API key, not an application key or user-scoped API key.

For log streams, you specify the endpoint corresponding to your Datadog site: