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.
- You have Docker installed (if not, get it here)
- You have a DataDog account (not your company issued account, create a personal one at DataDog)
- You have an API key on your DataDog account (get it here)
If you have met all of the prerequisites, great! Let's get to the fun stuff.
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.
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)
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
.