Overview

ETCD is the distributed key-value store that holds all Kubernetes cluster state data.

Why it’s Useful

  • Detects cluster state storage issues.
  • Tracks leader election, read/write latency, and database size.
  • Ensures cluster stability and data consistency.

What Users Can Do

  • Monitor ETCD health, storage, and request latency.
  • Troubleshoot leader election issues.
  • Verify connectivity and certs for secure communication

Steps to Modify Configuration

  1. Get the existing ConfigMap.
    kubectl get cm opsramp-k8s-infra-metric-user-config -n <agent-installed-namespace> -o yaml
  2. Edit the ConfigMap:
    kubectl edit cm opsramp-k8s-infra-metric-user-config -n <agent-installed-namespace>
  3. Locate the etcd section in ConfigMap.
    k8s_cluster:
      enabled: true
      config:
        scrape_interval: "2m"
  4. Update the required parameters.
  5. Save and apply the changes.

Supported Metrics

Metric NameDisplay Name
etcd_bookmarksetcd bookmark counts
etcd_cluster_versionetcd cluster version
etcd_debugging_auth_revisionetcd debugging auth revision
etcd_debugging_disk_backend_commit_rebalance_duration_secondsetcd debugging disk backend commit rebalance duration seconds
etcd_debugging_disk_backend_commit_rebalance_duration_secondsetcd debugging disk backend commit rebalance duration seconds
etcd_debugging_disk_backend_commit_rebalance_duration_secondsetcd debugging disk backend commit rebalance duration seconds
etcd_debugging_disk_backend_commit_spill_duration_secondsetcd debugging disk backend commit spill duration seconds
etcd_debugging_disk_backend_commit_spill_duration_secondsetcd debugging disk backend commit spill duration seconds
etcd_debugging_disk_backend_commit_spill_duration_secondsetcd debugging disk backend commit spill duration seconds
etcd_debugging_disk_backend_commit_write_duration_secondsetcd debugging disk backend commit write duration seconds
etcd_debugging_disk_backend_commit_write_duration_secondsetcd debugging disk backend commit write duration seconds
etcd_debugging_disk_backend_commit_write_duration_secondsetcd debugging disk backend commit write duration seconds
etcd_debugging_lease_grantedetcd debugging lease granted
etcd_debugging_lease_renewedetcd debugging lease renewed
etcd_debugging_lease_revokedetcd debugging lease revoked
etcd_debugging_lease_ttletcd debugging lease ttl
etcd_debugging_lease_ttletcd debugging lease ttl
etcd_debugging_lease_ttletcd debugging lease ttl total
etcd_debugging_mvcc_compact_revisionetcd debugging mvcc compact revision
etcd_debugging_mvcc_current_revisionetcd debugging mvcc current revision
etcd_debugging_mvcc_db_compaction_keysetcd debugging mvcc db compaction keys
etcd_debugging_mvcc_db_compaction_lastetcd debugging mvcc db compaction last
etcd_debugging_mvcc_db_compaction_pause_duration_millisecondsetcd debugging mvcc db compaction pause duration milliseconds
etcd_debugging_mvcc_db_compaction_pause_duration_millisecondsetcd debugging mvcc db compaction pause duration milliseconds
etcd_debugging_mvcc_db_compaction_pause_duration_millisecondsetcd debugging mvcc db compaction pause duration milliseconds
etcd_debugging_mvcc_db_compaction_total_duration_millisecondsetcd debugging mvcc db compaction total duration milliseconds
etcd_debugging_mvcc_db_compaction_total_duration_millisecondsetcd debugging mvcc db compaction total duration milliseconds
etcd_debugging_mvcc_db_compaction_total_duration_millisecondsetcd debugging mvcc db compaction total duration milliseconds
etcd_debugging_mvcc_eventsetcd debugging mvcc events
etcd_debugging_mvcc_index_compaction_pause_duration_millisecondsetcd debugging mvcc index compaction pause duration milliseconds
etcd_debugging_mvcc_index_compaction_pause_duration_millisecondsetcd debugging mvcc index compaction pause duration milliseconds
etcd_debugging_mvcc_index_compaction_pause_duration_millisecondsetcd debugging mvcc index compaction pause duration milliseconds
etcd_debugging_mvcc_keysetcd debugging mvcc keys
etcd_debugging_mvcc_pending_eventsetcd debugging mvcc pending events
etcd_debugging_mvcc_rangeetcd debugging mvcc range
etcd_debugging_mvcc_slow_watcheretcd debugging mvcc slow watcher
etcd_debugging_mvcc_put_size_in_bytesetcd debugging mvcc total put size in bytes
etcd_debugging_mvcc_watch_streametcd debugging mvcc watch stream
etcd_debugging_mvcc_watcheretcd debugging mvcc watcher
etcd_debugging_server_lease_expiredetcd debugging server lease expired
etcd_debugging_snap_save_marshalling_duration_secondsetcd debugging snap save marshalling duration seconds
etcd_debugging_snap_save_marshalling_duration_secondsetcd debugging snap save marshalling duration seconds
etcd_debugging_snap_save_marshalling_duration_secondsetcd debugging snap save marshalling duration seconds
etcd_debugging_snap_save_total_duration_secondsetcd debugging snap save total duration seconds
etcd_debugging_snap_save_total_duration_secondsetcd debugging snap save total duration seconds
etcd_debugging_snap_save_total_duration_secondsetcd debugging snap save total duration seconds
etcd_debugging_store_expiresetcd debugging store expires
etcd_debugging_store_readsetcd debugging store reads
etcd_debugging_store_watch_requestsetcd debugging store watch requests
etcd_debugging_store_watchersetcd debugging store watchers
etcd_debugging_store_writesetcd debugging store writes
etcd_disk_backend_commit_duration_secondsetcd disk backend commit duration seconds
etcd_disk_backend_commit_duration_secondsetcd disk backend commit duration seconds
etcd_disk_backend_commit_duration_secondsetcd disk backend commit duration seconds