Datadog

Datadog monitors your servers, databases, tools, and services, through a SaaS-based data analytics platform.

This guide shows you how to configure and test outbound webhooks for Datadog.

Prerequisite

Configure a webhook to send logs to Datadog

Follow these steps to configure a webhook:

1. On the Webhooks page, click Add Webhook. The Add Webhook page appears.

2. From the Method dropdown menu, select POST.

3. For the URL, enter the following code:

   https://<DATADOG_LOG_COLLECTOR_URL>/api/v2/logs
   

   Replace DATADOG_LOG_COLLECTOR_URL with your Datadog organization location. For example, for the US5 region, enter: https://http-intake.logs.us5.datadoghq.com

   📘

   Specify the HTTPS protocol only. Do not specify any custom ports.

4. In the Body Template field, paste the following JSON body for the webhook payload. Replace LOGS_TAGS with a comma-separated list of tags you want to associate with your logs. For example env:staging,version:5.1.

   JSON

   [
    {
      "ddsource": "apono",
      "ddtags": "<LOGS_TAGS>",
      "hostname": "apono",
      "message": "{ \"event_type\": \"{{ event_type }}\", \"event_time\": \"{{ event_time }}\", \"id\": \"{{ data.id }}\", \"friendly_id\": \"{{ data.friendly_id }}\", \"requester_id\": \"{{ data.requester.id }}\", \"requester_name\": \"{{ data.requester.name }}\", \"requester_email\": \"{{ data.requester.email }}\", \"justification\": \"{{ data.justification }}\", \"creation_date\": \"{{ data.creation_date }}\", \"access_flow_id\": \"{{ data.access_flow.id }}\", \"access_flow_name\": \"{{ data.access_flow.name }}\", \"access_bundle_id\": \"{{ data.access_bundle.id }}\", \"access_bundle_name\": \"{{ data.access_bundle.id }}\", \"access_groups_integration_name\": \"{{ data.access_groups.[0].integration.name }}\", \"access_groups_integration_type\": \"{{ data.access_groups.[0].integration.type }}\"}",
      "alert_type": "info",
      "service": "apono"
    }
   ]
   

5. For Headers, enter the following authorization headers. Replace the placeholder values with the API key and key ID that you created in Datadog.

   Header 1	Key: DD-API-KEY Value: <API KEY>
   Header 2	Key: DD-APPLICATION-KEY Value: <KEY ID>

6. From the Triggers dropdown menu, select one or more of the following event triggers, which correspond to Apono access request statuses:

   • Created
   • Approved
   • Rejected
   • Granted
   • Expired
   • Failed

7. Enter a unique, alphanumeric, user-friendly Name for identifying this webhook.

8. Toggle the webhook’s Status to Active, which means that the webhook can be triggered immediately.

9. Click Test to generate a test event to trigger your webhook. A Success or Failure response status will appear at the bottom of the page.

   📘

   If your test succeeds, Apono sends a test log with mock data to your Datadog instance. If your test fails, troubleshoot your webhook.

10. Click Save Webhook.

The new webhook appears in the Webhooks table. The webhook will be preceded by a green dot if it is active or a white dot if it is inactive.

You can now send logs to Datadog triggered by Apono access request events.