Consul agent metricset

The agent metricset fetches information from a Hashicorp Consul agent in Client mode. It fetches information about the health of the autopilot, runtime metrics, and raft data.

• agent.autopilot.healthy: Tracks the overall health of the local server cluster. If all servers are considered healthy by Autopilot, this will be set to 1. If any are unhealthy, this will be 0.
• agent.raft.apply: This metric gives the number of logs committed since the last interval.
• agent.raft.commit_time.ms: This tracks the average time in milliseconds it takes to commit a new entry to the transaction log of the leader
• agent.runtime.alloc.bytes: This measures the number of bytes allocated by the Consul process.
• agent.runtime.garbage_collector.pause.current.ns: Garbage collector pause time in nanoseconds
• agent.runtime.garbage_collector.pause.total.ns: Number of nanoseconds consumed by stop-the-world garbage collection pauses since Consul started.
• agent.runtime.garbage_collector.runs: Garbage collector total executions
• agent.runtime.goroutines: Number of running goroutines and is a general load pressure indicator. This may burst from time to time but should return to a steady state value.
• agent.runtime.heap_objects: This measures the number of objects allocated on the heap and is a general memory pressure indicator. This may burst from time to time but should return to a steady state value.
• agent.runtime.malloc_count: Heap objects allocated
• agent.runtime.sys.bytes: Total number of bytes of memory obtained from the OS.

This is a default metricset. If the host module is unconfigured, this metricset is enabled by default.

For a description of each field in the metricset, see the exported fields section.

Here is an example document generated by this metricset:

{
    "@timestamp": "2017-10-12T08:05:34.853Z",
    "agent": {
        "hostname": "host.example.com",
        "name": "host.example.com"
    },
    "consul": {
        "agent": {
            "autopilot": {
                "healthy": true
            },
            "raft": {
                "commit_time": {
                    "ms": 0.04560700058937073
                }
            },
            "runtime": {
                "alloc": {
                    "bytes": 6900784
                },
                "garbage_collector": {
                    "pause": {
                        "total": {
                            "ns": 99490250
                        }
                    },
                    "runs": 287
                },
                "goroutines": 77,
                "heap_objects": 42590,
                "malloc_count": 7087169,
                "sys": {
                    "bytes": 74119416
                }
            }
        }
    },
    "event": {
        "dataset": "consul.agent",
        "duration": 115000,
        "module": "consul"
    },
    "metricset": {
        "name": "agent"
    },
    "service": {
        "address": "localhost:8500",
        "type": "consul"
    }
}