Enum EventKind 

#[repr(i32)]
pub enum EventKind {
    BackendDown = 0,
    BackendUp = 1,
    NoAvailableBackends = 2,
    RemovedBackendHasNoConnections = 3,
    ClusterAdded = 4,
    ClusterRemoved = 5,
    FrontendAdded = 6,
    FrontendRemoved = 7,
    CertificateAdded = 8,
    CertificateRemoved = 9,
    CertificateReplaced = 10,
    ListenerActivated = 11,
    ListenerDeactivated = 12,
    ConfigurationReloaded = 13,
    WorkerKilled = 14,
    WorkerRelaunched = 15,
    LoggingLevelChanged = 16,
    MetricsConfigured = 17,
    ListenerUpdated = 18,
    StateLoaded = 19,
    StateSaved = 20,
    ListenerAdded = 21,
    ListenerRemoved = 22,
    SozuStopRequested = 23,
    MainUpgraded = 24,
    WorkerUpgraded = 25,
    EventsSubscribed = 26,
    HealthCheckHealthy = 27,
    HealthCheckUnhealthy = 28,
    ClusterRecovered = 29,
    MetricDetailChanged = 30,
}

Variants

BackendDown = 0

BackendUp = 1

NoAvailableBackends = 2

RemovedBackendHasNoConnections = 3

ClusterAdded = 4

Control-plane mutation events (audit trail). Emitted by the main process to clients subscribed via SubscribeEvents. The Event.cluster_id / backend_id / address fields are populated when they are meaningful for the verb (e.g. address for listener verbs, cluster_id for cluster/frontend verbs). Backend events keep their historical numeric tags 0..3.

ClusterRemoved = 5

FrontendAdded = 6

FrontendRemoved = 7

CertificateAdded = 8

CertificateRemoved = 9

CertificateReplaced = 10

ListenerActivated = 11

ListenerDeactivated = 12

ConfigurationReloaded = 13

WorkerKilled = 14

WorkerRelaunched = 15

LoggingLevelChanged = 16

MetricsConfigured = 17

ListenerUpdated = 18

A listener’s configuration was patched in place via UpdateHttp/Https/TcpListenerConfig

StateLoaded = 19

A saved state file was loaded (batch state replay via LoadState request). Emitted once at task completion; target=file:<path> and result=ok|err with the ok/err request counts encoded in target.

StateSaved = 20

A snapshot of the current state was written to disk via SaveState.

ListenerAdded = 21

A new listener was added to the config (AddHttp/Https/TcpListener). Distinct from LISTENER_ACTIVATED (binds the socket) — ADDED just creates the listener’s in-memory definition.

ListenerRemoved = 22

A listener’s in-memory definition was removed (RemoveListener). Distinct from LISTENER_DEACTIVATED (unbinds the socket) — REMOVED drops the whole listener from the state.

SozuStopRequested = 23

A stop request was accepted (SoftStop / HardStop). target=stop:soft or stop:hard — distinguishes drain-then-stop from immediate-abort on the audit trail.

MainUpgraded = 24

The main process started a re-exec upgrade (UpgradeMain).

WorkerUpgraded = 25

A worker was re-launched (UpgradeWorker).

EventsSubscribed = 26

A client subscribed to the SubscribeEvents bus — privileged because subscribers observe every control-plane mutation.

HealthCheckHealthy = 27

Backend health-check transitioned to healthy after consecutive successes. Tags 0..3 are the historical backend-state events; 4..26 carry the control-plane mutation events (cluster, frontend, certificate, listener, worker, configuration, metrics, state, stop, upgrade, events). Backend health-check transitions therefore start at 27.

HealthCheckUnhealthy = 28

Backend health-check transitioned to unhealthy after consecutive failures.

ClusterRecovered = 29

Cluster transitioned from “all backends down” back to “at least one backend available”. Pairs with NoAvailableBackends (tag 2) so dashboards can plot per-cluster recovery.

MetricDetailChanged = 30

The worker’s effective MetricDetail changed because a runtime lease was applied, renewed, expired, or cleared. Pairs with MetricsConfigured (tag 17) but distinct: that one fires for MetricsConfiguration (Enabled/Disabled/Clear), this one fires for cardinality changes.

Emitter scope: operator-initiated transitions emit METRIC_DETAIL_CHANGED via the master-side audit log (see bin/src/command/requests.rs around the SetMetricDetail success path). Worker-local transitions — the polled janitor expiring a lease, or a worker-local clear/apply after a master fan-out — are not yet surfaced because the worker has no direct IPC path to the master’s audit sink; follow-up tracked separately.

Implementations

impl EventKind

pub fn is_valid(value: i32) -> bool

Returns true if value is a variant of EventKind.

pub fn from_i32(value: i32) -> Option<EventKind>

👎Deprecated:

Use the TryFrom<i32> implementation instead

Converts an i32 to a EventKind, or None if value is not a valid variant.

impl EventKind

pub fn as_str_name(&self) -> &'static str

String value of the enum field names used in the ProtoBuf definition.

The values are not transformed in any way and thus are considered stable (if the ProtoBuf definition does not change) and safe for programmatic use.

pub fn from_str_name(value: &str) -> Option<Self>

Creates an enum from field names used in the ProtoBuf definition.

Trait Implementations

impl Clone for EventKind

fn clone(&self) -> EventKind

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for EventKind

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for EventKind

fn default() -> EventKind

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for EventKind

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl From<EventKind> for i32

fn from(value: EventKind) -> i32

Converts to this type from the input type.

impl Hash for EventKind

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl Ord for EventKind

fn cmp(&self, other: &EventKind) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl PartialEq for EventKind

fn eq(&self, other: &EventKind) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialOrd for EventKind

fn partial_cmp(&self, other: &EventKind) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

fn lt(&self, other: &Rhs) -> bool

Tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Rhs) -> bool

Tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Rhs) -> bool

Tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Rhs) -> bool

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl Serialize for EventKind

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl TryFrom<i32> for EventKind

type Error = UnknownEnumValue

The type returned in the event of a conversion error.

fn try_from(value: i32) -> Result<EventKind, UnknownEnumValue>

Performs the conversion.

impl Copy for EventKind

impl Eq for EventKind

impl StructuralPartialEq for EventKind