/
[ACCEPTED] DEBUG Log Improvement Proposal

[ACCEPTED] DEBUG Log Improvement Proposal

Problem

--logging=DEBUG level is too spammy for end users and either we have to use the ADMIN RPC endpoint to target packages/classes or get them to post full logs which is a barrier and error prone.

Goal

End users can enable --logging=DEBUG and have a chance at spotting an issue or pasting relevant snippets into support channels.


DEBUG Principles

  •  Aimed at both end users and developers
  •  Should lead to resolution of common problems, whilst not spamming
  •  Should not contain logs that take up more than one terminal screen, e.g. raw data, including RLP

DEBUG Guidelines

  • Should not include peer discovery
  • Should not include txpool management
  • Could include some peering to debug peering issues
  • Could include some high level syncing
  • Could include API requests, including potentially truncated data, but not full RLP


TRACE principles

  • Aimed at developers
  • Expectation is everything is there and it's spammy
  • Only useful when targetting certain packages/classes


Actions (if no objections)

  • Submit PR(s) to move logs from DEBUG → TRACE and any other tidy up to follow the proposal
  • Update existing documentation, e.g Coding Conventions and Logging

Related content

2022-02-01 Meeting Notes
2022-02-01 Meeting Notes
More like this
VS Code Debugger Plugin for Hyperledger Fabric Chaincode
VS Code Debugger Plugin for Hyperledger Fabric Chaincode
More like this
2023-10-10 Contributor Call - APAC Friendly Time
2023-10-10 Contributor Call - APAC Friendly Time
More like this
Changelog Improvement Proposal
Changelog Improvement Proposal
More like this
2022-06-07 Contributor Call
2022-06-07 Contributor Call
More like this
2020-08-17 Meeting notes
2020-08-17 Meeting notes
More like this