Begin setup in Datadog

Create an API Key in Datadog for Openpath:

Refer to Datadog’s instructions for adding API Keys

Create a Pipeline for Openpath

Refer to Datadog’s instructions for adding a Pipeline

Configure the integration in Openpath

Create rules using the Rules Engine:

1. Go to https://control.openpath.com/login and log in. To access the European Control Center, please go to https://control.eu.openpath.com/login

2. Go to Configurations > Rules and click the plus(+) sign in the top right corner to Add a Rule, enter a name and description for the rule, select a Trigger Type, then select an Event

   1. In this example we want the rule to trigger on Entry Unlock events

3. On the right side of the page, check Use JSON Editor

4. Paste the following JSON, replacing DATADOG API KEY HERE with the API key you created earlier, then click Save

{
  "version": "1.0",
  "trigger": {
    "properties": {
      "event": {
        "enum": [
          "entry.unlocked"
        ]
      }
    }
  },
  "requests": [
    {
      "type": "http",
      "blocking": false,
      "preRequestDelaySeconds": 0,
      "httpParams": {
        "headers": [
          "User-Agent: Openpath/Rules Engine",
          "Content-Type: application/json",
          "DD-API-KEY: PASTE DATADOG API KEY HERE" 
        ],
        "method": "post",
        "url": "https://http-intake.logs.datadoghq.com/api/v2/logs",
        "body": "[{\"ddsource\": \"Openpath Integration\",\"hostname\": \"{{event.data.acuId}}\",\"status\": \"Info\",\"event_type\": \"{{event.event}}\",\"message\": \"{{json event}}\"}]"
      }
    }
  ]
}

Repeat this process for every event you want tracked in Datadog changing the Trigger Type and Event as appropriate.

In the following line:

"body": "[{\"ddsource\": \"Openpath Integration\",\"hostname\": \"{{event.data.acuId}}\",\"status\": \"Info\",\"event_type\": \"{{event.event}}\",\"message\": \"{{json event}}\"}]"

You can change "Info" to "Warn" or "Error" depending on how you want the event represented in Datadog logs.

Once configured, Openpath events will appear in Datadog logs.

Click on an event to view more detail.