Bug 737907
| Summary: | Document areas to debug of --log-enable option | ||
|---|---|---|---|
| Product: | Red Hat Enterprise MRG | Reporter: | Pavel Moravec <pmoravec> |
| Component: | Messaging_Installation_and_Configuration_Guide | Assignee: | Cheryn Tan <chetan> |
| Status: | CLOSED CURRENTRELEASE | QA Contact: | Zdenek Kraus <zkraus> |
| Severity: | low | Docs Contact: | |
| Priority: | low | ||
| Version: | 2.0 | CC: | freznice, iboverma, lbrindle, rlandman, zkraus |
| Target Milestone: | 2.1.2 | ||
| Target Release: | --- | ||
| Hardware: | Unspecified | ||
| OS: | Unspecified | ||
| Whiteboard: | |||
| Fixed In Version: | Doc Type: | Bug Fix | |
| Doc Text: | Story Points: | --- | |
| Clone Of: | Environment: | ||
| Last Closed: | 2012-05-02 05:31:36 UTC | Type: | --- |
| Regression: | --- | Mount Type: | --- |
| Documentation: | --- | CRM: | |
| Verified Versions: | Category: | --- | |
| oVirt Team: | --- | RHEL 7.3 requirements from Atomic Host: | |
| Cloudforms Team: | --- | Target Upstream Version: | |
| Embargoed: | |||
| Bug Depends On: | 733205 | ||
| Bug Blocks: | |||
Source: <command>--log-enable debug+:cluster</command> - logs debug messages from the <filename>qpid/cluster</filename> module. This option can be used multiple times. Note: 'debug+' level logs debug and higher logging level. So above part of manual is wrong. Please change 'debug+' to 'debug' or change description to something like "logs all debug, info, notice, warning, error, critical messages from the qpid/cluster ..." -> ASSIGNED This looks right. -> VERIFIED Documents have been published on http://docs.redhat.com/docs/en-US/Red_Hat_Enterprise_MRG/index.html as part of the MRG-M 2.1.2 update. |
Description of problem: --log-enable option is not documented outside qpidd process, and one its parameter is not documented anywhere. Fixing this would help in troubleshooting to (know how to) setup proper logging a lot. qpidd --help describes verbosity levels to debug with the possibility to restrict the logging change to some component ('--log-enable debug:framing' is an example there). But the "components" are not described anywhere. Per http://fossplanet.com/f13/list-areas-log-debug-trace-192193/#post581190, the string is matched against the fully-qualied name of the c++ function with the logging statement. I.e. this allows to selectivelly switch on/off even logs from individual functions (knowing source code little bit). Version-Release number of selected component (if applicable): any How reproducible: documentation issue Steps to Reproduce: (not relevant) Actual results: only qpidd --help describes --log-enable option somehow Expected results: Add the option to manuals with both severity and module/scope described. Particular manual to contain that info can be either user manual (logically best place) or to installation manual (where other logging related options are described in Section 3.3. Logging Broker Errors. Additional info: