Repository navigation
Conversation
frenzzy
force-pushed
the
log-trace-context
branch
from
September 28, 2026 04:42
e7bd4fe to
951412a
Compare
Describe the `--log-trace-context` option that adds the trace context of a valid W3C `traceparent` request header to the JSON log lines written for the request (the `response` line, the access log format line and the lines logged while the request is handled), and list it in the CLI, environment variable and config file references.
frenzzy
force-pushed
the
log-trace-context
branch
from
November 12, 2026 02:15
951412a to
52b9d28
Compare
This branch has not been deployed
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Description
v3 docs for the
--log-trace-contextoption proposed in static-web-server/static-web-server#760 (issue static-web-server/static-web-server#759). Rebased on the currentmaster.features/logging.md: a new "Logging Trace Context" section. When enabled and a request has a valid W3Ctraceparentheader, the log lines written for the request get the top-leveltrace_id,span_idandtrace_flagsfields (OpenTelemetry "Trace Context in Non-OTLP Log Formats"). It covers the per-requestresponseline, the--access-log-formatline and the lines logged while the request is handled (e.g. theerror_pagewarning). Lines logged outside the request handler, such as connection errors or the HTTPS redirect listener, are not covered. The section also documents thejsonlog format requirement, the default (disabled) and an example with a404. The "Per-request logging" section mentions the new fields.configuration/cli.md,configuration/env.md,configuration/file.md: the--log-trace-contextoption, theSERVER_LOG_TRACE_CONTEXTenv and thelog-trace-contextkey under[general].Please merge this only together with (or after) the code PR.
prettier --check,markdownlint-cli2,vue-tscandyarn buildpass.