Agent Metrics
New announcements from Dash: Incident Management, Continuous Profiler, and more! New announcements from Dash!

Agent Metrics

Agent Check Agent Check

Supported OS: Linux Mac OS Windows

Overview

Get metrics from the Agent Metrics service in real time to:

  • Visualize and monitor agent_metrics states.
  • Be notified about agent_metrics failovers and events.

NOTE: The Agent Metrics check has been rewritten in Go for Agent v6 to take advantage of the new internal architecture. Hence it is still maintained but only works with Agents prior to major version 6.

To collect Agent metrics for Agent v6+, use the Go-expvar check with the agent_stats.yaml configuration file packaged with the Agent.

Setup

Installation

The Agent Metrics check is included in the Datadog Agent package, so you don’t need to install anything else on your servers.

Configuration

  1. Edit the agent_metrics.d/conf.yaml file, in the conf.d/ folder at the root of your Agent’s configuration directory, to point to your server and port, set the masters to monitor. See the sample agent_metrics.d/conf.yaml for all available configuration options.

  2. Restart the Agent.

Validation

Run the Agent’s status subcommand and look for agent_metrics under the Checks section.

Data Collected

All data collected are only available for Agent v5.

Metrics

datadog.agent.aggregator.checks_metric_sample
(gauge)
datadog.agent.aggregator.dogstatsd_metric_sample
(gauge)
datadog.agent.aggregator.event
(gauge)
datadog.agent.aggregator.events_flushed
(gauge)
datadog.agent.aggregator.flush.checks_metric_sample_flush_time.last_flush
(gauge)
datadog.agent.aggregator.flush.event_flush_time.last_flush
(gauge)
datadog.agent.aggregator.flush.main_flush_time.last_flush
(gauge)
datadog.agent.aggregator.flush.metric_sketch_flush_time.last_flush
(gauge)
datadog.agent.aggregator.flush.service_check_flush_time.last_flush
(gauge)
datadog.agent.aggregator.flush_count.events.last_flush
(gauge)
datadog.agent.aggregator.flush_count.series.last_flush
(gauge)
datadog.agent.aggregator.flush_count.service_checks.last_flush
(gauge)
datadog.agent.aggregator.flush_count.sketches.last_flush
(gauge)
datadog.agent.aggregator.hostname_update
(gauge)
datadog.agent.aggregator.number_of_flush
(gauge)
datadog.agent.aggregator.series_flushed
(gauge)
datadog.agent.aggregator.service_check
(gauge)
datadog.agent.aggregator.service_check_flushed
(gauge)
datadog.agent.aggregator.check_ready
(gauge)
datadog.agent.collector.cpu.used
(gauge)
datadog.agent.dogstatsd.event_packets
(count)
datadog.agent.dogstatsd.event_parse_errors
(gauge)
datadog.agent.dogstatsd.metric_packets
(count)
datadog.agent.dogstatsd.metric_parse_errors
(gauge)
datadog.agent.dogstatsd_udp.packet_reading_errors
(gauge)
datadog.agent.dogstatsd_upd.packets
(count)
datadog.agent.dogstatsd_uds.origin_detection_errors
(gauge)
datadog.agent.dogstatsd_uds.packet_reading_errors
(gauge)
datadog.agent.emitter.emit.time
(gauge)
datadog.agent.forwarder.transactions.check_runs_v1
(gauge)
datadog.agent.forwarder.transactions.dropped_on_input
(gauge)
datadog.agent.forwarder.transactions.errors
(gauge)
datadog.agent.forwarder.transactions.events
(gauge)
datadog.agent.forwarder.transactions.host_metadata
(gauge)
datadog.agent.forwarder.transactions.intake_v1
(gauge)
datadog.agent.forwarder.transactions.metadata
(gauge)
datadog.agent.forwarder.transactions.retry_queue_size
(gauge)
datadog.agent.forwarder.transactions.series
(gauge)
datadog.agent.forwarder.transactions.service_checks
(gauge)
datadog.agent.forwarder.transactions.success
(gauge)
datadog.agent.forwarder.transactions.timeseries_v1
(gauge)
datadog.agent.logs_agent.destination_errors
(gauge)
datadog.agent.logs_agent.is_running
(gauge)
datadog.agent.logs_agent.logs_decoded
(gauge)
datadog.agent.logs_agent.logs_processed
(gauge)
datadog.agent.logs_agent.logs_sent
(gauge)
datadog.agent.memstats.alloc
(gauge)
datadog.agent.memstats.free
(gauge)
datadog.agent.memstats.heap_alloc
(gauge)
datadog.agent.memstats.heap_idle
(gauge)
datadog.agent.memstats.heap_insue
(gauge)
datadog.agent.memstats.heap_objects
(gauge)
datadog.agent.memstats.heap_released
(gauge)
datadog.agent.memstats.heap_sys
(gauge)
datadog.agent.memstats.lookups
(gauge)
datadog.agent.memstats.mallocs
(gauge)
datadog.agent.memstats.num_gc
(gauge)
datadog.agent.memstats.pause_ns.95percentile
(gauge)
datadog.agent.memstats.pause_ns.avg
(rate)
datadog.agent.memstats.pause_ns.count
(gauge)
datadog.agent.memstats.pause_ns.max
(gauge)
datadog.agent.memstats.pause_ns.median
(gauge)
datadog.agent.memstats.pause_total_ns
(gauge)
datadog.agent.memstats.total_alloc
(gauge)
datadog.agent.python.version
(gauge)
datadog.agent.running
(gauge)
datadog.agent.scheduler.checks_entered
(gauge)
datadog.agent.scheduler.queues_count
(gauge)
datadog.agent.splitter.not_too_big
(gauge)
datadog.agent.splitter.payload_drops
(gauge)
datadog.agent.splitter.too_big
(gauge)
datadog.agent.splitter.total_loops
(gauge)
datadog.agent.started
(count)

Events

The Agent Metrics check does not include any events.

Service Checks

The Agent Metrics check does not include any service checks.

Troubleshooting

Need help? Contact Datadog support.