Datadog is an observability platform for cloud-scale applications. Integrating your Render services and databases with Datadog can provide your applications with fine-tuned metrics, monitoring, and automated alerting.
While creating a Postgres database, enter your Datadog API key in the respective field, as shown below. Adding an API key will enable a Datadog agent to run alongside your Postgres instance and report metrics to your Datadog account.
The metrics reported by the Datadog agent are all native to the Datadog platform, so you will not be charged any fees for custom metrics.
Attaching a Datadog API key is only supported for new databases. If you would like to enable this for an existing database, please reach out to firstname.lastname@example.org with the following information:
- The Database ID is that you want Datadog enabled on
- US West coast business hours (with a minimum of 24 hours notice) when we can restart your database. Note that there will be a brief moment of downtime while your database restarts.
- Set your Datadog API token as an environment variable on a Service or Environment Group. Include the location of this variable in your message to support. Do not send your api key in plain text over.
While the Render Dashboard metrics provide you with the core Postgres metrics, using 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.
The following Datadog integrations are fully supported, and you can view all the metrics listed in the documentation linked below.
- Postgres - metrics related to your PostgreSQL instance
- Disk - metrics related to disk usage and IO for your Postgres volume
- Network - metrics related to TCP/IP network stats of instance
In addition to the above integrations, the following metrics are also reported:
|The number of CPUs, as chosen by your database plan|
|The percentage of time the CPU spent running the kernel|
|The percentage of time the CPU spent running user space processes|
|The amount of free RAM|
|The total amount of physical RAM, as chosen by your database plan|
|The amount of RAM in use|
Within Datadog, you can see the metrics on any dashboard or metrics explorer page. You will be able to filter metrics by the
database-id tag equal to your Render Postgres database ID. The screenshot below is an example of some metrics you can view.
You can use Datadog as a logging provider for Render Log Streams, which will allow you to view and manage logs from any Render service or databases directly from your Datadog dashboard.