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