diff --git a/website/source/docs/agent/telemetry.html.md b/website/source/docs/agent/telemetry.html.md index 4028ed9d10..f78ba9118b 100644 --- a/website/source/docs/agent/telemetry.html.md +++ b/website/source/docs/agent/telemetry.html.md @@ -466,6 +466,72 @@ These metrics are used to monitor the health of the Consul servers. ms timer + + `consul.raft.state.follower` + This metric counts the number of times an agent has entered the follower mode. This happens when a new agent joins the cluster or after the end of a leader election. + follower state entered / interval + counter + + + `consul.raft.transistion.heartbeat_timeout` + This metric gives the number of times an agent has transistioned to the Candidate state, after receive no heartbeat messages from the last known leader. + timeouts / interval + counter + + + `consul.raft.restoreUserSnapshot` + This metric measures the time taken by the agent to restore the FSM state from a user's snapshot + ms + timer + + + `consul.raft.rpc.processHeartBeat` + This metric measures the time taken to process a heartbeat request. + ms + timer + + + `consul.raft.rpc.appendEntries` + This metric measures the time taken to process an append entries RPC call from an agent. + ms + timer + + + `consul.raft.rpc.appendEntries.storeLogs` + This metric measures the time taken to add any outstanding logs for an agent, since the last appendEntries was invoked + ms + timer + + + `consul.raft.rpc.appendEntries.processLogs` + This metric measures the time taken to process the outstanding log entries of an agent. + ms + timer + + + + `consul.raft.rpc.requestVote` + This metric measures the time taken to process the request vote RPC call. + ms + timer + + + `consul.raft.rpc.installSnapshot` + This metric measures the time taken to process the installSnapshot RPC call. This metric should only be seen on agents which are currently in the follower state. + ms + timer + + `consul.raft.replication.appendEntries.rpc` + This metric measures the time taken by the append entries RFC, to replicate the log entries of a leader agent onto its follower agent(s) + ms + timer + + + `consul.raft.replication.appendEntries.logs` + This metric measures the number of logs replicated to an agent, to bring it upto speed with the leader's logs. + logs appended/ interval + counter + `consul.raft.leader.lastContact` This will only be emitted by the Raft leader and measures the time since the leader was last able to contact the follower nodes when checking its leader lease. It can be used as a measure for how stable the Raft timing is and how close the leader is to timing out its lease.

The lease timeout is 500 ms times the [`raft_multiplier` configuration](/docs/agent/options.html#raft_multiplier), so this telemetry value should not be getting close to that configured value, otherwise the Raft timing is marginal and might need to be tuned, or more powerful servers might be needed. See the [Server Performance](/docs/guides/performance.html) guide for more details. @@ -754,6 +820,30 @@ These metrics give insight into the health of the cluster as a whole. suspect messages received / interval counter + + `consul.memberlist.tcp.accept` + This metric counts the number of times an agent has accepted an incoming TCP stream connection. + connections accepted / interval + counter + + + `consul.memberlist.udp.sent/received` + This metric measures the total number of bytes sent/received by an agent through the UDP protocol. + bytes sent or bytes received / interval + counter + + + `consul.memberlist.tcp.connect` + This metric counts the number of times an agent has initiated a push/pull sync with an other agent. + push/pull initiated / interval + counter + + + `consul.memberlist.tcp.sent` + This metric measures the total number of bytes sent by an agent through the TCP protocol + bytes sent / interval + counter + `consul.memberlist.gossip` This metric gives the number of gossips (messages) broadcasted to a set of randomly selected nodes.