search close

Datadog

access_time Updated Sep 21, 2021

Events Feed

Our Datadog event integration creates an event when IPs are flagged on Signal Sciences.

Adding a Datadog integration

  1. Within Datadog, go to Integrations then APIs.
  2. Press the Create API Key button and follow directions.
  3. Copy the provided API Key.
  4. On Signal Sciences, go to Site Manage > Site Integrations.
  5. Click Add site integration and select the Datadog Alert integration.
  6. Enter the API Key in the API key field.
  7. Click Add.

Activity types

Activity type Description
flag An IP was flagged
agentAlert An agent alert was triggered

Dashboard

Datadog has a default dashboard which is populated with StatsD metrics from the Signal Sciences 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: https://docs.datadoghq.com/developers/dogstatsd/

  3. Configure the Signal Sciences 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>.

      • Example:
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 SigSci agent to send metrics to the Datadog agent:

    • Add 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.