Skip to main content

Datadog Event Destination

TL;DR

To send ngrok events to Datadog:

  1. Obtain Datadog API key.
  2. Create Event Subscription.
  3. Create Event Destination.

This guide covers how to send ngrok events including network traffic logs into Datadog. Some essential use-cases for ngrok events include providing a history of changes within an account, per request visibility for active monitoring/troubleshooting and security traffic inspection or SIEM usage.

By integrating ngrok with Datadog, you can:

  • Quickly identify application issues in real-time using ngrok request events in conjunction with Datadog ML based monitoring.
  • Historically audit changes occurring within an account. Be able to historically audit changes within an account.
  • Visualize usage of your service by using Datadog queries and analytic charts.
  • Identify security issues by using ngrok events and Datadog SIEM.

Step 1: Obtain Datadog API Key​

For ngrok to successfully send events into Datadog we'll require an API key. To either create or retrieve the API key, reference the following link Datadog API documentation.

Step 2: Create an Event Subscription​

  1. Using a browser, go to the ngrok dashboard and navigate to Events on the left hand navigation and select Create Subscription.

    ngrok event subscription

  2. Within the Event Subscription configuration, provide a description for the event and within the sources tab select Add Source to pick and choose which events you would like to send to Datadog.

Once complete, select Add Event Sources to confirm your selections.

ngrok event sources

Step 3: Create Event Destination​

To send the events to Datadog we'll need to assign an Event Destination to the Event Subscription.

  1. Within the Event Subscription configuration Destination Tab, select Add Destination.

  2. Choose Datadog as the target and fill in the correct information being mindful of which Datadog site your data resides in. Target, Region and API Key values are required, all other values are optional.

    • Service Name will be added as a key-value pair to the event payload as service:value.
    • DD Tags values will be added as tags to the event data being sent to be utilized within Datadog.

ngrok event destination

  1. Once all required inputs have values, select Send Test Event and you should be presented with a Success message. Select Done and the Datadog Event Destination setup is complete.

ngrok event destination success

Tip: If instead of a Success message you receive a 403 error, double-check your API key and validate that you have selected the correct Datadog site.