Struct Log 

pub struct Log;

Available on non-WebAssembly only.

Logging helpers for access logs and server info.

Log::combined produces standard Combined Log Format lines compatible with GoAccess, AWStats, and similar tools. All three server code paths (HTTP/1.1, HTTP/2, HTTP/3) use it.

Implementations

impl Log

pub fn request_response( request: &Request, response: &Response, peer_addr: &SocketAddr, ) -> String

A multi-line debugging dump of a request and its response, headers included — the values of Authorization, Proxy-Authorization, Cookie, Set-Cookie and of RWS_CONFIG_LOG_REDACT_HEADERS shown as REDACTED (since 18.33.0).

pub fn usage_information() -> String

pub fn current_user() -> String

The user rws runs as, for the startup banner: $USER, $LOGNAME or %USERNAME%, else "unknown". Deliberately not whoami (what FileExt::get_current_user runs): minimal container images such as distroless have no whoami, and the banner’s unwrap() on that error crashed the published Docker image at startup.

pub fn info(name: &str) -> String

pub fn json( request: &Request, response: &Response, peer_addr: &SocketAddr, ) -> String

Returns a structured JSON log line for one request/response pair: time, remote_addr, method, path, protocol, status, bytes, then host, user_agent and referer when the request has them.

Enable with RWS_CONFIG_LOG_FORMAT=json. Useful for log aggregators (Loki, Fluentd, Datadog) that ingest JSON from pod stdout.

pub fn log_access( request: &Request, response: &Response, peer_addr: &SocketAddr, )

Writes one access log line to stdout using the format configured by RWS_CONFIG_LOG_FORMAT ("combined" or "json"). Call this instead of Log::combined so that format selection is centralised.

Lines are buffered per thread and written by a background thread every 100 ms (and when a thread’s buffer passes 32 KiB, when the thread exits, and at process exit); Log::flush_access_log writes them now.

pub fn reopen_access_log_on_sigusr1()

Have SIGUSR1 reopen the access-log file (RWS_CONFIG_ACCESS_LOG) before its next write, for logrotate; does nothing when the log goes to stdout. The rws binary calls it at startup.

pub fn reopen_access_log()

Reopen the access-log file before its next write — what SIGUSR1 does, for a program that moves the file itself.

pub fn flush_access_log()

Write out the buffered access-log lines now (they’re otherwise written within 100 ms) — e.g. before exiting without returning from main.

pub fn access_log_line( request: &Request, response: &Response, peer_addr: &SocketAddr, ) -> Option<String>

The access-log line for RWS_CONFIG_LOG_FORMAT: json (the rws binary’s default), Combined Log Format for any other value (including unset, in library use), or None for off/none — no per-request line, e.g. behind a proxy that already logs or when benchmarking. Taken from ServerConfig::current(), so it’s hot-reloadable.

pub fn combined( request: &Request, response: &Response, peer_addr: &SocketAddr, ) -> String

Returns a Combined Log Format (CLF) line for one request/response pair: IP - - [DD/Mon/YYYY:HH:MM:SS +0000] "METHOD URI VERSION" STATUS SIZE

pub fn server_url_thread_count( protocol: &str, bind_addr: &String, thread_count: i32, ) -> String