Skip to content

Latest commit

 

History

History
92 lines (76 loc) · 3.59 KB

config.md

File metadata and controls

92 lines (76 loc) · 3.59 KB

Configuration Options

This page details the configuration options supported in Agent version 6 or later compared to version 5. If you don't see a configuration option listed here, this might mean:

  • The option is supported as it is, in this case you can find it in the example file
  • The option refers to a feature that's currently under development
  • The option refers to a feature that's scheduled but will come later

Orchestration + Agent Management

Orchestration has now been deferred to OS facilities wherever possible. To this purpose we now rely on upstart/systemd on linux environments and windows services on Windows. Enabling the APM and Process agents bundled with the agent can now be achieved via configuration flags defined in the main configuration file: datadog.yaml.

Process Agent

To enable the process agent add the following to datadog.yaml:

...
process_config:
  enabled: true
...

Trace Agent

To enable the trace agent add the following to datadog.yaml:

...
apm_config:
  enabled: true
...

The OS-level services will be enabled by default for all agents. The agents will process the configuration and decide whether to stay up or gracefully shut down. You may decide to disable the OS-level service units, but that will require your manual intervention if you ever wish to re-enable any of the agents.

New options in version 6

This is the list of configuration options that are either new, renamed or changed in any way.

Old Name New Name Notes
proxy_host proxy Proxy settings are now expressed as a list of URIs like http://user:password@proxyurl:port, one per transport type (see the proxy section of datadog.yaml for more details).
collect_instance_metadata enable_metadata_collection This now enabled the new metadata collection mechanism
collector_log_file log_file
syslog_host syslog_uri The Syslog configuration is now expressed as an URI
syslog_pem Syslog configuration client certificate for TLS client validation
syslog_key Syslog configuration client private key for TLS client validation

Removed options

This is the list of configuration options that were removed in the new Agent beacause either superseded by new options or related to features that works differently from Agent version 5.

Name Notes
proxy_port superseded by proxy
proxy_user superseded by proxy
proxy_password superseded by proxy
proxy_forbid_method_switch obsolete
use_mount deprecated in v5
use_curl_http_client obsolete
exclude_process_args deprecated feature
check_timings superseded by internal stats
dogstatsd_target
dogstreams
custom_emitters
forwarder_log_file superseded by log_file
dogstatsd_log_file superseded by log_file
jmxfetch_log_file superseded by log_file
syslog_port superseded by syslog_uri
check_freq
collect_orchestrator_tags feature now implemented in metadata collectors
utf8_decoding
developer_mode
use_forwarder
autorestart
dogstream_log
use_curl_http_client
gce_updated_hostname v6 behaves like v5 with gce_updated_hostname set to true. May affect reported hostname, see doc
collect_security_groups feature still available with the aws integration