Pro plan from £5 per endpoint per month · see pricing
Secronyx
In the next releaseLinuxWindowsmacOS

etcd

See which etcd members are down or unhealthy, whether the database has hit its quota, who leads and how far raft has got, through a login that needs no permission on any key. This plugin is in the next Secronyx release; the current download does not include it yet.

What it answers

Questions an on-call engineer asks, which an AI client can answer with this plugin.

  • Is every member of the etcd cluster healthy, and why is one not?
  • Has the database reached its quota, so that writes fail with an alarm?
  • Which member is the leader, and are elections repeating?
  • How large is the database, and how much of it is in use?
  • Which members does the cluster have, and is one still a learner?

What it returns

Each of the plugin's read-only tools, described in words.

  • Health of every etcd member the cluster lists - healthy or not, how long the check took, and the error, such as an unreachable member or an active NOSPACE or CORRUPT alarm
  • Status of the local etcd member - version, its member ID and the leader's, raft term and index, database size and size in use against the quota, learner state and errors
  • Members of the etcd cluster with their ID, name, peer and client URLs and whether each is a learner, including members that are down
  • Active etcd alarms, each with the member that raised it and its type - 1 is NOSPACE (the database reached its quota, so writes fail) and 2 is CORRUPT

At a glance

Plugin
etcd 1.0.0
Publisher
levantar
Platforms
Linux, Windows, macOS

Tested on

  • etcd 3.5.35, 3.6.16 and 3.7.3 on Linux (Ubuntu 24.04, official releases), test lab and CI runner
  • etcd 3.7.3 on macOS 15 (Homebrew, Intel), test lab; Homebrew etcd on macOS (arm64), CI runner
  • etcd 3.6.16 on Windows Server 2022 (official release), test lab and CI runner

How it logs in

Without an explicit choice, install tries the methods that need no secret first, in this order.

  • A client certificate
  • A user name and password
  • No login (a local endpoint)

The least-privilege login

The setup file in the pack. secronyx plugin setup etcd prints it; an administrator applies it by hand.

#!/bin/sh # The least-privilege login for the etcd plugin. Run it once against any # member (users are cluster-wide) as root, with {{user}} and {{password}} # replaced, and root's login in ETCDCTL_USER (root:<password>) or, with # client certificates, ETCDCTL_CERT and ETCDCTL_KEY. The new password goes # on stdin, so it is not on the command line. # # The plugin reads endpoint status and health, the member list and the # alarms, which etcd allows any authenticated user. The role grants no key # permissions at all: the plugin never reads a key, and in Kubernetes the # keys include every Secret. A role with write or readwrite permissions, # or the root role, makes the privilege check refuse the login. etcdctl role add secronyx-monitor printf '%s\n' '{{password}}' | etcdctl user add '{{user}}' --interactive=false etcdctl user grant-role '{{user}}' secronyx-monitor # With client certificates instead (--client-cert-auth on every member): # a user named after the certificate's common name, with no password. # etcdctl user add '<certificate CN>' --no-password # etcdctl user grant-role '<certificate CN>' secronyx-monitor

See it run

Terminal recording from the test lab: etcd-linux-install
A real run on the shared test lab.
Terminal recording from the test lab: etcd-linux-setup
A real run on the shared test lab.
Terminal recording from the test lab: etcd-linux-test
A real run on the shared test lab.

Read-only, in layers

Every command is a binary on the agent's allowlist with one of its exact argument forms. There is no shell, the environment is clean, and it never runs as root or with SYSTEM's privileges.

These controls narrow what the plugin can do; none of them is a guarantee on its own. An administrator can still accept a more powerful login on purpose (audited and shown in status), root or Administrator on the host can replace the agent, and the plugin can read whatever its login can see.