Trace
Remote debugger voor PowerShell-scripts op een vloot servers. Trace vindt draaiende
pwsh-scripts via SSH, volgt ze op en legt bij een crash de volledige toestand vast:
regel, variabelen, callstack en $Error. Op de servers wordt niets geïnstalleerd.
Status: in ontwikkeling. Alleen de proof of concept in
poc/attachwerkt: attachen aan een al draaiend script op een andere machine, met tracepoints.
Vereisten
- Beheermachine: PowerShell 7.4 of hoger, de module
powershell-yaml. - Servers: PowerShell 7.4 of hoger, en in
sshd_config:Subsystem powershell /usr/bin/pwsh -sshs -NoLogo - Om te attachen: dezelfde SSH-gebruiker als het script, of root.
Snel aan de slag
- Kopieer
fleet.example.ymlnaarfleet.ymlen vul je servers in. Een bestaande Ansible-inventaris in YAML werkt ook. - Zet
trace_debug: truealleen op servers waar debuggen mag.
Gepland gebruik:
Import-Module ./Trace
Import-TraceServer ./fleet.yml | Test-TraceServer # is elke server klaar?
Import-TraceServer ./fleet.yml | Find-TraceScript # welke scripts draaien er?
Get-Help about_Trace # de niveaus van licht tot diep
Cmdlets (gepland)
| Cmdlet | Wat het doet | Niveau |
|---|---|---|
Import-TraceServer |
Serverlijst inlezen en valideren | |
Test-TraceServer |
Controleren of elke server klaar is (pwsh, subsystem, rechten) | |
Find-TraceScript |
Draaiende pwsh-scripts vinden |
|
Get-TraceLog |
Logs ophalen die het script zelf schrijft | 0 |
Start-TraceScript |
Script starten via de wrapper | 1 |
Set-TraceTracepoint / Remove-TraceTracepoint |
Tracepoints zetten en weghalen | 2 |
Connect-TraceScript / Disconnect-TraceScript |
Aanhaken aan een draaiend script en loskoppelen | 3 |
Get-TraceCrashReport |
Crashrapporten opvragen en tonen |
Mappen
fleet.example.yml voorbeeldserverlijst
docs/architectuur.md hoe het werkt, met de bevindingen uit de PoC
docs/about_Trace.help.txt helptopic (komt in de module onder en-US/)
poc/attach/ proof of concept: VM opstarten en een draaiend script debuggen
Proof of concept
cd poc/attach
./up.sh # Debian-VM met pwsh en een draaiend hello.ps1
pwsh ./debug.ps1 # attachen, tracepoints, resultaat op de beheermachine
./down.sh # VM stoppen
Zie poc/attach/README.md voor de uitvoer en de beperkingen.