Start/notes.ini Parameters/HTTPEnableThreadDebug

HTTPEnableThreadDebug

Parameter: HTTPEnableThreadDebug
Short description: Activates thread-based HTTP request logging in the Domino web server. Creates an htthr_*.log file per HTTP worker thread in the IBM_TECHNICAL_SUPPORT directory.

Profile

Parameter
HTTPEnableThreadDebug
Component
Server (HTTP task)
Category
Logging / Debug
Available since
9.0.x (per KB0032210)
Default
0 (disabled)
Values
0 off, 1 on
Log files
htthr_<pid>_<tid>_<YYYYMMDD@HHMMSS>.log
Storage location
IBM_TECHNICAL_SUPPORT (redirectable via LOGFILE_DIR)
Console
tell http debug thread on \| off

Description

With HTTPEnableThreadDebug=1, the HTTP task switches on detailed trace logging. The log contains the steps of the internal HTTP pipeline for each request:
*** New Request -- Parse and Check Request: Session 7, Thread 10, Clock 14170
*** Process Request: Session 7, Thread 10, Clock 14180
    GET /names.nsf/cssForm?ReadForm HTTP/1.1
    Host: hostname
    User-Agent: ...
*** Pre Authenticate Step
*** Authenticate Step
*** Translate Step
*** Calling Inotes Process Request
*** Returned from Process Request
*** End Request Step
*** Log Request
Each line contains the session ID <sid> (hex), the thread ID <tid> (hex), and the Clock timestamp in milliseconds since HTTP start. In the event of a hang or crash, the last reached step can be used to narrow down the application-space layer (DSAPI, Servlet, Notes/iNotes, CGI, file system).
Since Domino limits the number of concurrently active HTTP worker threads, the number of htthr_*.log files is also limited. Once HTTPEnableThreadDebug is active, Domino automatically disables the alternative session-based logging.

Activation

Statically via notes.ini:
HTTPEnableThreadDebug=1
Dynamically via the server console, without restart:
tell http debug thread on
tell http debug thread off
When activated, new htthr_*.log files are created from that point on; when deactivated, logging stops.

Related parameters and notes

  • LOGFILE_DIR=<path> – sets the directory for debug log files. Default since Domino 9.0.1: IBM_TECHNICAL_SUPPORT. Can only be set via notes.ini (no console), must be set before HTTP start.
  • HTTPEnablePostDataLogging=1 – extends the logging with POST bodies of incoming requests.
  • HTTPEnableResponseContentLogging=1 – extends the logging with server response content (causes log files to grow significantly).
  • HTTPDebugLogOnlyLastRequest=1 – logs only the last processed request (useful for crash analysis).
  • HTTPEnableClockDebug=1 – activates buffered request logs for performance analysis.
Warning from HCL: according to KB0032210, the logging is intended exclusively for targeted troubleshooting purposes and generally on instruction from HCL Support. Since the files grow over time, the flag should not remain permanently active — otherwise the available disk space can be exhausted.

Sources (HCL Product Documentation)