docs: enhance access log fields with comprehensive Envoy field documentation #1898
Conversation
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
…ntation - Add extensive set of Envoy access log fields with detailed descriptions - Organize fields into Standard, Extended Envoy, and Custom categories - Add configuration examples for extended Envoy fields - Include performance monitoring and debugging use cases - Add example log output with extended fields - Provide guidance on using timing fields for performance optimization Fixes #1605
✅ Deploy Preview for pomerium-docs ready!
To edit notification comments on pull requests, go to your Netlify project configuration. |
kenjenkins
reviewed
Jun 30, 2025
Comment on lines
+62
to
+64
| - protocol | ||
| - upstream-response-time | ||
| - response-flags |
There was a problem hiding this comment.
I don't think these fields are currently supported:
{
"level": "error",
"config-change-id": "0fbca6a4-eb1d-468e-a5e1-0cc31b2e317d",
"error": "config: options from config file \".config.yaml\": validation error config: invalid access_log_fields: unknown access log field: response-flags",
"time": "2025-06-30T11:48:57-07:00",
"message": "config: error updating config"
}
kralicky
reviewed
Jun 30, 2025
|
|
||
| ### Extended Envoy Fields | ||
|
|
||
| These additional fields are available through Envoy's access logging system: |
There was a problem hiding this comment.
What does this mean? None of these are in the list of access log fields we support.
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.
Summary
Enhanced the access log fields documentation to include comprehensive Envoy access log field capabilities as requested in #1605.
Changes
New Fields Added
request-duration,response-duration,upstream-response-timedownstream-local-address,upstream-host,protocolresponse-flags,route-name,upstream-request-attempt-countRelated Issues
/cc @kralicky for review