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: not assigned yet
  • status: not started
  • start-date: 2026/07/01
  • end-date: 2026/09/30

Description

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

Deliverables

  • Log levels adjusted for noisy paths
  • Reworded messages where context or actionability is poor
  • Deduplication or rate reduction for repeated messages where needed
  • Tests updated where log output is asserted