1. Home
  2. Guides
  3. Next-Gen WAF
  4. Using the Next-Gen WAF
  5. Integrations (alerts)

Datadog

Our Datadog event integration (alert) creates an event when certain Next-Gen WAF activity occurs.

Setting up Datadog integrations (alerts)

To set up a Datadog integration (alert), create a Datadog API key and then add the integration (alert).

Creating Datadog API keys

Before you can set up the Datadog integration (alert), you need to create a Datadog API key:

  1. Log in to Datadog.
  2. Click Integrations in the navigation bar on the left.
  3. Click APIs.
  4. Click Create API Key.
  5. Create a new API key by following the steps.
  6. Copy the provided API Key.

Adding Datadog integrations (alerts)

Once you've created a Datadog API key, you can use that API key to set up the Datadog integration (alert):

  1. Next-Gen WAF control panel
  2. Fastly control panel

  1. Log in to the Next-Gen WAF control panel.

  2. From the Sites menu, select a site if you have more than one site.

  3. From the Manage menu, select Site Integrations.
  4. Click Add site integration.
  5. Select the Datadog Alert integration.
  6. In the API Key field, enter the API Key created in Datadog.
  7. From the Site menu, select your preferred Datadog endpoint.

  8. Select if you want to be alerted regarding All activity or Specific activity. If you selected Specific activity, then in the Activity menu choose the activity types that you want the integration to create alerts for.

  9. Click Create site integration.

Activity types

This section only applies to Next-Gen WAF customers with access to the Next-Gen WAF control panel.

When setting up a Datadog integration (alert) in the Next-Gen WAF control panel, you can select from the following activity types:

Activity typeDescription
flagAn IP address was flagged
agentAlertAn agent alert was triggered

Using the default dashboard in Datadog

Datadog has a default dashboard populated with StatsD metrics from the Next-Gen WAF agent. To use this functionality:

  1. Find and install the Signal Sciences integration tile in Datadog integrations tab.

  2. Confirm that the Datadog agent is configured to listen for StatsD events.

  3. Configure the Next-Gen WAF agent to use dogstatsd:

    • Add the following line to each agent's agent.config file:

      statsd-type = "dogstatsd"

    • When this is done the agent's statsd client will have tagging enabled and metrics such as sigsci.agent.signal.<SIGNAL_TYPE> will be sent as sigsci.agent.signal and tagged with signal_type:<SIGNAL_TYPE> (e.g., sigsci.agent.signal.http404 => sigsci.agent.signal tag signal_type:http404).

    • If using Kubernetes to run the Datadog agent, make sure to enable DogStatsD non local traffic as described in the Kubernetes DogStatsD documentation.

  4. Configure the Next-Gen WAF agent to send metrics to the Datadog agent by adding the following line to each agent's agent.config file:

    $ statsd-address="<DATADOG_AGENT_HOSTNAME>:<DATADOG_AGENT_PORT>"

  5. Verify that the Signal Sciences - Overview dashboard is created and starting to capture metrics.

Related content

Fastly
© Fastly 2025