From 5fb26f2e8c493084cf95af004279aa354691e1f0 Mon Sep 17 00:00:00 2001 From: Gyu-Ho Lee Date: Mon, 11 Jan 2016 23:14:02 -0800 Subject: [PATCH] Documentation: stats/metrics reset on etcd restart Addressing https://github.com/coreos/etcd/issues/4035. --- Documentation/api.md | 1 + Documentation/metrics.md | 1 + 2 files changed, 2 insertions(+) diff --git a/Documentation/api.md b/Documentation/api.md index 422c3248f..76fda75ab 100644 --- a/Documentation/api.md +++ b/Documentation/api.md @@ -1052,6 +1052,7 @@ curl http://127.0.0.1:2379/v2/stats/self ### Store Statistics The store statistics include information about the operations that this node has handled. +Note that v2 `store Statistics` is stored in-memory. When a member stops, store statistics will reset on restart. Operations that modify the store's state like create, delete, set and update are seen by the entire cluster and the number will increase on all nodes. Operations like get and watch are node local and will only be seen on this node. diff --git a/Documentation/metrics.md b/Documentation/metrics.md index 89a739934..4b6ab2635 100644 --- a/Documentation/metrics.md +++ b/Documentation/metrics.md @@ -3,6 +3,7 @@ **NOTE: The metrics feature is considered experimental. We may add/change/remove metrics without warning in future releases.** etcd uses [Prometheus](http://prometheus.io/) for metrics reporting in the server. The metrics can be used for real-time monitoring and debugging. +etcd only stores these data in memory. If a member restarts, metrics will reset. The simplest way to see the available metrics is to cURL the metrics endpoint `/metrics` of etcd. The format is described [here](http://prometheus.io/docs/instrumenting/exposition_formats/).