datadog-statsd

Package Information

Released: 6/9/2025
Downloads: 17 weekly / 469 monthly
Latest Version: 0.1.0
Author: jinto-narvar

Available Nodes

Example Node
Basic Example Node
HttpBin icon
HttpBin
Interact with HttpBin API
DataDog icon
DataDog
Send metrics, logs and events to DataDog using StatsD protocol

Documentation

n8n Nodes - DataDog StatsD Integration

npm version

This is an n8n community node that integrates DataDog with your n8n workflows, enabling you to send metrics, events, and service checks to DataDog using the StatsD protocol directly from your workflow automations.

DataDog is a monitoring and analytics platform for cloud-scale applications, while n8n is a fair-code licensed workflow automation tool that allows you to connect various services.

DataDog Node in n8n

Table of Contents

Installation

To install this community node, please follow the official n8n community node installation guide.

Alternatively, you can install it using npm or yarn if you are managing your n8n instance manually:

# Using npm
npm install n8n-datadog-statsd

# Or using yarn
yarn add n8n-datadog-statsd

For development purposes, clone the repository and link it to your n8n installation:

git clone https://github.com/your-github-username/n8n-datadog-statsd.git
cd n8n-datadog-statsd
npm install
npm link
# In your n8n project directory
npm link n8n-datadog-statsd

Operations

This node allows you to send data to DataDog via the StatsD protocol. The following operations are supported:

  • Metric: Send various types of metrics.
    • Counter: Increment or decrement a counter.
    • Gauge: Set a value for a gauge.
    • Histogram: Send a value to a histogram to track distributions.
    • Set: Count unique occurrences of a value.
    • Distribution: Send a value to a distribution metric (global percentiles).
  • Event: Send an event to DataDog.
    • Includes options for title, text, date, priority, and alert type.
  • Service Check: Send a service check status.
    • Includes options for check name, status (OK, Warning, Critical, Unknown), and an optional message.

All operations support adding custom tags.

Credentials

To use this node, you need to configure DataDog StatsD credentials in n8n. This involves providing:

  • Host: The hostname or IP address of your DataDog agent (e.g., localhost if running locally).
  • Port: The port your DataDog agent is listening on for StatsD metrics (default is 8125).
  • Prefix (Optional): A prefix to be added to all metrics, events, and service checks sent (e.g., myapp.).
  • Environment (Optional): An environment tag (e.g., production, staging) to be added to all data.
  • Global Tags (Optional): A comma-separated list of tags to be added to all data (e.g., region:us-east-1,team:backend).

Compatibility

  • This node has been tested with n8n version 1.0.0 and above.
  • It is designed to work with DataDog Agent v6 and v7.

Usage

  1. Install the Node: Follow the installation instructions above.
  2. Configure Credentials: In n8n, go to the Credentials section, add new DataDog StatsD credentials, and fill in your DataDog agent details.
  3. Add the DataDog Node: In your n8n workflow, add the DataDog node.
  4. Select Resource: Choose whether you want to send a Metric, Event, or Service Check.
  5. Configure Operation: Based on the selected resource, choose the specific operation (e.g., Counter for Metric).
  6. Fill in Parameters: Provide the necessary details like metric name, value, title, text, tags, etc.
  7. Execute Workflow: Run your workflow to send the data to DataDog.

Example: Sending a Page View Counter

  • Resource: Metric
  • Operation: Counter
  • Metric Name: webapp.page_views
  • Value: 1
  • Tags: page:/home,lang:en

Example: Sending a Deployment Event

  • Resource: Event
  • Title: New Version Deployed
  • Text: Version 2.5.0 deployed to production.
  • Priority: Normal
  • Alert Type: Success
  • Tags: service:api,version:2.5.0

Screenshots

(Consider adding screenshots of the node configuration in n8n and an example metric in DataDog)

Example Node Configuration:
![Node Configuration](path/to/your/screenshot_node_config.png)

Example Metric in DataDog:
![DataDog Metric](path/to/your/screenshot_datadog_metric.png)

Resources

Version History

  • 1.0.0 (June 9, 2025)
    • Initial release.
    • Support for Metrics (Counter, Gauge, Histogram, Set, Distribution).
    • Support for Events.
    • Support for Service Checks.
    • Configurable DataDog agent host, port, prefix, environment, and global tags.

License

MIT

Discussion