Skip to content

dd-agent job from datadog-agent/1.1.5170

Datadog Agent

Github source: d63c410a or master branch

Properties

dd

api_key

Datadog API key

bosh_tags

Enable autogenerated bosh tags

Default
true

bosh_tags_prefix

Prefix for autogenerated bosh tags

Default
bosh_

check_timings

The collector will capture a metric for check run times

Default
false

collect_ec2_tags

Collect AWS EC2 custom tags as agent tags (requires an IAM role associated with the instance)

Default
false

collect_security_groups

Incorporate security-groups into tags collected from AWS EC2

Default
false

create_dd_check_tags

Add dd_check:checkname tag per running check

Default
false

custom_emitters

List of emitters to be used in addition to the standard one

Example
- /usr/local/my-code/emitters/rabbitmq.py:RabbitMQEmitter

dogstatsd_port

Statsd listening port

Default
18125

dogstatsd_target

By default dogstatsd will post aggregate metrics to the Agent, but you can define a different endpoint here

dogstreams

List of logs to parse and optionally custom parsers to use

Example
- /path/to/log1:/path/to/my/parsers_module.py:custom_parser
- /path/to/log2

exclude_process_args

Remove the ‘ww’ flag from ps catching the arguments of processes

Default
false

ganglia_host

Ganglia host where gmetad is running

Default
127.0.0.1

ganglia_port

Ganglia port where gmetad is running

Default
8651

gce_updated_hostname

Use unique hostname for GCE hosts, see http://dtdg.co/1eAynZk

Default
true

generate_disk_config

Generate disk configuration, disk.yaml

Default
true

generate_disk_config_all_partitions

Include all partitions in the system

Default
true

generate_disk_config_tag_by_filesystem

Add tags to mountpoints by filesystem type

Default
true

generate_monit_processes

Add monit processes to process.yaml

Default
true

generate_network_config

Automatically generate network monitoring integration, network.yaml

Default
true

generate_network_config_connection_state

Report metrics including the state of the nics

Default
true

generate_network_config_excluded_interfaces

List of the network interfaces to exclude from reporting metrics

Default
  - lo
  - lo0

generate_ntp_config

Generate NTP monitoring ntp.yaml

Default
true

generate_ntp_config_host

NTP host

Default
0.ubuntu.pool.ntp.org

generate_ntp_config_min_collection_interval

Metrics collection interval

Default
300

generate_ntp_config_offset_threshold

Max offset threshold in seconds

Default
60

generate_processes

Automatically generate process monitoring integration, process.yaml

Default
true

generate_system_processes

Add basic system processes to process.yaml

Default
true

graphite_listen_port

Start a graphite listener on this port

Default
17124

histogram_aggregates

List of histogram aggregates functions

Default
  - max
  - median
  - avg
  - count

histogram_percentiles

List of histogram percentiles

Default
- "0.95"

hostname

Force the hostname to whatever you want. Default is autogenerated

integrations

Agent integration configuration. Each key will have “.yaml” appended to it and the value dumped a file

Default
{}

listen_port

Change port the Agent is listening to

Default
17123

log_level

Logging level

Default
INFO

non_local_traffic

Allow non-local traffic to this Agent, required when using it as a proxy for other agents

Default
false

process_agent_enabled

Enable the (beta) process agent.

Default
false

proxy

Proxy settings to connect to the Internet

Example
host: proxy
password: pass
port: 8080
user: user

skip_ssl_validation

Skip SSL validation for the Datadog url

Default
false

statsd_forward_host

Forward packets received by the dogstatsd server to another statsd server

statsd_forward_port

Forward packets received by the dogstatsd server to another statsd server port

Default
8125

statsd_metric_namespace

Define a namespace for statsd metrics, metric.name will instead become namespace.metric.name

tags

List of tags which will be applied to the data sent from this agent

Default
[]

url

The host of the Datadog intake server to send Agent data to

Default
https://app.datadoghq.com

use_dogstatsd

Should the dogstatsd agent be started for statsd metrics collection

Default
false

use_ganglia

Enable Ganglia support for collecting metrics

Default
false

use_graphite

Enable a graphite endpoint

Default
false

use_jmxfetch

Should the jmxfetch agent be started

Default
false

use_uuid_hostname

By default we use a friendly hostname, this might cause problems with some setups. Set this to use the UUID instead. (In an environment where there are multiple hosts of the same type on different deployments or in different foundries, this will be necessary.) If dd.hostname is set, it will take precedence over the uuid hostname.

utf8_decoding

Dogstatsd supports plain ASCII packets, this enables support for UTF8 metric names

Default
false

Templates

Templates are rendered and placed onto corresponding instances during the deployment process. This job's templates will be placed into /var/vcap/jobs/dd-agent/ directory (learn more).

  • bin/collector_ctl (from bin/collector_ctl)
  • bin/dogstatsd_ctl (from bin/dogstatsd_ctl)
  • bin/forwarder_ctl (from bin/forwarder_ctl)
  • bin/jmxfetch_ctl (from bin/jmxfetch_ctl)
  • bin/pre-start (from bin/pre-start)
  • bin/process_agent_ctl (from bin/process_agent_ctl)
  • config/confd.sh (from config/confd.sh.erb)
  • config/datadog.conf (from config/datadog.conf.erb)
  • data/properties.sh (from data/properties.sh.erb)

Packages

Packages are compiled and placed onto corresponding instances during the deployment process. Packages will be placed into /var/vcap/packages/ directory.