Struct AuditEvent 

pub struct AuditEvent {

    pub schema_version: u32,
    pub event_id: String,
    pub timestamp: String,
    pub kind: EventKind,
    pub action: String,
    pub summary: String,
    pub actor: Actor,
    pub client: Client,
    pub site: Option<String>,
    pub request: Request,
    pub outcome: Outcome,
    pub dry_run: Option<bool>,
    pub targets: BTreeMap<String, Vec<String>>,
    pub nodes: Vec<String>,
    pub produced: BTreeMap<String, String>,
    pub details: Map<String, Value>,
    pub emitter: Emitter,
}

One audit record. See the module docs for the stability contract.

Fields

schema_version: u32

Always SCHEMA_VERSION.

event_id: String

Random v4 UUID; also the Kafka message key.

timestamp: String

RFC 3339 UTC timestamp (millisecond precision) of emission.

kind: EventKind

What kind of activity this is.

action: String

Stable operation name chosen by the handler, e.g. group.delete; "<METHOD> <route>" when the handler did not name it (e.g. the request was rejected before the handler ran).

summary: String

One human-readable line saying who did what, where, and how it ended — see AuditEvent::describe. Derived from the other fields when the event is emitted; for reading, not for parsing.

actor: Actor

Who did it.

client: Client

From where.

site: Option<String>

Target site (X-Manta-Site), when supplied.

request: Request

The request as received.

outcome: Outcome

How it ended.

dry_run: Option<bool>

true when the caller asked for a dry run (nothing changed), false for a real run of an operation that has a dry-run mode; absent when the operation has none or the handler never ran.

targets: BTreeMap<String, Vec<String>>

Objects the operation acts on, keyed by object kind (group, node, hosts, image, …). Values are as the caller supplied them (a hosts expression is not expanded; see Self::nodes), except where the caller selected by pattern: configuration.delete records the configurations, sessions, templates and images it matched.

nodes: Vec<String>

Concrete node xnames the server resolved the request to, when it expanded a hosts expression or a group itself (power, boot, kernel parameters, runtime configuration, migrate). Power, boot and kernel parameters record it before the operation runs, so it is present on dry runs and failures too; runtime configuration and migrate resolve and apply in one service call, so there it is recorded only once that call succeeds.

produced: BTreeMap<String, String>

What the operation created or started, by kind (transition, session, configuration, image, hostname) — the ids to look the operation up by in the backend. Only on success, never on a dry run.

details: Map<String, Value>

Further operation parameters a handler chose to record (e.g. force, the power action, the kernel parameters).

emitter: Emitter

Which server emitted it.

Implementations

impl AuditEvent

pub fn describe(&self) -> String

One line for humans, built from the structured fields:

rjanalik @ alps: power off nid001288 (1 node, force) → success, transition 4c1e…
alice @ alps: image delete a b (dry run) → success
anonymous: DELETE /v2/groups/zinal → denied (401)

Control characters are escaped (\n → \\n): the line is logged as plain text and its values are caller-controlled.

Every route gets one with no per-handler code: the verb is the handler’s action with its separators turned into spaces, or method and path when no handler named it.

Trait Implementations

impl Clone for AuditEvent

fn clone(&self) -> AuditEvent

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for AuditEvent

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

Formats the value using the given formatter.

impl PartialEq for AuditEvent

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for AuditEvent

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for AuditEvent