Datadog¶
You can set up Wallarm to send notifications of detected events directly to the Datadog Logs service by creating an appropriate integration via Datadog API key in Wallarm Console.
You can choose the following events to be sent to Datadog:
-
Hits detected except for:
- Experimental hits detected based on the custom regular expression. Non-experimental hits trigger notifications.
- Hits not saved in the sample.
-
System related:
- User changes (newly created, deleted, role change)
- Integration changes (disabled, deleted)
- Application changes (newly created, deleted, name change)
-
Vulnerabilities detected, all by default or only for the selected risk level(s):
- High risk
- Medium risk
- Low risk
-
Rules and triggers changed (creating, updating, or deleting the rule or trigger)
-
Scope (exposed assets) changed: updates in hosts, services, and domains
-
On an hourly basis, you can get a notification with the number of requests processed during the previous hour
Setting up integration¶
-
Open the Datadog UI → Organization Settings → API Keys and generate the API key for the integration with Wallarm.
-
Open Wallarm Console → Integrations and proceed to the Datadog integration setup.
-
Enter an integration name.
-
Paste the Datadog API key to the API key field.
-
Select the Datadog region.
-
Choose event types to trigger notifications. If the events are not chosen, then notifications will not be sent.
-
Test the integration and make sure the settings are correct.
-
Click Add integration.
Testing integration¶
Integration testing allows checking configuration correctness, availability of the Wallarm Cloud, and the notification format. To test the integration, you can use the button Test integration when creating or editing the integration.
The integration is tested as follows:
-
Test notifications with the prefix
[Test message]
are sent to the selected system. -
Test notifications cover the following events (each in a single record):
- New user in the company account
- Newly detected hit
- Newly discovered IP in the company scope
- New trigger in the company account
- Newly discovered security vulnerability
-
Test notifications include test data.
The test Datadog log:
To find the Wallarm logs among other records, you can use the source:wallarm_cloud
search tag in the Datadog Logs service.
Updating integration¶
To update the settings of active integration:
-
Open an active integration.
-
Make required changes and click Save.
Disabling integration¶
To stop sending reports and notifications temporarily, you can disable the integration:
-
Open an active integration and click Disable.
To re-enable sending reports and notifications, open the disabled integration and click Enable.
Disabling the integration is the system event. If you receive system notifications, messages about disabled integration will be sent to the configured system.
Deleting integration¶
To stop sending reports and notifications permanently, you can delete the integration. Deleting an integration cannot be undone. The integration will be removed from the list permanently.
-
Open integration and click Delete.
-
Confirm the action.
Deleting the integration is the system event. If you receive system notifications, messages about deleted integration will be sent to the configured system.