Switch branches/tags
Clone or download
Permalink
Failed to load latest commit information.
.circleci Ship a readsecret helper script in the docker image (#2163) Aug 31, 2018
.github update codeowners for clusteragent packages (#2201) Aug 24, 2018
Dockerfiles use buster-slim for dca image (#2330) Sep 18, 2018
cmd Display a warning in status when too many log tail (#2265) Sep 18, 2018
dev/dist Dev Dist Folder (#413) Jul 28, 2017
docs Update hostname-resolution.md (#2250) Sep 19, 2018
google-marketplace move GCL test files in right dir (#2074) Jul 27, 2018
omnibus [windows] remove addition of windows secretuser for release. To be (#… Sep 5, 2018
pkg-config [Windows] Create user `secretuser`; write the password to the registry ( Aug 10, 2018
pkg [Logs]: Fixed a null pointer exception caused by logs docker launcher ( Sep 19, 2018
releasenotes [Logs]: Fixed a null pointer exception caused by logs docker launcher ( Sep 19, 2018
tasks [lint] Add a basic 3rd-party license linter (#2268) Sep 19, 2018
test Honor ac_exclude / ac_include in autodiscovery (#2302) Sep 10, 2018
.editorconfig Add .editorconfig file (#966) Dec 19, 2017
.gitignore Ship a readsecret helper script in the docker image (#2163) Aug 31, 2018
.gitlab-ci.yml gitlab: use 2xlarge instances for tests and omnibus (#2329) Sep 18, 2018
CHANGELOG.rst [changelog] updating with 6.5.1 changes Sep 17, 2018
CONTRIBUTING.md More github template files (#652) Sep 28, 2017
Gopkg.lock [json] reverts: faster, lighter JSON enconding/decoding (#1966) (#2242) Aug 31, 2018
Gopkg.toml [json] faster, lighter JSON enconding/decoding (#1966) Aug 28, 2018
LICENSE Switch copyright to 2018 (#1008) Jan 4, 2018
LICENSE-3rdparty.csv [lint] Add a basic 3rd-party license linter (#2268) Sep 19, 2018
NOTICE Switch copyright to 2018 (#1008) Jan 4, 2018
README.md Corrected readme run command (#2256) Sep 18, 2018
SUPPORT.md More github template files (#652) Sep 28, 2017
appveyor.yml [invoke/python] pin python development requirements + use pins everyw… Aug 16, 2018
bootstrap.json [dep] bump to 0.5.0 (#2148) Aug 27, 2018
release.json [release][skip ci] adding 6.5.0, removing RCs (#2311) Sep 12, 2018
requirements.txt [lint] Add a basic 3rd-party license linter (#2268) Sep 19, 2018

README.md

Datadog Agent

CircleCI Build status GoDoc Go Report Card

The present repository contains the source code of the Datadog Agent version 6. Please refer to the Agent user documentation for information about differences between Agent 5 and Agent 6. Additionally, we provide a list of prepackaged binaries for an easy install process here

Note: the source code of Datadog Agent 5 is located in the dd-agent repository.

Documentation

The general documentation of the project, including instructions for installation and development, is located under the docs directory of the present repo.

Getting started

To build the Agent you need:

  • Go 1.10.2 or later.
  • Python 2.7 along with development libraries.
  • Python dependencies. You may install these with pip install -r requirements.txt This will also pull in Invoke if not yet installed.

Note: you may want to use a python virtual environment to avoid polluting your system-wide python environment with the agent build/dev dependencies.

Note: You may have previously installed invoke via brew on MacOS, or pip in any other platform. We recommend you use the version pinned in the requirements file for a smooth development/build experience.

Builds and tests are orchestrated with invoke, type invoke --list on a shell to see the available tasks.

To start working on the Agent, you can build the master branch:

  1. checkout the repo: git clone https://github.com/DataDog/datadog-agent.git $GOPATH/src/github.com/DataDog/datadog-agent.
  2. cd into the project folder: cd $GOPATH/src/github.com/DataDog/datadog-agent.
  3. install project's dependencies: invoke deps. Make sure that $GOPATH/bin is in your $PATH otherwise this step might fail.
  4. build the whole project with invoke agent.build --build-exclude=snmp,systemd

Please refer to the Agent Developer Guide for more details.

Run

To start the agent type agent run from the bin/agent folder, it will take care of adjusting paths and run the binary in foreground.

You need to provide a valid API key. You can either use the config file or overwrite it with the environment variable like:

DD_API_KEY=12345678990 ./bin/agent/agent run -c bin/agent/dist/datadog.yaml

Contributing code

You'll find information and help on how to contribute code to this project under the docs/dev directory of the present repo.