Table of Contents

• How-to
  • Config minimally
• Reference
  • Setup
  • Management
  • Host Naming
  • Tags
  • Metrics
• Topics

How-to

Config minimally

[Main]
dd_url: https://app.datadoghq.com
api_key: <api-key>
hostname: nightly00-all-000-k
tags:
  - role:couchbase
  - cluster:yeonghoey

tags: ["role:couchbase", "cluster:yeonghoey"]

Reference

Setup

DD_API_KEY=<your-api-key> bash -c "$(curl -L https://raw.githubusercontent.com/DataDog/dd-agent/master/packaging/datadog-agent/source/install_agent.sh)"

# Just install without DD_API_KEY
DD_API_KEY=x DD_INSTALL_ONLY=true bash -c "$(curl -L https://raw.githubusercontent.com/DataDog/dd-agent/master/packaging/datadog-agent/source/install_agent.sh)"

Management

sudo /etc/init.d/datadog-agent start
sudo /etc/init.d/datadog-agent stop
sudo /etc/init.d/datadog-agent restart
sudo /etc/init.d/datadog-agent status
sudo /etc/init.d/datadog-agent info
sudo /etc/init.d/datadog-agent info -v
sudo /etc/init.d/datadog-agent check [integration]
sudo /etc/init.d/datadog-agent check [integration] check_rate

# Configs
/etc/dd-agent/datadog.conf  # Agent
/etc/dd-agent/conf.d/       # Integrations

# Logs
/var/log/datadog/supervisord.log (since 3.8.0)
/var/log/datadog/collector.log
/var/log/datadog/dogstatsd.log
/var/log/datadog/forwarder.log

Host Naming

• Datadog uniquely identify hosts by hostname
• Host name cadidates (order of priority)
  1. agent-hostname: If a host name is explicitly set in the Agent configuration file.
  2. hostname: If the DNS host name is not an EC2 default (e.g. ip-192-0-0-1).
  3. instance-id: If the Agent can reach the EC2 metadata endpoint from the host.
  4. hostname: Fall back on the DNS host name even if it is an EC2 default.
• By documentation, with default configuration, my instance should have hostname, but always I got instance-id.

ec2-hostname: ip-10-42-134-4.ap-northeast-1.compute.internal
local-ipv4: 10.42.134.4
socket-hostname: yeonghoey-cb-001
hostname: i-0ccfeb8b6dc2ce863
local-hostname: ip-10-42-134-4.ap-northeast-1.compute.internal
instance-id: i-0ccfeb8b6dc2ce863
socket-fqdn: localhost

• They say there is alias for other names, but it seems useless. Every graph features shows hostname only.
• So, just always put hostname in /etc/dd-agent/datadog.conf

hostname: mymachine.mydomain

Tags

• Tags can be both only name values or key:value pairs.
• Tags under integrations only takes effect integrations dashboard

tags:
  - firsttag
  - secondtag
  - thirdtagregion:east

tags:
  - region:nw
  - application:database
  - database:primary
  - role:sobotka

Metrics

Topics