Skip to main content
Datadog is a monitoring and analytics platform that allows you to keep an eye on all aspects of your cloud estate. Aiven has integrations that make it easy to include an Aiven service in your Datadog dashboards.

​
Integration types

Aiven supports two types of Datadog integrations:
  • Datadog Metrics - Send service metrics directly to Datadog
  • Datadog Logs - Forward service logs via Rsyslog integration

​
Datadog metrics integration

​
Prerequisites

  • A Datadog account
  • A Datadog API key
  • A running Aiven service

​
Add Datadog integration endpoint

You can use the Datadog integration endpoint for multiple services.
1

Access integration endpoints

In your Aiven project, click Integration endpoints.
2

Select Datadog

Select Datadog and then Create new or Add new endpoint.
3

Configure endpoint

Enter the following details:
  • Endpoint name - Reference name for this integration
  • API key - Your Datadog API key
  • Site - Your Datadog site (shown in your Datadog website URL)
  • Custom tags - (Optional) Add custom tags to send with metrics
4

Save endpoint

Click Add endpoint to save the configuration.

​
Enable metrics integration on a service

1

Open service integrations

In your service, click Integrations.
2

Select Datadog Metrics

In the Endpoint integrations section, select Datadog Metrics.
3

Choose endpoint

Select your Datadog integration endpoint and click Enable.
4

View metrics in Datadog

Metrics data will appear on your Datadog dashboard.
For Aiven for Apache Kafka services, you can customize the metrics sent to Datadog.

​
Custom tags

The Datadog integration supports adding tags to your metrics data:
  • Global tags - Apply to all metrics from all services using the endpoint
  • Per-service tags - Apply only to metrics from specific services
Tags enable better filtering, grouping, and analysis in Datadog dashboards.

​
Datadog logs integration

The Rsyslog integration is used to send service logs to Datadog.

​
Prerequisites

  • A Datadog API key
  • A running Aiven service

​
Add Syslog integration endpoint for Datadog

1

Access integration endpoints

In your Aiven project, click Integration endpoints.
2

Select Syslog

Select Syslog and then Create new or Add new endpoint.
3

Configure endpoint name

Enter a descriptive Endpoint name for this Datadog logs integration.
4

Configure server

Set the Server based on your Datadog region:
  • US region: intake.logs.datadoghq.com
  • EU region: tcp-intake.logs.datadoghq.eu
5

Configure port

Set the Port based on your Datadog region:
  • US region: 10516
  • EU region: 443
6

Enable TLS

Enable TLS for secure log transmission.
7

Set format to custom

Set the Format to custom.
8

Configure log template

In the Log Template field, enter:
DATADOG_API_KEY <%pri%>1 %timestamp:::date-rfc3339% %HOSTNAME%.AIVEN_PROJECT_NAME %app-name% - - - %msg%
Replace:
  • DATADOG_API_KEY - Your Datadog API key
  • AIVEN_PROJECT_NAME - Your Aiven project name
Datadog correlates metrics and logs by hostname. The integration appends the project name to the hostname to disambiguate between services with the same name in different projects. Without the project name, no log data is lost.
Don’t edit the values surrounded by %, such as %msg%, as these are used in constructing the log line.Example:
01234567890123456789abcdefabcdef <%pri%>1 %timestamp:::date-rfc3339% %HOSTNAME%.example-project %app-name% - - - %msg%
9

Save endpoint

Click Create to save the endpoint.

​
Enable logs integration on a service

1

Open service integrations

In your service, click Integrations.
2

Select Rsyslog

In the Endpoint integrations section, select Rsyslog.
3

Choose endpoint

Select the integration endpoint you created and click Enable.
4

View logs in Datadog

Logs will appear in your Datadog Logs dashboard.

​
Regional configuration

Datadog operates in multiple regions with different endpoints:
RegionMetrics SiteLogs ServerLogs Port
USdatadoghq.comintake.logs.datadoghq.com10516
EUdatadoghq.eutcp-intake.logs.datadoghq.eu443
US3us3.datadoghq.com--
US5us5.datadoghq.com--
AP1ap1.datadoghq.com--
Refer to the Datadog site documentation to determine your region.

​
Troubleshooting

​
Metrics not appearing

  • Verify your Datadog API key is correct and active
  • Confirm the Datadog site matches your account region
  • Check that the integration is enabled on your service
  • Allow a few minutes for initial data to appear

​
Logs not streaming

  • Ensure TLS is enabled in the Rsyslog configuration
  • Verify the server and port match your Datadog region
  • Confirm the log template includes your Datadog API key
  • Check that the Rsyslog integration is enabled on your service

​
Hostname correlation issues

  • Include the project name in the hostname for proper correlation
  • Verify custom tags are configured correctly
  • Check that service names are unique or properly tagged

Build docs developers (and LLMs) love

Get started for freeTalk to us