bastor / datadog-local-development

Explains how to test your DataDog development locally, and provides a script with which to run a local DataDog Agent using Docker.

Developing locally with DataDog

Synopsis

This README aims to explain how to develop locally with DataDog. Note: using this method you will not run all of DataDog locally. For that you can create a personal account. What you will find here is a read-up on how to host your local DataDog agent, and have your metrics sent to your very own DataDog environment.

Prerequisites

1. You have Docker installed (if not, get it here)
2. You have a DataDog account (not your company issued account, create a personal one at DataDog)
3. You have an API key on your DataDog account (get it here)

Starting out

If you have met all of the prerequisites, great! Let's get to the fun stuff.

Running the Docker container

We are going to want to ramp up a Docker container which hosts the DataDog Agent.

docker run -d --name dd-agent --restart=always -h localdev -v /var/run/docker.sock:/var/run/docker.sock -v /proc/:/host/proc/:ro -v /sys/fs/cgroup/:/host/sys/fs/cgroup:ro -p 8125:8125/udp -e API_KEY=DataDog_API_KEY datadog/docker-dd-agent:latest

Note: in the above command please replace DataDog_API_KEY with your API key.

Stopping and removing the container

When you want to shut the container down and remove it, execute the following commands to stop and remove the container.

docker stop $(docker ps -q --filter name=dd-agent)
docker rm $(docker ps -a -q --filter name=dd-agent)

Notes for Windows 7 users

Make sure to connect to the DataDog Agent using the IP Address of your Docker VM. The default is: 192.168.99.100. For Windows 10 you can probably use localhost.