Start/notes.ini Parameter/HTTPEnableThreadDebug

HTTPEnableThreadDebug

Parameter: HTTPEnableThreadDebug
Kurzbeschreibung: Aktiviert das Thread-basierte HTTP-Request-Logging im Domino-Webserver. Erzeugt pro HTTP-Worker-Thread eine htthr_*.log-Datei im Verzeichnis IBM_TECHNICAL_SUPPORT.

Steckbrief

Parameter
HTTPEnableThreadDebug
Komponente
Server (HTTP-Task)
Kategorie
Logging / Debug
Verfügbar seit
9.0.x (gemäß KB0032210)
Default
0 (deaktiviert)
Werte
0 aus, 1 ein
Log-Dateien
htthr_<pid>_<tid>_<YYYYMMDD@HHMMSS>.log
Speicherort
IBM_TECHNICAL_SUPPORT (über LOGFILE_DIR umlenkbar)
Konsole
tell http debug thread on \| off

Beschreibung

Mit HTTPEnableThreadDebug=1 schaltet der HTTP-Task ein detailliertes Trace-Logging ein. Das Log enthält für jeden Request die Schritte der internen HTTP-Pipeline:
*** 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
Jede Zeile enthält die Session-ID <sid> (hex), die Thread-ID <tid> (hex) und den Zeitstempel Clock in Millisekunden seit HTTP-Start. Bei einem Hang oder Crash lässt sich anhand des letzten erreichten Steps die Application-Space-Ebene eingrenzen (DSAPI, Servlet, Notes/iNotes, CGI, File System).
Da Domino die Anzahl gleichzeitig aktiver HTTP-Worker-Threads begrenzt, ist auch die Anzahl der htthr_*.log-Dateien begrenzt. Sobald HTTPEnableThreadDebug aktiv ist, deaktiviert Domino automatisch das alternative Session-basierte Logging.

Aktivierung

Statisch über notes.ini:
HTTPEnableThreadDebug=1
Dynamisch über die Server-Konsole, ohne Neustart:
tell http debug thread on
tell http debug thread off
Beim Aktivieren werden ab sofort neue htthr_*.log-Dateien angelegt; beim Deaktivieren wird das Logging gestoppt.

Verwandte Parameter und Hinweise

  • LOGFILE_DIR=<Pfad> – setzt das Verzeichnis für Debug-Log-Dateien. Default ab Domino 9.0.1: IBM_TECHNICAL_SUPPORT. Nur per notes.ini setzbar (keine Konsole), muss vor dem HTTP-Start gesetzt sein.
  • HTTPEnablePostDataLogging=1 – erweitert das Logging um POST-Bodies eingehender Requests.
  • HTTPEnableResponseContentLogging=1 – erweitert das Logging um Server-Antwort-Inhalte (lässt Log-Dateien stark wachsen).
  • HTTPDebugLogOnlyLastRequest=1 – protokolliert nur den letzten verarbeiteten Request (nützlich bei Crash-Analysen).
  • HTTPEnableClockDebug=1 – aktiviert gepufferte Request-Logs für Performance-Analysen.
Warnung von HCL: Das Logging soll laut KB0032210 ausschließlich für gezielte Troubleshooting-Zwecke und in der Regel auf Anweisung des HCL-Supports eingesetzt werden. Da die Dateien mit der Zeit anwachsen, sollte das Flag nicht dauerhaft aktiviert bleiben – sonst kann der verfügbare Plattenplatz aufgebraucht werden.

Quellen (HCL Product Documentation)