← All compilation units

Flyology.HTTP.Server.Logging

Description

Defines an application-provided access-log sink boundary.

Sink

type Sink is limited interface;

Thread-safe application log sink. Implementations must not retain borrowed strings and should not raise from Write.

Write

procedure Write
  (Item           : in out Sink;
   Method         : String;
   Route          : String;
   Target         : String;
   Status         : Natural;
   Request_ID     : String;
   Peer           : Flyology.IO.Sockets.Endpoint;
   Request_Bytes  : Natural;
   Response_Bytes : Natural;
   Elapsed        : Duration)

Observe one completed request. Target is empty unless an application explicitly enabled target logging; no credentials, cookies, authorization field, or body are supplied.

Parameters
Item

Log sink

Method

Request method

Route

Stable normalized route name

Target

Optional request target

Status

Final status or zero

Request_ID

Validated request identifier

Peer

Connected peer

Request_Bytes

Decoded request body bytes

Response_Bytes

Response payload bytes

Elapsed

Monotonic elapsed seconds