requestLog

const requestLog: (config?) => Policy

Defined in: src/policies/observability/request-log.ts:105

Emit structured JSON logs for every request/response pair.

Captures method, path, status, duration, client IP, user agent, and gateway context (request ID, gateway name, route path). Runs at priority 0 so it wraps the entire pipeline and measures end-to-end latency.

By default, logs are written to console.log as JSON lines. Provide a custom sink to route logs to an external service (e.g., Logflare, Datadog, or a Durable Object buffer).

Parameters

config?

RequestLogConfig

Custom field extraction, body logging, and sink. All fields optional.

Returns

Policy

A Policy at priority 0 (runs first, wraps everything).

Example

import { createGateway } from "@homegrower-club/stoma";
import { requestLog } from "@homegrower-club/stoma/policies";

// Default structured JSON logging to console
createGateway({
  policies: [requestLog()],
  routes: [...],
});

// With body logging and redaction
requestLog({
  logRequestBody: true,
  logResponseBody: true,
  redactPaths: ["password", "*.secret", "auth.token"],
  sink: async (entry) => {
    await fetch("https://logs.example.com/ingest", {
      method: "POST",
      body: JSON.stringify(entry),
    });
  },
});