Datadog

Use the Datadog Connector to send data from Decodable to Datadog for downstream analytics. You can use this connector to send data from the Decodable _metrics stream into Datadog in order to monitor the state and health of your Decodable connections and pipelines. For information about the type of metrics that Decodable tracks, see System Events and Metrics.

Overview

Connector name

Datadog

Type

Sink

Delivery Guarantee

at least once

Prerequisites

A Datadog API key. You can generate an API key in Datadog by navigating to the Organization Settings under your account menu, and then choosing API Keys. Select New Key to generate an API Key.

Steps

Follow these steps to send data from Decodable into Datadog. These steps assume that you are using the Decodable web interface. However, if you want to use the Decodable CLI to create the connection, you can refer to the Property Name column for information about what the underlying property names are.

  1. From the Connections page, select the Datadog connector and complete the following fields.

    UI Field Property Name in the Decodable CLI Description

    API Key

    api-key

    The Datadog API key that you generated as part of the prerequisites.

    If you are using the Decodable CLI, this is the ID of a secret resource in your account. Run decodable secret list to view available secrets or decodable secret --help for help with creating a new secret.

    Note: For security purposes, Decodable will never display secret values in plaintext. You can manage which users have permissions to create, delete, or modify secrets in the Access Control management view. See Roles, groups, and permissions for more information.

    Site

    site

    The site that you want to send data to.

    Must be one of the following values:

    • datadoghq.com

    • us3.datadoghq.com

    • us5.datadoghq.com

    • datadoghq.eu

    • ddog-gov.com

    See Getting Started with Datadog Sites in the Datadog documentation for more information about sites.

    Metric Name Column

    metric-name-column

    The field name in the input stream containing the metric name. If you want to send data from the _metrics stream, enter metric_name.

    Metric Value Column

    metric-value-column

    The field name in the input stream containing the metric value. If you want to send data from the _metrics stream, enter metric_value.

    Timestamp Column

    timestamp-column

    The field name in the input stream containing the timestamp. If you want to send data from the _metrics stream, enter timestamp.

    Tag Columns

    tag-columns

    Enter any additional field names that you’d like to include as tags on the metrics. If you want to send data from the _metrics stream, see Metrics for the field names that you can include.

    Static Tags

    static-tags

    Optional. A comma-separated list of static key:value pairs that will be included as tags on the metrics.

    Metric Name Prefix

    metric-name-prefix

    Optional. A prefix to add to the names of your metrics. For example, for the metric records-in-total and a prefix myaccount_, the metric name you would see in Datadog would be myaccount_records-in-total.

  2. Select which stream contains the records that you’d like to send to Datadog. Then, select Next.

  3. Give the newly created connection a Name and Description and select Save.

You can now use this connection to send data from Decodable into Datadog for additional monitoring!