datadog-trace-agent

README

Datadog APM agent

An agent that collects traces from various sources, normalizes and pre-processes them before sending the info to the Datadog backend.

Run on Linux

The Trace Agent is packaged with the standard Datadog Agent. Just run the Datadog Agent.

Note: the Trace Agent is not yet included in the installation from source of the Trace Agent. Follow the instructions in Development to do it manually.

Run on OSX

The APM agent (aka Trace Agent) isn't part of the OSX Datadog Agent yet, it needs to be run manually on the side.

• Have the OSX Datadog Agent.

• Download the latest OSX Trace Agent release.

• Run the Trace Agent using the Datadog Agent configuration.

  ./trace-agent-osx-X.Y.Z -ddconfig /opt/datadog-agent/etc/datadog.conf

• The Trace Agent should now be running in foreground, with an initial output similar to:

2017-04-24 13:46:35 INFO (main.go:166) - using configuration from /opt/datadog-agent/etc/datadog.conf
2017-04-24 13:46:36 INFO (agent.go:200) - Failed to parse hostname from dd-agent config
2017-04-24 13:46:36 DEBUG (agent.go:288) - No aggregator configuration, using defaults
2017-04-24 13:46:36 INFO (main.go:220) - trace-agent running on host My-MacBook-Pro.local
2017-04-24 13:46:36 INFO (receiver.go:137) - listening for traces at http://localhost:8126

Run on Windows

• Have the Windows Datadog Agent.

• Download the latest Windows Trace Agent release.

• Run the Trace Agent using the Datadog Agent configuration.

  ./trace-agent-windows-X.Y.Z.exe -ddconfig "%ProgramData%\Datadog\datadog.conf"

Development

Pre-requisites:

• go 1.7+
• rake

Build and run from source:

• Import dependencies with rake restore. This task uses glide to import all dependencies listed in glide.yaml in the vendor directory with the right version.
• Run rake build to build the trace-agent binary from current source
• Or run rake install to install trace-agent to your $GOPATH
• You can then run it with trace-agent --ddconfig PATH_TO_YOUR_DATADOG_CONFIG_FILE

Testing

• Lint with rake lint
• Run the full CI suite locally with rake ci
• Alternatively test individual packages like so go test ./agent

Contributing

See our contributing guidelines

More detailed information about agent configuration, terminology and architecture can be found in our wiki