Updated configuration in monitoring HTTP access logs#11595
Conversation
|
No actionable comments were generated in the recent review. 🎉 ℹ️ Recent review info⚙️ Run configurationConfiguration used: Organization UI Review profile: CHILL Plan: Pro Run ID: 📒 Files selected for processing (1)
📝 WalkthroughSummary
WalkthroughUpdated the HTTP Servlet transport access-log guide to use 🚥 Pre-merge checks | ✅ 5✅ Passed checks (5 passed)
✨ Finishing Touches🧪 Generate unit tests (beta)
Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out. Comment |
There was a problem hiding this comment.
🧹 Nitpick comments (1)
en/docs/monitoring/observability/monitoring-http-access-logs.md (1)
25-43: 📐 Maintainability & Code Quality | 🔵 Trivial | ⚡ Quick winSpecify the configuration language for each fenced block.
Use
propertiesinstead ofSampleor a blank fence for these Log4j configuration examples.Proposed fix
- ```Sample + ```properties ... - ```Sample + ```properties ... - ``` + ```properties ... - ``` + ```propertiesBased on learnings, fenced code blocks are the repository standard for Markdown under
en/docs.🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the rest with a brief reason, keep changes minimal, and validate. In `@en/docs/monitoring/observability/monitoring-http-access-logs.md` around lines 25 - 43, Update every Log4j configuration fenced block in this section, including the appenders, loggers, HTTP_ACCESS logger, and appender configuration examples, to use the properties language tag; replace ```Sample and untagged fences with ```properties while preserving the configuration content.Source: Learnings
🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
Nitpick comments:
In `@en/docs/monitoring/observability/monitoring-http-access-logs.md`:
- Around line 25-43: Update every Log4j configuration fenced block in this
section, including the appenders, loggers, HTTP_ACCESS logger, and appender
configuration examples, to use the properties language tag; replace ```Sample
and untagged fences with ```properties while preserving the configuration
content.
ℹ️ Review info
⚙️ Run configuration
Configuration used: Organization UI
Review profile: CHILL
Plan: Pro
Run ID: 1e3e3ac0-935e-4a3d-a4ba-00c15a4b93f6
📒 Files selected for processing (1)
en/docs/monitoring/observability/monitoring-http-access-logs.md
There was a problem hiding this comment.
Actionable comments posted: 1
Caution
Some comments are outside the diff and can’t be posted inline due to platform limitations.
⚠️ Outside diff range comments (1)
en/docs/monitoring/observability/monitoring-http-access-logs.md (1)
44-47: 🎯 Functional Correctness | 🟠 Major | ⚡ Quick winAlign the configured output file with the documented path.
This appender writes to
wso2carbon.log, while the following section directs readers tohttp_access_.log. Update the appender destination or the sample reference so users following these steps can find the generated logs.🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the rest with a brief reason, keep changes minimal, and validate. In `@en/docs/monitoring/observability/monitoring-http-access-logs.md` around lines 44 - 47, Align the HTTP_ACCESS appender configuration with the documented log filename: update either its fileName/filePattern settings or the subsequent sample reference so both use the same output path, preserving the existing rolling-file behavior.
🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
Inline comments:
In `@en/docs/monitoring/observability/monitoring-http-access-logs.md`:
- Around line 25-30: Update both fenced Log4j configuration blocks in the
monitoring documentation to use the properties language tag, including the
existing appenders block and the loggers block, while leaving their contents
unchanged.
---
Outside diff comments:
In `@en/docs/monitoring/observability/monitoring-http-access-logs.md`:
- Around line 44-47: Align the HTTP_ACCESS appender configuration with the
documented log filename: update either its fileName/filePattern settings or the
subsequent sample reference so both use the same output path, preserving the
existing rolling-file behavior.
🪄 Autofix (Beta)
Fix all unresolved CodeRabbit comments on this PR:
- Push a commit to this branch (recommended)
- Create a new PR with the fixes
ℹ️ Review info
⚙️ Run configuration
Configuration used: Organization UI
Review profile: CHILL
Plan: Pro
Run ID: 6af02023-1a55-4963-aa72-15b6e7aca716
📒 Files selected for processing (1)
en/docs/monitoring/observability/monitoring-http-access-logs.md
| ``` | ||
| appenders = CARBON_CONSOLE, CARBON_LOGFILE, AUDIT_LOGFILE, ATOMIKOS_LOGFILE, CARBON_TRACE_LOGFILE, DELETE_EVENT_LOGFILE, TRANSACTION_LOGFILE, osgi, HTTP_ACCESS | ||
| ``` | ||
|
|
||
| Add HTTP_ACCESS to existing "loggers" | ||
| ```Sample | ||
| loggers = AUDIT_LOG, trace-messages, org-apache-coyote, com-hazelcast, Owasp-CsrfGuard, org-apache-axis2-wsdl-codegen-writer-PrettyPrinter, org-apache-axis2-clustering, org-apache-catalina, org-apache-tomcat, org-wso2-carbon-apacheds, org-apache-directory-server-ldap, org-apache-directory-server-core-event, com-atomikos, org-quartz, org-apache-jackrabbit-webdav, org-apache-juddi, org-apache-commons-digester-Digester, org-apache-jasper-compiler-TldLocationsCache, org-apache-qpid, org-apache-qpid-server-Main, qpid-message, qpid-message-broker-listening, org-apache-tiles, org-apache-commons-httpclient, org-apache-solr, me-prettyprint-cassandra-hector-TimingLogger, org-apache-axis-enterprise, org-apache-directory-shared-ldap, org-apache-directory-server-ldap-handlers, org-apache-directory-shared-ldap-entry-DefaultServerAttribute, org-apache-directory-server-core-DefaultDirectoryService, org-apache-directory-shared-ldap-ldif-LdifReader, org-apache-directory-server-ldap-LdapProtocolHandler, org-apache-directory-server-core, org-apache-directory-server-ldap-LdapSession, DataNucleus, Datastore, Datastore-Schema, JPOX-Datastore, JPOX-Plugin, JPOX-MetaData, JPOX-Query, JPOX-General, JPOX-Enhancer, org-apache-hadoop-hive, hive, ExecMapper, ExecReducer, net-sf-ehcache, axis2Deployment, equinox, tomcat2, StAXDialectDetector, org-apache-directory-api, org-apache-directory-api-ldap-model-entry, TRANSACTION_LOGGER, DELETE_EVENT_LOGGER, org-springframework, org-opensaml-xml-security-credential-criteria, org-wso2-carbon-user-core, org-wso2-carbon-identity, org-wso2-carbon-identity-sso-saml, HTTP_ACCESS | ||
| ``` | ||
| Add HTTP_ACCESS to existing "loggers" | ||
| ``` |
There was a problem hiding this comment.
📐 Maintainability & Code Quality | 🟡 Minor | ⚡ Quick win
Add language tags to both fenced blocks.
Use properties for the Log4j configuration snippets to resolve the MD040 warnings.
- ```
+ ```properties
...
- ```
+ ```properties🧰 Tools
🪛 markdownlint-cli2 (0.22.1)
[warning] 25-25: Fenced code blocks should have a language specified
(MD040, fenced-code-language)
[warning] 30-30: Fenced code blocks should have a language specified
(MD040, fenced-code-language)
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
In `@en/docs/monitoring/observability/monitoring-http-access-logs.md` around lines
25 - 30, Update both fenced Log4j configuration blocks in the monitoring
documentation to use the properties language tag, including the existing
appenders block and the loggers block, while leaving their contents unchanged.
Source: Linters/SAST tools
d231793 to
1c3d1e8
Compare
Purpose
Resolves #10768
Goals
Fix the "Configuring access logs for the HTTP Servlet transport" section of the HTTP access logs monitoring doc, which had incorrect/missing configuration and a broken step list.
Approach
enabled = trueproperty with the correctuseLogger = trueunder the[http_access_log]section indeployment.toml(step 2), asenabled = trueis not required and is on by default.Documentation
en/docs/monitoring/observability/monitoring-http-access-logs.md
Automation tests
N/A - documentation-only change
Security checks
Test environment
Verified rendered output locally via
mkdocs serve, confirming the numbered list now renders steps correctly in sequence.