# Datadog
# Overview
Datadog node by Kumologica integrates seamlessly with Datadog (opens new window) APM cloud infrastructure. Enabling to send the application log events from Kumologica flow to Datadog logs. This node allows to set the following :
- service name
- message
- log level
# Setup
# Prerequisites
For Datadog node to work properly, you need to have a valid subscription of Datadog cloud instance running and available to access over https. Ensure to have an API key (opens new window) token generated for the node to connect with a given instance of Datadog.
# Installation
To install the node from designer:
- Go to Add more nodes option on the palette section.
- Check for the Datadog node and click install.
- Once installed, the designer is required to be restarted.
To install the node from CLI:
- Go to your project workspace where you can see your
package.json
file. - Run the below give npm command.
npm i @kumologica/kumologica-contrib-datadog
# Technical Details
Properties
- Host (Required)
Hostname of the Datadog cloud instance to connect - Service Name (Required)
Name of the service to which logs are associated. This helps in filtering the logs based on your service name. - API key (Required)
API token (opens new window) key for authenticating with the Datadog cloud platform. - Log level (Optional)
Log level to be set for the log event. Supports Info, Debug, Error, Warn and Silly. - Message (Optional)
Log message to be sent.
The loglevel of the Datadog node in a Kumologica flow can be switched using environment variable DD_LOG_LEVEL
.
eg: DD_LOG_LEVEL=debug
.
Supported Operations
Logs [Send logs (opens new window)]
Throws
Datadog node throws the following exception.
- Datadog Client Failed
Returns
The payload or variable will not be overwritten or enriched by this node.
# Develop a Service
Video tutorial
# Instructions
Drag a drop an EventListener node from the palette to the canvas. Open the settings, configure the following and Save.
Display Name : POST /order Event Source : Amazon API gateway Verb : GET URL : /order
Add the Datadog node to the canvas. Open the settings, provide the following configuration and click Save.
Display Name : Log_Entry Host : Hostname of you Datadog cloud instance Service Name : SampleDataDogService Message : {"data": "Testdata"} Log level : Root token from your Vault server API Key : API token created from your Datadog instance
Wire the EventListener node to the Datadog Node.
Add EventListener End node from the palette to the canvas. Open the settings, configure the following and Save.
Payload : msg.payload
Wire the Datadog node to the EventListener End node.