Datadog Agent

This feature is currently in early access mode. Please contact your Mezmo rep to gain direct access.

Description

The Datadog Agent is an open source agent that runs on a host to collect logs and metrics. This agent can be run locally per host, within Docker, or within Kubernetes. The Datadog Agent Source within Mezmo Pipeline is designed to receive data directly from the Agent via HTTPS. Mezmo can receive metrics individually, logs individually, or both simultaneously.

As part of the Mezmo Platform onboarding flow, you can choose to set up a Pipeline specifically to reduce the log volume, and cost, associated with a DataDog Agent. During the onboarding flow process, set up your Datadog Agent, and Datadog Metrics and Datadog Logs Destinations, then follow the instructions to finish setting up your Pipeline.

Requirements

The running agent version must be [ >= 6.35 or >= 7.35 ]

Mezmo Pipeline Configuration

Adding a Datadog Agent source to a Pipeline is similar to adding a standard HTTP source. Add a source and choose Datadog Agent, optionally enter a Title and Description, then click Save.

Edit the node configuration:

Under Access Key Management

  • Click the Create new key button
  • Enter a title
  • Choose the access key type as User Defined
  • Enter your Datadog API key
  • Click the Create button

Note the instructions with the overrides for DD_LOGS_CONFIG_LOGS_DD_URL and DD_DD_URL. These will be used directly in the Datadog Agent configuration.

Finish configuring the pipeline as desired and deploy.

Datadog Agent Configuration

OptionDescription
DD_API_KEYThe Datadog api key the agent is running with.
DD_DD_URL(optional) The custom Mezmo pipeline url to forward Datadog metrics to.
DD_LOGS_CONFIG_LOGS_DD_URL(optional) The custom Mezmo pipeline url to forward Datadog collected logs to.
DD_LOGS_ENABLEDSet this configuration to true to allow the agent to collect logs.

Examples

Datadog has provided detailed descriptions and various examples of agent configurations for the various systems:

Running the Datadog Agent via Docker:

Example pipeline publishing both logs and metrics to Mezmo:

Bash
Copy

Note that DD_LOGS_CONFIG_LOGS_DD_URL override does not contain httpsas the protocol is already assumed by the agent.

Running the local datadog agent

https://docs.datadoghq.com/agent/guide/agent-configuration-files/?tab=agentv6v7

Example pipeline publishing both logs and metrics to Mezmo:

YAML
Copy
Type to search, ESC to discard
Type to search, ESC to discard
Type to search, ESC to discard
  Last updated