nim-libp2p Log Noise Reduction

ift-ts:p2p:ift:2026q3-nimlibp2p-log-noise-reduction

Review existing logs and reduce messages that are too verbose, too frequent, or not actionable for operators.

Description

nim-libp2p should produce logs that help users understand runtime behavior without overwhelming them during normal operation. This commitment audits noisy log paths, adjusts log levels and wording, and adds guidance for future logging changes.

This work complements exception trace cleanup by focusing on regular log messages, repeated debug output, and operational signal quality.

Task List

Log Audit

• fully qualified name: ift-ts:p2p:ift:2026q3-nimlibp2p-log-noise-reduction:log-audit
• owner: not assigned yet
• status: not started
• start-date: 2026/07/01
• end-date: 2026/09/30

Description

Audit logs emitted during common node startup, dialing, discovery, identify, pubsub, Kademlia, transport, and shutdown workflows among others. Review with Logos Delivery, Logos Storage and Nimbus Teams which logs cause noise and should be modified.

Deliverables

• List of highest-noise log messages and their code paths
• Recommendation for each message: keep, lower level, reword, deduplicate, or remove
• Reproduction notes or log samples for targeted paths

Logging Changes

• fully qualified name: ift-ts:p2p:ift:2026q3-nimlibp2p-log-noise-reduction:logging-changes
• owner: vlado
• status: done
• start-date: 2026/07/01
• end-date: 2026/09/29

Description

Apply the agreed logging changes while preserving useful diagnostics for failures and unusual runtime behavior.

Deliverables

• nim-libp2p#3038 chore(logs): standardize log fields
• nim-libp2p#3032 chore(logs): add log-severity policy
• nim-libp2p#3106 chore(Rng): redact type
• nim-libp2p#3107 chore(logs): add Copilot instruction
• nim-libp2p#3078 docs(logs): improve logging docs
• nim-libp2p#3082 feat: redact sensitive types
• nim-libp2p#3076 chore(logs): reuse shortLog code
• nim-libp2p#3075 chore(logs): add formatIt for all types
• nim-libp2p#3061 chore(logs): add logs
• nim-libp2p#3064 chore(logs): redact field content
• nim-libp2p#3062 chore(logs): add logs with rate limit
• nim-libp2p#3060 chore(logs): use shortlog for large fields
• nim-libp2p#3059 ci(logs): add test build with trace log lvl
• nim-libp2p#3051 chore(tools): fix logs fields lint
• nim-libp2p#3050 chore(logs): messages improved
• nim-libp2p#3053 chore(logs): add logs with background operation
• nim-libp2p#3047 docs(logs): add log ownership section
• nim-libp2p#3045 chore(logs): add logs with background operation
• nim-libp2p#3044 chore(logs): remove unecessery logs
• vacp2p/nim-libp2p#3141 chore(logs): improve info related logs
• vacp2p/nim-libp2p#3140 chore(logs): tune logs for kademlia & service-discovery
• vacp2p/nim-libp2p#3132 chore(logs): improve logs for pubsub
• vacp2p/nim-libp2p#3133 chore(logs): fix noisy switch logs
• vacp2p/nim-libp2p#3129 chore(logs): add logs message check
• vacp2p/nim-libp2p#3122 chore(logs): add log summary for batched operation
• vacp2p/nim-libp2p#3121 chore(logs): improve pubsub.Message shortLog
• vacp2p/nim-libp2p#3119 chore(logs): standardize topics
• iftech/nim-lsquic#171 chore: improve logs