How to build standalone agent binaries¶

Building agent binaries¶

The Core Agent is built using the dda inv agent.build command.

dda inv agent.build --build-exclude=systemd

Running this command will:

Discard any changes done in bin/agent/dist.
Build the Agent and write the binary to bin/agent/agent, with a .exe extension on Windows.
Copy files from dev/dist to bin/agent/dist.

Caveat

If you built an older version of the Agent and are encountering the error make: *** No targets specified and no makefile found, remove the rtloader/CMakeCache.txt file.

Other Agent binaries

Other agent binaries are built using dda inv <target>.build commands. Some examples are:

dda inv dogstatsd.build
dda inv otel-agent.build
dda inv system-probe.build
dda inv trace-agent.build

You can find the full list of buildable agent-related binaries here.

Including or excluding Agent features¶

Different features of the Agent can be included / excluded at build time, by leveraging Go build constraints. This can be done by passing the --build-include or --build-exclude flags to the build commands. A (non-exhaustive) list of available features can be found here.

The set of features enabled by default (i.e. with no flag) depends on the build context: which binary you are trying to build, which flavor of the agent, which platform you are building on etc.

Info

If you want to replicate the same configuration of the Agent as the one distributed in system packages, you need to use this default set of features - so no flag needs to be passed.

Determining the default set of features

The default set of features is determined by the get_default_build_tags method.

There is a command you can use to print out the default build tags for your build context:

dda inv print-default-build-tags

You can give more info about your build context using the -b, -f and -p flags:

dda inv print-default-build-tags -b otel-agent -p windows
> otlp,zlib,zstd
dda inv print-default-build-tags -f fips
> bundle_installer,consul,datadog.no_waf,ec2,etcd,fargateprocess,goexperiment.systemcrypto,grpcnotrace,jmx,kubeapiserver,kubelet,ncm,oracle,orchestrator,otlp,python,requirefips,trivy_no_javadb,zk,zlib,zstd

Run dda inv print-default-build-tags --help for more details.

Example

To include the zstd, etcd and python features:

dda inv <target>.build --build-include=zstd,etcd,python

To exclude some features that would otherwise be enabled:

dda inv <target>.build --build-exclude=systemd,python

Running agents¶

You can run the Core Agent directly in the foreground with the following command.

./bin/agent/agent run -c bin/agent/dist/datadog.yaml

Note

The file bin/agent/dist/datadog.yaml is copied from dev/dist/datadog.yaml by dda inv agent.build and must contain a valid API key. If this did not already exist, you can create a file at any path and reference that with the -c flag instead.