Skip to main content

AccessLog

s4_server::access_log

Struct AccessLog

pub struct AccessLog { /* private fields */ }

Expand description

Buffered emitter. Per-handler call sites push entries via AccessLog::record; a background task drains the buffer and writes one S3 object per flush window.

Implementations§

impl AccessLog

pub fn new(dest: AccessLogDest) -> Self

pub fn with_hmac_key(self, key: Arc<AuditHmacKey>) -> Self

v0.5 #31: turn on tamper-evident HMAC chaining. Every emitted line gets a trailing hex HMAC column, and each new batch file starts with a # prev_file_tail=<hex> comment so the chain extends across rotations. Without this builder, lines are emitted exactly as before (back-compat with v0.4 #20 readers).

pub async fn record(&self, entry: AccessLogEntry)

pub fn spawn_flusher(&self) -> JoinHandle<()>

Spawn the background flusher. Drains the buffer every flush_every_secs (default 60) and appends to the per-hour file in dest.dir. Returns the tokio JoinHandle so the caller can abort on shutdown if needed.

Auto Trait Implementations§

impl Freeze for AccessLog

impl !RefUnwindSafe for AccessLog

impl Send for AccessLog

impl Sync for AccessLog

impl Unpin for AccessLog

impl UnsafeUnpin for AccessLog

impl !UnwindSafe for AccessLog

Blanket Implementations§

impl<T> Any for T
where T: 'static + ?Sized,

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more

impl<'a, T, E> AsTaggedExplicit<'a, E> for T
where T: 'a,

fn explicit(self, class: Class, tag: u32) -> TaggedParser<'a, Explicit, Self, E>

impl<'a, T, E> AsTaggedImplicit<'a, E> for T
where T: 'a,

fn implicit( self, class: Class, constructed: bool, tag: u32, ) -> TaggedParser<'a, Implicit, Self, E>

impl<T> Borrow<T> for T
where T: ?Sized,

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more

impl<T> BorrowMut<T> for T
where T: ?Sized,

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more

impl<T> From<T> for T

fn from(t: T) -> T

Returns the argument unchanged.

impl<T> FromExt for T

fn from_<T>(t: T) -> Self
where Self: From<T>,

impl<T> Instrument for T

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more

impl<T, U> Into<U> for T
where U: From<T>,

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

impl<T> IntoExt for T

fn into_<T>(self) -> T
where Self: Into<T>,

impl<T> Pointable for T

const ALIGN: usize

The alignment of pointer.

type Init = T

The type for initializers.

unsafe fn init(init: <T as Pointable>::Init) -> usize

Initializes a with the given initializer. Read more

unsafe fn deref<'a>(ptr: usize) -> &'a T

Dereferences the given pointer. Read more

unsafe fn deref_mut<'a>(ptr: usize) -> &'a mut T

Mutably dereferences the given pointer. Read more

unsafe fn drop(ptr: usize)

Drops the object pointed to by the given pointer. Read more

impl<T> PolicyExt for T
where T: ?Sized,

fn and<P, B, E>(self, other: P) -> And<T, P>
where T: Policy<B, E>, P: Policy<B, E>,

Create a new Policy that returns Action::Follow only if self and other return Action::Follow. Read more

fn or<P, B, E>(self, other: P) -> Or<T, P>
where T: Policy<B, E>, P: Policy<B, E>,

Create a new Policy that returns Action::Follow if either self or other returns Action::Follow. Read more

impl<T> Same for T

type Output = T

Should always be Self

impl<T, U> TryFrom<U> for T
where U: Into<T>,

type Error = Infallible

The type returned in the event of a conversion error.

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.

impl<T> TryFromExt for T

fn try_from_<T>(t: T) -> Result<Self, Self::Error>
where Self: TryFrom<T>,

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.

impl<T> TryIntoExt for T

fn try_into_<T>(self) -> Result<T, Self::Error>
where Self: TryInto<T>,

impl<V, T> VZip<V> for T
where V: MultiLane<T>,

fn vzip(self) -> V

impl<T> WithSubscriber for T

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more