Skip to content

LogEntry

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

Structured log entry emitted for each request/response pair.

clientIp: string

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

Client IP from CF-Connecting-IP or X-Forwarded-For.


durationMs: number

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

End-to-end request duration in milliseconds.


optional extra: Record<string, unknown>

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

Custom fields from extractFields callback.


gatewayName: string

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

Gateway name from config.


method: string

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

HTTP method (e.g. "GET", "POST").


path: string

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

URL pathname (without query string).


optional requestBody: unknown

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

Captured request body (when logRequestBody is enabled).


requestId: string

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

Unique request ID for distributed tracing.


optional responseBody: unknown

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

Captured response body (when logResponseBody is enabled).


routePath: string

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

Matched route path pattern.


optional spanId: string

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

W3C Trace Context — 16-hex span ID for this gateway request.


statusCode: number

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

HTTP response status code.


timestamp: string

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

ISO 8601 timestamp when the log was emitted.


optional traceId: string

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

W3C Trace Context — 32-hex trace ID.


upstream: string

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

Upstream identifier (reserved for future enrichment).


userAgent: string

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

Client User-Agent header value.