You can integrate Ternary with Datadog to ingest metrics, powering such features as the Reporting Engine's Unit Economics.

Prerequisites

• Follow our API Authentication guide to get an Access Token or Ternary API Key.

Please provide the following for Ternary to begin interacting with Datadog's programmatic API.

1. Datadog API Key - follow these instructions to create a Datadog API Key; the required key string for this onboarding should be a 32-character hex value (not to be confused with the key ID).
2. Datadog Application Key - follow these instructions to create a Datadog Application Key;
3. The required key string for this onboarding should be a 40-character hex string.
4. Example Metric(s) - choose at least one metric from your Datadog account, along with Tag Keys for grouping, and any filters to be applied prior to ingestion.

Create a Datadog Integration

curl  
-H "Authorization: Bearer ${TERNARY_ACCESS_TOKEN}"  
-X POST  
"<https://api.ternary.app/v1/tenants/${TENANT_ID}/integrations/datadog">  
-d '  
{  
  "name": "<MY-INTEGRATION-DISPLAY-NAME>",  
  "datadog": {  
    "apiKey": "<MY-API-KEY>",  
    "appKey": "<MY-APP-KEY>",  
    "metrics": {  
      "<MY-METRIC-1>": {  
        "displayName": "\<OPTIONAL:MY-METRIC-DISPLAY-NAME-1>",  
        "filter": "\<OPTIONAL:MY-GROUPING-TAG-KEY-1>",  
        "groupings": [  
          "<OPTIONAL:MY-GROUPING-TAG-KEY-1>"  
        ]  
      },  
      "<MY-METRIC-2>": {  
        "displayName": "\<MY-METRIC-DISPLAY-NAME-2",  
        "filter": "\<OPTIONAL:MY-METRIC-FILTER-2>",  
        "groupings": [  
          "<OPTIONAL:MY-GROUPING-TAG-KEY-2>"  
        ]  
      }  
    }  
  }  
}  
'

Update a Datadog Integration

To update a Datadog Integration, it is easiest to first fetch the integration by API, then make your changes, and submit the updated JSON document through an HTTP PUT request.

curl  
-H "Authorization: Bearer ${TERNARY_ACCESS_TOKEN}"  
-X PUT  
"<https://api.ternary.app/v1/tenants/${TENANT_ID}/integrations/datadog/${DATADOG_INTEGRATION_ID}">  
-d '<MY-UPDATED-JSON-DOCUMENT>'

FAQ

1. What are metric groupings?
   Metric groupings are Datadog Tag Keys which are used to disaggregate data into multiple time series. For example, for a metric units.sold that supports the tags fruit and material, if both tags are specified as groupings for the Ternary Datadog integration, then a separate time series will be ingested for each of the following tag combinations:
   • fruit:apple,material:nylon
   • fruit:apple,material:steel
   • fruit:mango,material:nylon
   • fruit:mango,material:steel
   • etc.
2. What are metric filters?
   Metric filters let you limit the time series which is ingested to Ternary. In the above example, adding a filter fruit:apple would cause Ternary to only ingest data that has been tagged apple for the key fruit. Learn more about Datadog's advanced filter syntax here.