Start/notes.ini Parameters/DEBUG_SESSION_IO

DEBUG_SESSION_IO

🛠️
Parameter: DEBUG_SESSION_IO
Short description: Logs the establishment, duration, and end of NRPC sessions including bytes-in/bytes-out – used to detect session leaks and long-lived connections.

Profile

Parameter
DEBUG_SESSION_IO
Category
Logging / Debug
Component
Server
Available since
10.0
Supported versions
10.0, 11.0, 12.0, 14.0, 14.5, 14.5.1
GUI equivalent
notes.ini only (no GUI)
Possible values
0 = off, 1 = one line per session end, 2 = incl. call counts

Description

DEBUG_SESSION_IO makes the server write a summary to the console when each NRPC session ends: user, connection duration, number of calls, and bytes transferred in both directions. This makes it possible to specifically identify "hangers", excessively long sessions, and clients with unusual data volume. At level 2, the output additionally contains the call counts per session – useful for distinguishing bot or script clients from normal Notes users.

Example configuration

DEBUG_SESSION_IO=1

Notes & pitfalls

  • Complements Server_Show_User_Detail and Show users console output.
  • On heavily used servers, many log lines are produced – consider log rotation.
  • Sessions are only shown when they end; for ongoing sessions, continue to use show users.
  • Takes effect immediately; no server restart required.