OpenTelemetry Neon DB Integration

Monitor your Neon DB project's health and performance in SigNoz by directly configuring your observability pipeline using the OpenTelemetry Protocol (OTLP). Neon supports natively exporting Postgres logs and infrastructural metrics without the need for an intermediate OpenTelemetry Collector.

Prerequisites

Before you begin, ensure you have:

A Neon project
An instance of SigNoz Cloud

Configure the Neon Project Integration

Neon allows you to configure your OpenTelemetry endpoint directly from their web console. To start exporting metrics and logs to SigNoz Cloud:

Step 1: Add the OpenTelemetry Integration in Neon

Log into your Neon Console and go to the Integrations page.
Under the Monitor > OpenTelemetry section, click Add.
Select the type of data you want to export. You can select either Metrics or Logs or both.

*Neon DB Integration Setup - Select Data Type*

Step 2: Configure Destination

Select connection protocol as gRPC (recommended) or HTTP.
Enter SigNoz Cloud ingestion endpoint in the Endpoint URL field:

https://ingest.<region>.signoz.cloud:443

Select API Key for authentication and set the custom header name to signoz-ingestion-key, and enter your <your-ingestion-key>.
Verify these values:
- <region>: Your SigNoz Cloud region
- <your-ingestion-key>: Your SigNoz ingestion key

Optionally, in the Resource section, configure the service.name attribute to identify your Neon project in SigNoz. You can use your actual project name. Neon will divide the metrics logically into compute-host-metrics for host metrics and sql-metrics for Postgres.

*Neon DB Integration Setup - Destination*

Step 3: Save and Complete the Integration

Click Save to complete the setup. If successful, the integration will be listed under the Integrations page in Neon, and you will start seeing metrics and logs in SigNoz within a few minutes.

Validate

Verify the metrics are being collected by SigNoz. Neon data should start appearing in SigNoz within a few minutes.

To check for metrics, go to the Dashboards > Metrics Explorer and look for metrics prefixed with neon_ or metrics carrying your configured service.name related to Postgres.
Go to the Logs tab in SigNoz and query using your configured service.name to see Postgres logs.

Troubleshooting

Data is not appearing in SigNoz

Invalid Credentials: Ensure your signoz-ingestion-key is correctly populated and you have not selected "Bearer" or "Basic".
Endpoint Suffixes: Do not append /v1/metrics or /v1/logs to your endpoint URL as Neon appends this automatically. Check that your URL ends in .cloud:443 without trailing slashes.

Next Steps

Take a look at the query builder to start building dashboards with your Postgres data.
Read how to Set up Alerts in SigNoz.

Get Help

If you need help with the steps in this topic, please reach out to us on SigNoz Community Slack.

If you are a SigNoz Cloud user, please use in product chat support located at the bottom right corner of your SigNoz instance or contact us at cloud-support@signoz.io.