Start/notes.ini Parameter/Debug_AMgr

Debug_AMgr

Parameter: Debug_AMgr
Kurzbeschreibung: Aktiviert detailliertes Agent-Manager-Tracing — feinkörnig pro Subsystem (Scheduling, Loading, Memory, Performance, Run-Time, Verbose). Hauptdiagnose-Werkzeug für Agent-Manager-Probleme, laufzeit-änderbar via tell amgr debug <options>.

Steckbrief

Parameter
Debug_AMgr
Kategorie
Logging / Debug (Agent Manager)
Komponente
Server
Verfügbar seit
Mindestens 9.0.1 (HCL Designer-Doku 9.0.1 – 14.0)
Unterstützte Versionen
9.0.1, 10.0, 11.0, 12.0, 14.0, 14.5, 14.5.1
GUI-Entsprechung
Nur notes.ini (keine GUI) — laufzeit-änderbar via tell amgr debug <options>
Mögliche Werte
Einzelne Buchstaben oder Kombinationen: c e l m p r s v *
Default
nicht gesetzt (kein Tracing)

Beschreibung

Debug_AMgr ist das primäre Tracing-Werkzeug des Domino Agent Managers. Über einen oder mehrere Optionsbuchstaben lässt sich gezielt steuern, welche Aspekte des AMgr-Verhaltens in das Server-Log bzw. in die Debug-Outfile geschrieben werden:
Option
Bedeutung
c
Control — Steuerlogik des Agent Managers (Start/Stop, Übergänge zwischen Worker-Threads)
e
Events — interne Ereignisse des AMgr (Trigger-Auswertung, Queue-Bewegungen)
l
Loading — Laden und Vorbereiten von Agents (Signer-Auflösung, Datenbankzugriff)
m
Memory warnings — Warnungen zur Speicher-/Resource-Nutzung des AMgr
p
Performance — Laufzeit-/Performance-Daten pro Agent
r
Run-time reports — detaillierter Run-Time-Report pro Agent-Lauf
s
Scheduling — Schedule-Berechnungen, On-Schedule-Trigger, Wochenend-/Tageslogik
v
Verbose — zusätzlicher Detailgrad zu allen anderen Optionen
*
Alle Optionen — maximales Tracing, signifikanter Performance-Einbruch
Mehrere Optionen lassen sich kombinieren (z. B. Debug_AMgr=lps für Loading + Performance + Scheduling). Die Ausgabe geht standardmäßig auf die Server-Konsole und in die log.nsf. Mit Debug_Outfile=<Datei> lässt sich die Ausgabe zentral in eine Textdatei umlenken — das ist die in der HCL Designer-Hilfe ausdrücklich empfohlene Vorgehensweise für längere Tracing-Sessions.
Besonderheit: Über das Tell-Kommando
tell amgr debug <options>
lässt sich Debug_AMgr zur Laufzeit umstellen, ohne den Agent Manager neu zu starten. Damit ist Debug_AMgr eines der wenigen Tracing-Settings, die für Live-Diagnose auf Produktiv-Systemen praktikabel sind, ohne den AMgr durchzustarten.
Für operative Dauer-Protokollierung (welche Agents wann starten) ist Log_AgentManager=1 oder =2 der bessere Schalter — Debug_AMgr ist klar als kurzlebiges, gezieltes Diagnose-Werkzeug ausgelegt.

Beispiel-Konfiguration

Gezielte Kombination — Loading + Performance + Scheduling, Output in eigene Datei:
Debug_AMgr=lps
Debug_Outfile=C:\Domino\Logs\amgr_debug.txt
Nur Run-Time-Reports pro Agent — schlankes Performance-Audit:
Debug_AMgr=r
Debug_Outfile=/local/notesdata/IBM_TECHNICAL_SUPPORT/amgr_runtime.txt
Maximales Tracing für kurze Reproduktion (nicht dauerhaft!):
Debug_AMgr=*
Debug_Outfile=C:\Domino\Logs\amgr_full_trace.txt
Laufzeit-Aktivierung ohne Server-Neustart — wird sofort wirksam:
tell amgr debug lps
Laufzeit-Deaktivierung:
tell amgr debug

Hinweise & Stolperfallen

  • Performance-Impact: Bereits einzelne Optionen (insbesondere p, r, v) erzeugen messbare Last — Debug_AMgr=* ist nur für kurze Reproduktionsfenster geeignet.
  • Output-Steuerung: Ohne Debug_Outfile landet die Ausgabe direkt auf der Server-Konsole / in log.nsf — bei umfangreichen Tracings gehen ältere Konsolen-Einträge schnell verloren.
  • Live-Toggle via Tell-Kommando: tell amgr debug <options> ist der HCL-empfohlene Weg, Debug_AMgr für Live-Diagnose ein- und auszuschalten; ein set config Debug_AMgr=… allein wirkt erst nach AMgr-Restart.
  • Wechselwirkung mit Log_AgentManager: Beide Schalter können parallel gesetzt sein. Debug_AMgr liefert detaillierteres Tracing, Log_AgentManager ist der dauerhaft-betriebsfähige Logger. Bei Bedarf ergänzen sich beide.
  • Optionsbuchstaben sind case-insensitive, werden aber in HCL-Doku konsequent klein geschrieben — bei der Pflege im Konfigurations-Settings-Dokument auf einheitliche Schreibweise achten.
  • * ist nicht für Dauerbetrieb: Verlangsamt den AMgr deutlich, kann auf stark belasteten Servern zu Timeouts und Schedule-Verschiebungen führen.
  • Diagnose-Klassiker zusammen mit Log_AgentManager=1 und AMgr_DisableMailLookup=1 (KB0032179-Bundle) bei Mail-getriggerten Agent-Problemen.

Quellen (HCL Product Documentation)