etcd integration metrics

The official Datadog integration for monitoring etcd. It collects 196 metrics.

Definitions as of 2026-09-02

Official summary

Track writes, updates, deletes, inter-node latencies, and more Etcd metrics.

Metric types

gauge (value at a point in time): 146
count (occurrences in the interval): 50

Metrics

Descriptions are the official definitions, unedited.

Metric	Type	Unit
`etcd.cluster.version`Which version is the etcd cluster is running. 1 for each version identified in the labels	gauge	item
`etcd.debugging.auth.revision`The current revision of auth store	gauge	item
`etcd.debugging.disk.backend.commit.rebalance.duration.seconds.count`The latency distributions of commit.rebalance called by bboltdb backend	gauge	second
`etcd.debugging.disk.backend.commit.rebalance.duration.seconds.sum`The latency distributions of commit.rebalance called by bboltdb backend	gauge	second
`etcd.debugging.disk.backend.commit.spill.duration.seconds.count`The latency distributions of commit.spill called by bboltdb backend	gauge	second
`etcd.debugging.disk.backend.commit.spill.duration.seconds.sum`The latency distributions of commit.spill called by bboltdb backend	gauge	second
`etcd.debugging.disk.backend.commit.write.duration.seconds.count`The latency distributions of commit.write called by bboltdb backend	gauge	second
`etcd.debugging.disk.backend.commit.write.duration.seconds.sum`The latency distributions of commit.write called by bboltdb backend	gauge	second
`etcd.debugging.lease.granted.total`The total number of granted leases	count	item
`etcd.debugging.lease.renewed.total`The number of renewed leases seen by the leader	count	item
`etcd.debugging.lease.revoked.total`The total number of revoked leases	count	item
`etcd.debugging.lease.ttl.total.count`Bucketed histogram of lease TTLs	gauge	item
`etcd.debugging.lease.ttl.total.sum`Bucketed histogram of lease TTLs	gauge	item
`etcd.debugging.mvcc.compact.revision`The revision of the last compaction in store	gauge	item
`etcd.debugging.mvcc.current.revision`The current revision of the store	gauge	item
`etcd.debugging.mvcc.db.compaction.keys.total`Total number of db keys compacted.	count	key
`etcd.debugging.mvcc.db.compaction.last`The unix time of the last db compaction. Resets to 0 on start	gauge	second
`etcd.debugging.mvcc.db.compaction.pause.duration.milliseconds.count`Bucketed histogram of db compaction pause duration.	gauge	millisecond
`etcd.debugging.mvcc.db.compaction.pause.duration.milliseconds.sum`Bucketed histogram of db compaction pause duration.	gauge	millisecond
`etcd.debugging.mvcc.db.compaction.total.duration.milliseconds.count`Bucketed histogram of db compaction total duration.	gauge	millisecond
`etcd.debugging.mvcc.db.compaction.total.duration.milliseconds.sum`Bucketed histogram of db compaction total duration.	gauge	millisecond
`etcd.debugging.mvcc.db.total.size.in_bytes`Total size of the underlying database in bytes.	gauge	byte
`etcd.debugging.mvcc.delete.total`Total number of deletes seen by this member.	count	query
`etcd.debugging.mvcc.events.total`Total number of events sent by this member.	count	event
`etcd.debugging.mvcc.index.compaction.pause.duration.milliseconds.count`Bucketed histogram of index compaction pause duration.	gauge	millisecond
`etcd.debugging.mvcc.index.compaction.pause.duration.milliseconds.sum`Bucketed histogram of index compaction pause duration.	gauge	millisecond
`etcd.debugging.mvcc.keys.total`Total number of keys.	gauge	key
`etcd.debugging.mvcc.pending.events.total`Total number of pending events to be sent.	gauge	event
`etcd.debugging.mvcc.put.total`Total number of puts seen by this member.	count	query
`etcd.debugging.mvcc.range.total`Total number of ranges seen by this member.	count	query
`etcd.debugging.mvcc.slow_watcher.total`Total number of unsynced slow watchers.	gauge	connection
`etcd.debugging.mvcc.total.put.size.in_bytes`The total size of put kv pairs seen by this member	gauge	byte
`etcd.debugging.mvcc.txn.total`Total number of txns seen by this member.	count	transaction
`etcd.debugging.mvcc.watch_stream.total`Total number of watch streams.	gauge	connection
`etcd.debugging.mvcc.watcher.total`Total number of watchers.	gauge	connection
`etcd.debugging.server.lease.expired.total`The total number of expired leases.	count	item
`etcd.debugging.snap.save.marshalling.duration.seconds.count`The marshalling cost distributions of save called by snapshot.	gauge	second
`etcd.debugging.snap.save.marshalling.duration.seconds.sum`The marshalling cost distributions of save called by snapshot.	gauge	second
`etcd.debugging.snap.save.total.duration.seconds.count`The total latency distributions of save called by snapshot.	gauge	second
`etcd.debugging.snap.save.total.duration.seconds.sum`The total latency distributions of save called by snapshot.	gauge	second
`etcd.debugging.store.expires.total`Total number of expired keys.	count	key
`etcd.debugging.store.reads.total`Total number of reads action by (get/getRecursive), local to this member.	count	read
`etcd.debugging.store.watch.requests.total`Total number of incoming watch requests (new or reestablished).	count	request
`etcd.debugging.store.watchers`Count of currently active watchers.	gauge	connection
`etcd.debugging.store.writes.total`Total number of writes (e.g. set/compareAndDelete) seen by this member.	count	write
`etcd.disk.backend.commit.duration.seconds.count`The latency distributions of commit called by backend.	gauge	second
`etcd.disk.backend.commit.duration.seconds.sum`The latency distributions of commit called by backend.	gauge	second
`etcd.disk.backend.defrag.duration.seconds.count`The latency distribution of backend defragmentation	gauge	second
`etcd.disk.backend.defrag.duration.seconds.sum`The latency distribution of backend defragmentation	gauge	second
`etcd.disk.backend.snapshot.duration.seconds.count`The latency distribution of backend snapshots.	gauge	second
`etcd.disk.backend.snapshot.duration.seconds.sum`The latency distribution of backend snapshots.	gauge	second
`etcd.disk.defrag.inflight`Whether or not defrag is active on the member. 1 means active 0 means not	gauge	check
`etcd.disk.wal.fsync.duration.seconds.count`The count of latency distributions of fsync called by wal.	gauge	second
`etcd.disk.wal.fsync.duration.seconds.sum`The sum of latency distributions of fsync called by wal.	gauge	second
`etcd.disk.wal.write.bytes.total`Total number of bytes written in WAL	gauge	byte
`etcd.disk.wal.write.duration.seconds.count`The latency distributions of write called by WAL	gauge	second
`etcd.disk.wal.write.duration.seconds.sum`The latency distributions of write called by WAL	gauge	second
`etcd.etcd.server.client.requests.total`The total number of client requests per client version	count	request
`etcd.go.gc.duration.seconds.count`A summary of the GC invocation durations.	gauge	second
`etcd.go.gc.duration.seconds.quantile`GC invocation duration quantile.	gauge	second
`etcd.go.gc.duration.seconds.sum`A summary of the GC invocation durations.	gauge	second
`etcd.go.gc.gogc.percent`Heap size target percentage configured by the user otherwise 100	gauge	percent
`etcd.go.gc.gomemlimit.bytes`Go runtime memory limit configured by the user otherwise math.MaxInt64	gauge	byte
`etcd.go.goroutines`Number of goroutines that currently exist.	gauge	thread
`etcd.go.info`Information about the Go environment.	gauge	item
`etcd.go.memstats.alloc.bytes`Number of bytes allocated and still in use.	gauge	byte
`etcd.go.memstats.alloc.bytes.total`Total number of bytes allocated, even if freed.	count	byte
`etcd.go.memstats.buck.hash.sys.bytes`Number of bytes used by the profiling bucket hash table.	gauge	byte
`etcd.go.memstats.frees.total`Total number of frees.	count	occurrence
`etcd.go.memstats.gc.cpu.fraction`The fraction of this program's available CPU time used by the GC since the program started.	gauge	cpu
`etcd.go.memstats.gc.sys.bytes`Number of bytes used for garbage collection system metadata.	gauge	byte
`etcd.go.memstats.heap.alloc.bytes`Number of heap bytes allocated and still in use.	gauge	byte
`etcd.go.memstats.heap.idle.bytes`Number of heap bytes waiting to be used.	gauge	byte
`etcd.go.memstats.heap.inuse.bytes`Number of heap bytes that are in use.	gauge	byte
`etcd.go.memstats.heap.objects`Number of allocated objects.	gauge	item
`etcd.go.memstats.heap.released.bytes`Number of heap bytes released to OS.	gauge	byte
`etcd.go.memstats.heap.sys.bytes`Number of heap bytes obtained from system.	gauge	byte
`etcd.go.memstats.last.gc.time.seconds`Number of seconds since 1970 of last garbage collection.	gauge	second
`etcd.go.memstats.lookups.total`Total number of pointer lookups.	count	occurrence
`etcd.go.memstats.mallocs.total`Total number of mallocs.	count	occurrence
`etcd.go.memstats.mcache.inuse.bytes`Number of bytes in use by mcache structures.	gauge	byte
`etcd.go.memstats.mcache.sys.bytes`Number of bytes used for mcache structures obtained from system.	gauge	byte
`etcd.go.memstats.mspan.inuse.bytes`Number of bytes in use by mspan structures.	gauge	byte
`etcd.go.memstats.mspan.sys.bytes`Number of bytes used for mspan structures obtained from system.	gauge	byte
`etcd.go.memstats.next.gc.bytes`Number of heap bytes when next garbage collection will take place.	gauge	byte
`etcd.go.memstats.other.sys.bytes`Number of bytes used for other system allocations.	gauge	byte
`etcd.go.memstats.stack.inuse.bytes`Number of bytes in use by the stack allocator.	gauge	byte
`etcd.go.memstats.stack.sys.bytes`Number of bytes obtained from system for stack allocator.	gauge	byte
`etcd.go.memstats.sys.bytes`Number of bytes obtained from system.	gauge	byte
`etcd.go.sched.gomaxprocs.threads`The current runtime.GOMAXPROCS setting or the number of operating system threads that can execute user-level Go code simultaneously	gauge	thread
`etcd.go.threads`Number of OS threads created.	gauge	thread
`etcd.grpc.proxy.cache.hits.total`Total number of cache hits	gauge	occurrence
`etcd.grpc.proxy.cache.keys.total`Total number of keys/ranges cached	gauge	item
`etcd.grpc.proxy.cache.misses.total`Total number of cache misses	gauge	occurrence
`etcd.grpc.proxy.events.coalescing.total`Total number of events coalescing	count	event
`etcd.grpc.proxy.watchers.coalescing.total`Total number of current watchers coalescing	gauge	connection
`etcd.grpc.server.handled.total`Total number of RPCs completed on the server, regardless of success or failure.	count	operation
`etcd.grpc.server.msg.received.total`Total number of RPC stream messages received on the server.	count	operation
`etcd.grpc.server.msg.sent.total`Total number of gRPC stream messages sent by the server.	count	operation
`etcd.grpc.server.started.total`Total number of RPCs started on the server.	count	operation
`etcd.leader.counts.fail`Rate of failed Raft RPC requests (ETCD API V2 only)	gauge	request/second
`etcd.leader.counts.success`Rate of successful Raft RPC requests (ETCD API V2 only)	gauge	request/second
`etcd.leader.latency.avg`Average latency to each peer in the cluster (ETCD API V2 only)	gauge	millisecond
`etcd.leader.latency.current`Current latency to each peer in the cluster (ETCD API V2 only)	gauge	millisecond
`etcd.leader.latency.max`Maximum latency to each peer in the cluster (ETCD API V2 only)	gauge	millisecond
`etcd.leader.latency.min`Minimum latency to each peer in the cluster (ETCD API V2 only)	gauge	millisecond
`etcd.leader.latency.stddev`Standard deviation latency to each peer in the cluster (ETCD API V2 only)	gauge	millisecond
`etcd.mvcc.db.total.size.in_use.bytes`Total size of the underlying database logically in use	gauge	byte
`etcd.network.active_peers`The current number of active peer connections	gauge	connection
`etcd.network.client.grpc.received.bytes.total`The total number of bytes received from grpc clients.	count	byte
`etcd.network.client.grpc.sent.bytes.total`The total number of bytes sent to grpc clients.	count	byte
`etcd.network.disconnected_peers.total`The total number of disconnected peers	count	connection
`etcd.network.known_peers`The current number of known peer connections	gauge	connection
`etcd.network.peer.received.bytes.total`The total number of bytes received from peers.	count	byte
`etcd.network.peer.received.failures.total`The total number of receive failures from peers	count	event
`etcd.network.peer.round_trip_time.seconds`Round-Trip-Time histogram between peers.	gauge	second
`etcd.network.peer.sent.bytes.total`The total number of bytes sent to peers.	count	byte
`etcd.network.peer.sent.failures.total`The total number of send failures from peers	count	event
`etcd.network.snapshot.receive.failures.total`Total number of snapshot receive failures	count	event
`etcd.network.snapshot.receive.inflights.total`Total number of inflight snapshot sends	gauge	event
`etcd.network.snapshot.receive.success.total`Total number of successful snapshot receives	count	event
`etcd.network.snapshot.receive.total.duration.seconds.count`Total latency distributions of v3 snapshot receives	gauge	second
`etcd.network.snapshot.receive.total.duration.seconds.sum`Total latency distributions of v3 snapshot receives	gauge	second
`etcd.network.snapshot.send.failures.total`The total number of send failures from peers	count	event
`etcd.network.snapshot.send.inflights.total`Total number of inflight snapshot receives	gauge	event
`etcd.network.snapshot.send.sucess.total`Total number of successful snapshot sends	count	event
`etcd.network.snapshot.send.total.duration.seconds.count`Total latency distributions of v3 snapshot sends	gauge	second
`etcd.network.snapshot.send.total.duration.seconds.sum`Total latency distributions of v3 snapshot sends	gauge	second
`etcd.os.fd.limit`The file descriptor limit	gauge	object
`etcd.os.fd.used`The number of used file descriptors	gauge	object
`etcd.process.cpu.seconds.total`Total user and system CPU time spent in seconds.	count	cpu
`etcd.process.max.fds`Maximum number of open file descriptors.	gauge	item
`etcd.process.network.receive_bytes.total`Number of bytes received by the process over the network	count	byte
`etcd.process.network.transmit_bytes.total`Number of bytes sent by the process over the network	count	byte
`etcd.process.open.fds`Number of open file descriptors.	gauge	item
`etcd.process.resident.memory.bytes`Resident memory size in bytes.	gauge	byte
`etcd.process.start.time.seconds`Start time of the process since unix epoch in seconds.	gauge	second
`etcd.process.virtual.memory.bytes`Virtual memory size in bytes.	gauge	byte
`etcd.process.virtual.memory.max_bytes`Maximum amount of virtual memory available in bytes	gauge	byte
`etcd.self.recv.appendrequest.count`Rate of append requests this node has processed (ETCD API V2 only)	gauge	request/second
`etcd.self.recv.bandwidthrate`Rate of bytes received (ETCD API V2 only)	gauge	byte/second
`etcd.self.recv.pkgrate`Rate of packets received (ETCD API V2 only)	gauge	packet/second
`etcd.self.send.appendrequest.count`Rate of append requests this node has sent (ETCD API V2 only)	gauge	request/second
`etcd.self.send.bandwidthrate`Rate of bytes sent (ETCD API V2 only)	gauge	byte/second
`etcd.self.send.pkgrate`Rate of packets sent (ETCD API V2 only)	gauge	packet/second
`etcd.server.apply.duration.seconds.count`Apply request latency	gauge	request/second
`etcd.server.apply.duration.seconds.sum`Apply request latency	gauge	request/second
`etcd.server.apply.slow.total`The total number of slow apply requests (likely overloaded from slow disk)	count	request
`etcd.server.feature_enabled`Feature flags enabled	gauge	check
`etcd.server.go_version`Which Go version server is running with. 1 with label with current version	gauge	unit
`etcd.server.has_leader`Whether or not a leader exists. 1 is existence, 0 is not.	gauge	check
`etcd.server.health.failures.total`The total number of failed health checks	count	event
`etcd.server.health.success.total`The total number of successful health checks	count	event
`etcd.server.healthcheck`Health check result	gauge	check
`etcd.server.healthchecks.total`Total health checks	count	event
`etcd.server.heartbeat.send.failures.total`The total number of leader heartbeat send failures (likely overloaded from slow disk)	count	event
`etcd.server.id`The server member ID	gauge	item
`etcd.server.is_leader`Whether or not this member is a leader. 1 if is, 0 otherwise.	gauge	check
`etcd.server.is_learner`Whether this node is a learner	gauge	check
`etcd.server.leader.changes.seen.total`The number of leader changes seen.	count	event
`etcd.server.learner.promote_failures`Learner promotion failures	count	event
`etcd.server.learner.promote_successes`Learner promotion successes	count	event
`etcd.server.lease.expired.total`The total number of expired leases	count	occurrence
`etcd.server.proposals.applied.total`The total number of consensus proposals applied.	gauge	occurrence
`etcd.server.proposals.committed.total`The total number of consensus proposals committed.	gauge	occurrence
`etcd.server.proposals.failed.total`The total number of failed proposals seen.	count	occurrence
`etcd.server.proposals.pending`The current number of pending proposals to commit.	gauge	occurrence
`etcd.server.quota.backend.bytes`Current backend storage quota size in bytes	gauge	byte
`etcd.server.range.duration.seconds.count`Range request latency	gauge	request/second
`etcd.server.range.duration.seconds.sum`Range request latency	gauge	request/second
`etcd.server.read_indexes.failed.total`The total number of failed read indexes seen	count	event
`etcd.server.read_indexes.slow.total`The total number of pending read indexes not in sync with leader or timed out read index requests	count	event
`etcd.server.snapshot.apply.in_progress.total`Snapshots being applied	gauge	event
`etcd.server.version`Which version is running. 1 for 'server_version' label with current version.	gauge	item
`etcd.snap.db.fsync.duration.seconds.count`The latency distributions of fsyncing .snap.db file	gauge	second
`etcd.snap.db.fsync.duration.seconds.sum`The latency distributions of fsyncing .snap.db file	gauge	second
`etcd.snap.db.save.total.duration.seconds.count`The total latency distributions of v3 snapshot save	gauge	second
`etcd.snap.db.save.total.duration.seconds.sum`The total latency distributions of v3 snapshot save	gauge	second
`etcd.snap.fsync.duration.seconds.count`The latency distributions of fsync called by snap	gauge	second
`etcd.snap.fsync.duration.seconds.sum`The latency distributions of fsync called by snap	gauge	second
`etcd.store.compareanddelete.fail`Rate of compare and delete requests failure (ETCD API V2 only)	gauge	request/second
`etcd.store.compareanddelete.success`Rate of compare and delete requests success (ETCD API V2 only)	gauge	request/second
`etcd.store.compareandswap.fail`Rate of compare and swap requests failure (ETCD API V2 only)	gauge	request/second
`etcd.store.compareandswap.success`Rate of compare and swap requests success (ETCD API V2 only)	gauge	request/second
`etcd.store.create.fail`Rate of failed create requests (ETCD API V2 only)	gauge	request/second
`etcd.store.create.success`Rate of successful create requests (ETCD API V2 only)	gauge	request/second
`etcd.store.delete.fail`Rate of failed delete requests (ETCD API V2 only)	gauge	request/second
`etcd.store.delete.success`Rate of successful delete requests (ETCD API V2 only)	gauge	request/second
`etcd.store.expire.count`Rate of expired keys (ETCD API V2 only)	gauge	eviction/second
`etcd.store.gets.fail`Rate of failed get requests (ETCD API V2 only)	gauge	request/second
`etcd.store.gets.success`Rate of successful get requests (ETCD API V2 only)	gauge	request/second
`etcd.store.sets.fail`Rate of failed set requests (ETCD API V2 only)	gauge	request/second
`etcd.store.sets.success`Rate of successful set requests (ETCD API V2 only)	gauge	request/second
`etcd.store.update.fail`Rate of failed update requests (ETCD API V2 only)	gauge	request/second
`etcd.store.update.success`Rate of successful update requests (ETCD API V2 only)	gauge	request/second
`etcd.store.watchers`Rate of watchers (ETCD API V2 only)	gauge	-

Official documentation

Official documentation for the etcd integration

Metric names and descriptions are the official Datadog integration definitions (Copyright Datadog, Inc., BSD-3-Clause), reproduced unedited. The full license terms are on the About page.

Official summary

Metric types

Metrics

Official documentation

Related products

Other Configuration & Deployment integrations