aboutsummaryrefslogtreecommitdiffstats
path: root/docs/about_Trace.help.txt
blob: 78efaff68a9c479ccebb930f6638af720e4963bb (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
TOPIC
    about_Trace

SHORT DESCRIPTION
    Remote debugger voor PowerShell-scripts op een vloot servers.

LONG DESCRIPTION
    Trace vindt draaiende PowerShell-scripts op meerdere servers via
    SSH-remoting, volgt ze op en legt bij een crash de volledige toestand
    vast: regel, variabelen, callstack en $Error.

    Op de servers is niets extra nodig: alleen pwsh 7.4 of hoger en het
    powershell-subsystem van sshd. Alle logica draait op de beheermachine.

  DE SERVERLIJST
    Trace leest een YAML-bestand in de structuur van een Ansible-inventaris.
    Zie fleet.example.yml. Per server gelden ansible_host, ansible_port,
    ansible_user, ansible_ssh_private_key_file en trace_debug.

    trace_debug staat standaard op false. Dan haalt Trace op die server
    alleen logs op (niveau 0) en grijpt het nooit in op een script.

  NIVEAUS VAN LICHT TOT DIEP
    0  logs         De logbestanden die het script zelf schrijft ophalen.
                    Werkt alleen als het script zelf logt.

    1  wrapper      Een script starten via een wrapper die bij een fout
                    de toestand vastlegt. Vangt ook kortlopende scripts op,
                    zoals cronjobs.

    2  tracepoints  Een waarde vastleggen telkens een regel of variabele
                    geraakt wordt, zonder het script te stoppen.

    3  attach       Aanhaken aan een script dat al draaide, en daar
                    niveau 1 en 2 toepassen.

    Niveau 1 tot 3 vereisen trace_debug: true. Attachen vereist bovendien
    dezelfde gebruiker als het script, of root.

  WAT TRACE NIET ZIET
    Discovery vindt alleen scripts die op dat moment draaien. Een script
    dat start en eindigt tussen twee scans wordt niet gevonden; start
    zulke scripts via de wrapper (niveau 1).

EXAMPLES
    Gepland; de cmdlets bestaan nog niet.

    Import-TraceServer ./fleet.yml | Test-TraceServer
    Import-TraceServer ./fleet.yml | Find-TraceScript
    Import-TraceServer ./fleet.yml | Find-TraceScript | Connect-TraceScript
    Get-TraceCrashReport -Server build01

SEE ALSO
    Get-Help Set-PSBreakpoint
    Get-Help Enter-PSHostProcess
    https://learn.microsoft.com/powershell/scripting/security/remoting/ssh-remoting-in-powershell