6.0.0
Docker, Windows, Linux, Mac OSX
Download links
Prelude
The Datadog Agent 6.0 release is a complete rewrite of Agent 5 written in the Go language with the goal of improving performance, reducing resource utilization, and allowing for check concurrency. Python based checks and plugins will continue to be supported by 6.x without need for modification. While this is a major release, backwards compatibility was a strong focus, and in most cases this should be a simple upgrade process.
Highlights from this release include:
- Increased throughput for DogstatsD metrics.
- Live Process Monitoring support for Windows
- Support for the upcoming Datadog Log Management offering.
- Beta support for global distributions and percentiles for custom metrics.
- Native support for ingestion of metrics via the prometheus exposition format.
- Windows and OSX now have a configuration UI to simplify local check and agent configuration management.
Other Features and Improvements
- The Agent can find relevant listeners on its host by using the "auto" listener, for now only docker is supported. More information can be found here
- APM / Process / Log agents can be enabled/disabled via the DD_*_ENABLED environment variables, see the agent docker image readme for details
- short_image tag has been added the to Docker tagger collector
- Make the number of workers used by the forwarder configurable and set default to 1.
- The agent now has internal healthchecks on all subsystems. The result is exposed via the agent health command and used in the docker image as a healthcheck. The /probe.sh wrapper is provided for compatibility with agent5 and future-proofing.
- Add jmx_custom_jars option to make sure they are loaded by jmxfetch
Docker_daemon
is now a core agent check nameddocker
.Kubernetes
Integration has been replaced by a few Integrations. See here for more information.- Support tagging on Nomad 0.6.0+ clusters
- Support for additional metrics and metadata from kubernetes API server, as well as the addition of a new Control Plane status check.
- Kubernetes events now include additional formatting for improved readability as Datadog events.
- APM now utilizes
apm_non_local_traffic = true
to listen on the network - Docker image: APM is now disabled by default, you need to set
DD_APM_ENABLED=true
to run the trace agent. - Agent now comes bundled with a Web GUI that listens by default on (configurable) port 5002. Only available on localhost, more information about this can be found here
- Added a windows systray icon. System tray icon includes menu options for starting/stopping/restarting services, creating a flare, and launching the browser-based configuration GUI.
Upgrade Notes
- Full upgrade instructions can be found here.
- Custom checks (located by default on Linux in /etc/datadog-agent/checks.d/) now have a lower precedence than the checks that are bundled with the Agent. This means that a custom check with the same name as a bundled check will now be ignored, and the bundled check will be loaded instead. If you want to override a bundled check with a custom check, please use a new name for your custom check, and use that new name for the related yaml configuration file.
- Tags in the DD_TAGS environment variable are now separated by spaces instead of commas in agent5
- Process and Trace Agents can be enabled in datadog.yaml by using
apm_config:
enabled:true
process_config:
enabled:true
- The Windows Agent no longer has an application GUI and has been moved to a Web based GUI accompanied by a systray icon that can be used to handle core functionality of the Agent.
- The Agent’s configuration file has been changed from datadog.conf to datadog.yaml An example of the available options can be seen here
- Datadog no longer offers an Alpine based container image. RHEL and Debian based images are available on Docker Hub and in the Docker Store. Images now use the S6 light init system to start and manage agent processes.
- APM now listens to localhost only by default, you need to set apm_config.apm_non_local_traffic = true to enable listening on the network
Deprecation Notes
- For breaking changes between Agent 5 and this Agent, please see our deprecations and changes page
Major items include:
- Agent configuration is no longer in datadog.conf, and has moved to datadog.yaml. The datadog-agent import command will migrate your configuration files to the new form.
- The execution of the main agent, trace-agent (APM), and process-agent is now orchestrated using systemd/upstart facilities on Linux. SysV-init scripts are no longer included.
- Modification of the installed checks directory (default on Linux was
/opt/datadog-agent/checks.d/
has been removed and changed to an embedded wheels format. More information about this can be found here - Some libraries that custom checks may rely on have been removed. Please see here for a list of the removed dependencies.
- Custom Emitters are no longer supported as of 6.0
Deprecated Agent Integrations
- The Jenkins Integration has been deprecated and removed in favor of a Jenkins Plugin instead
- The standalone Mesos Integration has been retired, in favor of the newer mesos_master and mesos_slave integrations..
- The standalone HDFS Integration has been retired and removed, please use hdfs_namenode and hdfs_datanode instead.