Monitor autônomo de sistema e API do Windows com driver zero em Rust
Monitor de sistema e API do Windows de alto desempenho e sem driver, escrito em Rust.
strace moderno e Process Monitor em tempo real para Windows. Construído em Rust nativo sem necessidade de drivers de kernel, com uma interface de usuário de terminal (TUI) em tempo real e streaming sem buffer para diagnósticos headless.
Drivers de kernel de terceiros (.sys) apresentam risco de travamentos do sistema (BSOD), ampliam a superfície de ataque e exigem isenções de assinatura de driver proibidas em ambientes corporativos. O wstrace é executado 100% em userland usando APIs de depuração Win32 não invasivas e interfaces ETW nativas do Windows.
Contas de usuário padrão podem executar e rastrear qualquer alvo via wstrace run <binary>. Processos filhos gerados herdam handles de depuração (PROCESS_ALL_ACCESS) diretamente, sem prompts do UAC. A telemetria de módulos, threads, sockets e I/O depende inteiramente de APIs Win32 sem privilégios.
A elevação é um acelerador, não uma barreira:
run, attach (sessão do usuário), processos filhos (-C), TUI interativa e streaming.wstrace all) para monitorar serviços em segundo plano do SO e daemons do sistema.Execute no PowerShell para instalar automaticamente a versão mais recente em $HOME\.local\bin e adicioná-la ao seu PATH de Usuário:
irm https://raw.githubusercontent.com/gilnett/wstrace/main/packaging/install.ps1 | iex
Instale via bucket pessoal:
scoop bucket add gilnett https://github.com/gilnett/scoop-bucket
scoop install wstrace
Ou instale diretamente via URL:
scoop install https://raw.githubusercontent.com/gilnett/wstrace/main/packaging/scoop/wstrace.json
Descarregue binários autónomos pré-compilados a partir de GitHub Releases.
Instale diretamente a partir do GitHub:
cargo install --git https://github.com/gilnett/wstrace.git
Ou compile localmente a partir de um repositório clonado:
cargo build --release
O binário resultante está localizado em target\release\wstrace.exe.
[!NOTE] Os manifestos do Winget e do Scoop são sincronizados automaticamente com as GitHub Releases publicadas.
[!NOTE] A submissão oficial do pacote está atualmente em processo de revisão e verificação em microsoft/winget-pkgs. Assim que for aprovada e mesclada pelos moderadores da comunidade, poderá ser instalado diretamente via:
winget install gilnett.wstrace
scoop install .\packaging\scoop\wstrace.json
flowchart LR
CLI["CLI Engine<br/><code>run | attach | all</code>"] --> PROBES
subgraph PROBES["Zero-Driver Probes"]
W32["Win32 Debug API<br/>(Proc, Threads, DLLs)"]
NET["IP Helper API<br/>(TCP/UDP Sockets)"]
ETW["Native ETW<br/>(I/O, Registry)"]
end
W32 & NET & ETW -->|TraceEvent| BUS["Lock-Free Bus<br/><code>crossbeam</code>"]
BUS --> TUI["TUI View<br/>(ratatui)"]
BUS --> STREAM["Stream View<br/>(stdout)"]
TUI & STREAM --> OUT["Sinks<br/>(Console, JSON, Clipboard)"]
Confirme que wstrace está acessível no shell atual:
wstrace --version
Inicie um executável de destino com telemetria Win32 e de sistema em tempo real:
wstrace run <executable_path> [-- <arguments>...]
| Tecla | Ação | Descrição |
|---|---|---|
Ctrl+C | Copiar Selecionado | Copia os detalhes do evento destacado para a área de transferência do Windows. |
Ctrl+A | Copiar Tudo | Copia todos os eventos filtrados no momento para a área de transferência do Windows. |
Ctrl+E / Space | Pausar / Retomar | Congela a visualização de eventos sem descartar a telemetria recebida. |
Ctrl+X | Limpar Buffer | Esvazia a lista atual de eventos do buffer de exibição. |
Tab | Ciclo de Categoria | Filtra eventos: ALL -> FILE -> REG -> NET -> PROC. |
f | Apenas Falhas | Restringe a visualização a operações com falha (ex.: acesso negado, não encontrado). |
Up / Down | Navegação | Seleciona um evento para inspeção detalhada. |
q / Esc | Sair | Encerra a sessão de rastreamento de forma limpa. |
Monitore processos ativos, novos processos criados, encerramentos e módulos carregados em todo o sistema em tempo real:
wstrace all
Anexe a um processo existente por PID ou nome do binário sem reiniciá-lo:
# Attach by PID
wstrace attach -p <PID>
# Attach by process name
wstrace attach -n <process_name.exe>
Grava eventos ao vivo diretamente em stdout com códigos de cores ANSI:
wstrace -m stream [-d <seconds>] run <executable_path>
Manual Abrangente & Opções Avançadas: Para filtragem avançada de caminhos (
--include/--exclude), rastreamento de processos filhos (-C), relatórios JSON (--export-json), exportação para a área de transferência (--copy) e opções de script, consulte o Manual de Referência da CLI ou executewstrace --help.
packaging/install.ps1)ToolHelp32Snapshot, OpenProcess, VirtualQueryEx) & Event Tracing for Windows (ETW).x86_64-pc-windows-msvc (Intel / AMD 64-bit)aarch64-pc-windows-msvc (Qualcomm Snapdragon X / Windows on ARM)O wstrace foi projetado para atender aos requisitos institucionais rigorosos de implantação em ambientes empresariais de alta segurança (bancos, defesa, saúde e infraestrutura crítica):