Struct HttpRequest

pub struct HttpRequest {

    pub request_method: Option<Method>,
    pub request_url: Option<Url>,
    pub request_size: Option<u32>,
    pub response_size: Option<u32>,
    pub status: Option<StatusCode>,
    pub user_agent: Option<String>,
    pub remote_ip: Option<IpAddr>,
    pub server_ip: Option<IpAddr>,
    pub referer: Option<Url>,
    pub latency: Option<Duration>,
    pub cache_lookup: Option<bool>,
    pub cache_hit: Option<bool>,
    pub cache_validated_with_origin_server: Option<bool>,
    pub cache_fill_bytes: Option<u32>,
    pub protocol: Option<String>,
}

Available on crate feature valuable only.

Typechecked HttpRequest structure for stucturally logging information about a request. See Google’s HttpRequest docs here.

Fields

request_method: Option<Method>

Valid HTTP Method for the request (e.g. GET, POST, etc)

request_url: Option<Url>

URL from the HTTP request

request_size: Option<u32>

Size of the HTTP request in bytes

response_size: Option<u32>

Size of the HTTP response in bytes

status: Option<StatusCode>

Valid HTTP StatusCode for the response

user_agent: Option<String>

User Agent string of the request

remote_ip: Option<IpAddr>

IP address of the client that issued the request

server_ip: Option<IpAddr>

IP address of the server that the request was sent to

referer: Option<Url>

Referer URL of the request, as defined in HTTP/1.1 Header Field Definitions

latency: Option<Duration>

Processing latency on the server, from the time the request was received until the response was sent

cache_lookup: Option<bool>

Whether or not a cache lookup was attempted

cache_hit: Option<bool>

Whether or not an entity was served from cache (with or without validation)

cache_validated_with_origin_server: Option<bool>

Whether or not the response was validated with the origin server before being served from cache

cache_fill_bytes: Option<u32>

Number of HTTP response bytes inserted into cache

protocol: Option<String>

Protocol used for the request (e.g. “HTTP/1.1”, “HTTP/2”, “websocket”)

Implementations

impl HttpRequest

pub fn new() -> Self

Generate a new log-able HttpRequest structured log entry

Trait Implementations

impl Default for HttpRequest

fn default() -> HttpRequest

Returns the “default value” for a type.

impl Structable for HttpRequest

fn definition(&self) -> StructDef<'_>

Returns the struct’s definition.

impl Valuable for HttpRequest

fn as_value(&self) -> Value<'_>

Converts self into a Value instance.

fn visit(&self, visit: &mut dyn Visit)

Calls the relevant method on Visit to extract data from self.

fn visit_slice(slice: &[Self], visit: &mut dyn Visit)

where Self: Sized,

Calls Visit::visit_primitive_slice() with self.