Skip to content

Updated configuration in monitoring HTTP access logs#11595

Open
Dimagidhp wants to merge 2 commits into
wso2:masterfrom
Dimagidhp:fixing-issue-10768
Open

Updated configuration in monitoring HTTP access logs#11595
Dimagidhp wants to merge 2 commits into
wso2:masterfrom
Dimagidhp:fixing-issue-10768

Conversation

@Dimagidhp

Copy link
Copy Markdown

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

  • Replaced the incorrect enabled = true property with the correct useLogger = true under the [http_access_log] section in deployment.toml (step 2), as enabled = true is not required and is on by default.
  • Fixed indentation of the sub-content under step 3 so it's nested under the ordered list item instead of breaking out into a new block.

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.

@CLAassistant

CLAassistant commented Jul 10, 2026

Copy link
Copy Markdown

CLA assistant check
All committers have signed the CLA.

@coderabbitai

coderabbitai Bot commented Jul 10, 2026

Copy link
Copy Markdown

Review Change Stack

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: be8a07f0-b4ee-4fc0-a016-f7c395c28f2e

📥 Commits

Reviewing files that changed from the base of the PR and between d231793 and 1c3d1e8.

📒 Files selected for processing (1)
  • en/docs/monitoring/observability/monitoring-http-access-logs.md

📝 Walkthrough

Summary

  • Updated the HTTP access-log monitoring documentation for the HTTP Servlet transport to use deployment.toml’s [http_access_log] useLogger = true, removing the redundant enabled = true since it’s enabled by default.
  • Corrected documentation formatting (including step indentation) and refreshed the Log4j2 configuration snippet and the example http_access_*.log entries to align with the updated settings.

Walkthrough

Updated the HTTP Servlet transport access-log guide to use useLogger = true under [http_access_log] instead of enabled = true. The Log4j configuration examples now present the HTTP_ACCESS appender and logger as a complete configuration block. The sample entries for http_access_.log were also revised.

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Title check ✅ Passed The title clearly reflects the main change: updating HTTP access log configuration in the docs.
Description check ✅ Passed Core template sections are covered and the change is described clearly, with only optional sections omitted.
Linked Issues check ✅ Passed The doc update adds useLogger=true and removes the unnecessary enabled=true, matching #10768.
Out of Scope Changes check ✅ Passed The additional log4j2 and sample-output edits are directly related to the same documentation fix.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests

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.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🧹 Nitpick comments (1)
en/docs/monitoring/observability/monitoring-http-access-logs.md (1)

25-43: 📐 Maintainability & Code Quality | 🔵 Trivial | ⚡ Quick win

Specify the configuration language for each fenced block.

Use properties instead of Sample or a blank fence for these Log4j configuration examples.

Proposed fix
-    ```Sample
+    ```properties
...
-    ```Sample
+    ```properties
...
-    ```
+    ```properties
...
-    ```
+    ```properties

Based 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

📥 Commits

Reviewing files that changed from the base of the PR and between acd83ed and c58f562.

📒 Files selected for processing (1)
  • en/docs/monitoring/observability/monitoring-http-access-logs.md

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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 win

Align the configured output file with the documented path.

This appender writes to wso2carbon.log, while the following section directs readers to http_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

📥 Commits

Reviewing files that changed from the base of the PR and between c58f562 and d231793.

📒 Files selected for processing (1)
  • en/docs/monitoring/observability/monitoring-http-access-logs.md

Comment on lines +25 to +30
```
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"
```

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

📐 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

@Dimagidhp Dimagidhp force-pushed the fixing-issue-10768 branch from d231793 to 1c3d1e8 Compare July 12, 2026 07:46
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Missing configuration in "Monitoring HTTP Access Logs" doc

2 participants