DataDog/datadog-trace-agent

Name: datadog-trace-agent

Owner: Datadog, Inc.

Description: Datadog APM agent.

Created: 2015-07-01 15:45:17.0

Updated: 2018-05-22 14:56:31.0

Pushed: 2018-05-24 16:45:40.0

Homepage: http://www.datadog.com

Size: 5408

Language: Go

GitHub Committers

UserMost Recent Commit# Commits

Other Committers

UserEmailMost Recent Commit# Commits

README

Datadog APM agent

CircleCI

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.

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

On Windows, the trace agent is shipped together with the Datadog Agent only since version 5.19.0, so users must update to 5.19.0 or above. However the Windows trace agent is in beta and some manual steps are required.

Update your config file to include:

n]
enabled: yes
ce.config]
file = C:\ProgramData\Datadog\logs\trace-agent.log

Restart the datadogagent service:

stop datadogagent
start datadogagent

For this beta the trace agent status and logs are not displayed in the Agent Manager GUI.

To see the trace agent status either use the Service tab of the Task Manager or run:

xe query datadog-trace-agent

And check that the status is “running”.

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.

Development

First, make sure Go 1.9+ is installed. You can do this by following the steps on the official website.

Then, download (or update) the latest source by running:

et -u github.com/DataDog/datadog-trace-agent/...

Navigate to the download location and install the trace-agent binary in $GOPATH/bin:

GOPATH/src/github.com/DataDog/datadog-trace-agent
 install

You may now run the agent using trace-agent --config /etc/dd-agent/datadog.conf, considering that $GOPATH/bin has been added to your $PATH.

Testing
Contributing

See our contributing guidelines

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


This work is supported by the National Institutes of Health's National Center for Advancing Translational Sciences, Grant Number U24TR002306. This work is solely the responsibility of the creators and does not necessarily represent the official views of the National Institutes of Health.