Skip to content

Datadog target

Sends events to Datadog.

With tmctl:

tmctl create target datadog --apiKey <apiKey>

On Kubernetes:

Secret

apiVersion: v1
kind: Secret
metadata:
  name: ddapitoken
type: Opaque
stringData:
  apiKey: __API_KEY__

Target

apiVersion: targets.triggermesh.io/v1alpha1
kind: DatadogTarget
metadata:
 name: datadogtarget
spec:
 apiKey:
  secretKeyRef:
    name: ddapitoken
    key: apiKey
 site: datadoghq.eu

site is an optional parameter that lets you specify which Datadog site (aka region) you want to connect to. site defaults to datadoghq.com. Visit Getting Started with Datadog Sites for more information.

Accepts events with the following attributes:

io.triggermesh.datadog.metric: events of this type intend to post a metric to Datadog

io.triggermesh.datadog.event.post: events of this type contain event messages to be published to Datadog.

This type expects a JSON payload with the following properties:

Name Type Comment Required
text string The body of the event. Limited to 4000 characters. The text supports markdown. true
title string The event title. Limited to 100 characters. Use msg_title with the Datadog Ruby library. true
alert_type string If an alert event is enabled, set its type. For example, error, warning, info, success, user_update, recommendation, and snapshot. Allowed enum values: error,warning,info,success,user_update,recommendation,snapshot. false
date_happened int64 POSIX timestamp of the event. Must be sent as an integer (i.e. no quotes). Limited to events no older than 7 days. false
device_name string A device name. false
host string Host name to associate with the event. Any tags associated with the host are also applied to this event. false
id int64 Integer ID of the event. false
priority string The priority of the event. For example, normal or low. Allowed enum values: normal,low. false
related_event_id int64 ID of the parent event. Must be sent as an integer (i.e. no quotes). false
source_type_name string The type of event being posted. Option examples include nagios, hudson, jenkins, my_apps, chef, puppet, git, bitbucket, etc. A complete list of source attribute values available here. false
status string A status. false
tags []string A list of tags to apply to the event. false
url string URL of the event. false

io.triggermesh.datadog.metric.submit: events of this type consist of a singular metric to be published to Datadog.

This type expects a JSON payload with the following properties:

Name Type Comment Required
host string The name of the host that produced the metric. false
interval int64 If the type of the metric is rate or count, define the corresponding interval. false
metric string The name of the timeseries. true
points [][]string Points relating to a metric. All points must be tuples with timestamp and a scalar value (cannot be a string). Timestamps should be in POSIX time in seconds, and cannot be more than ten minutes in the future or more than one hour in the past. true
tags []string A list of tags associated with the metric. false
type string The type of the metric either count, gauge, or rate. false

io.triggermesh.datadog.logs.send events of this type consist log data to be published to Datadog.

This type expects a JSON payload with the following properties:

Name Type Comment Required
ddsource string The integration name associated with your log: the technology from which the log originated. When it matches an integration name, Datadog automatically installs the corresponding parsers and facets. true
ddtags string Tags associated with your logs. false
hostname string The name of the originating host of the log. true
message string The message reserved attribute of your log. By default, Datadog ingests the value of the message attribute as the body of the log entry. That value is then highlighted and displayed in the Logstream, where it is indexed for full text search. true
service string The name of the application or service generating the log events. It is used to switch from Logs to APM, so make sure you define the same value when you use both products. false

You can test the Target by sending it an event using curl.

Example sending an event of type io.triggermesh.datadog.metric.submit

curl -v "http://localhost:8080" \
       -X POST \
       -H "Ce-Id: 536808d3-88be-4077-9d7a-a3f162705f79" \
       -H "Ce-Specversion: 1.0" \
       -H "Ce-Type: io.triggermesh.datadog.metric.submit" \
       -H "Ce-Source: ocimetrics/adapter" \
       -H "Content-Type: application/json" \
       -d '{"series":[{"metric":"five.golang","points":[["1614962026","14.5"]]}]}'

Example sending an event of type io.triggermesh.datadog.event.post

curl -v "http://localhost:8080" \
       -X POST \
       -H "Ce-Id: 536808d3-88be-4077-9d7a-a3f162705f79" \
       -H "Ce-Specversion: 1.0" \
       -H "Ce-Type: io.triggermesh.datadog.event.post" \
       -H "Ce-Source: ocimetrics/adapter" \
       -H "Content-Type: application/json" \
       -d '{"text": "Oh boy2!","title": "Did you hear the news today?"}'

Example sending an event of type io.triggermesh.datadog.logs.send

curl -v "http://localhost:8080" \
       -X POST \
       -H "Ce-Id: 536808d3-88be-4077-9d7a-a3f162705f79" \
       -H "Ce-Specversion: 1.0" \
       -H "Ce-Type: io.triggermesh.datadog.log.send" \
       -H "Ce-Source: ocimetrics/adapter" \
       -H "Content-Type: application/json" \
       -d '{  "ddsource": "nginx", "ddtags": "env:staging,version:5.1", "hostname": "i-012345678", "message": "2019-11-19T14:37:58,995 INFO Hello World", "service": "payment"}'

See the Kubernetes object reference for more details.

Prerequisite(s)

  • Datadog API token