Datadog
Last updated 2023-05-05
Events Feed
Our Datadog event integration creates an event when IP addresses are flagged on Signal Sciences.
Adding a Datadog integration
- Log in to Datadog.
- Click Integrations in the navigation bar on the left. The integrations menu page appears.
- Click the APIs tab. The integrations API menu page appears.
- Click Create API Key button. The new API key menu appears.
- Create a new API key by following the steps.
- Copy the provided API Key.
- Log in to the Signal Sciences console.
- From the Sites menu, select a site if you have more than one site.
- From the Manage menu, select Site Integrations. The site integrations menu page appears.
- Click Add site integration. The add site integration menu page appears.
- Select the Datadog Alert integration. The Datadog Alert integration setup page appears.
- In the API Key field, enter the API Key created in Datadog.
- Select if you want to be alerted regarding All activity or Specific activity.
- If you selected Specific activity, use the Activity menu to choose which types of activities you want the integration to create alerts for.
- Click Create site integration.
Activity types
Activity type | Description |
---|---|
flag | An IP address 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:
Find and install the Signal Sciences integration tile in Datadog integrations tab.
Confirm that the Datadog agent is configured to listen for StatsD events: https://docs.datadoghq.com/developers/dogstatsd/
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 assigsci.agent.signal.<SIGNAL_TYPE>
will be sent assigsci.agent.signal
and tagged withsignal_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.
Configure the SigSci 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>"Verify that the Signal Sciences - Overview dashboard is created and starting to capture metrics.
Do not use this form to send sensitive information. If you need assistance, contact support. This form is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.