Amostragem de contadores de desempenho do Windows Server com Get-Counter e exportação para CSV

Objetivo

Coletar ao longo do tempo um conjunto definido de contadores de desempenho do Windows a partir do PowerShell, gravá-los em um arquivo que sobreviva à sessão e converter entre formatos para análise posterior.

Pré-requisitos

PowerShell no Windows Server (o módulo integrado Microsoft.PowerShell.Diagnostics; o Export-Counter existe apenas no Windows PowerShell 5.1, não no PowerShell 7); a leitura local da maioria dos contadores funciona sem elevação, enquanto a leitura de um computador remoto exige ser membro de Performance Monitor Users ou de Administrators nele; espaço livre em disco suficiente, já que a saída cresce com o número de amostras e de contadores.

Passos

1. Colete um primeiro conjunto de amostras que cubra os quatro recursos clássicos: Get-Counter -Counter '\Processor(_Total)\% Processor Time','\Memory\Available MBytes','\PhysicalDisk(_Total)\Avg. Disk sec/Read','\Network Interface(*)\Bytes Total/sec' -SampleInterval 2 -MaxSamples 30. A documentação do Get-Counter descreve -SampleInterval como o número de segundos entre as amostras e -MaxSamples como a quantidade de amostras a coletar antes de parar.
2. Para uma captura sem prazo definido durante um incidente, use -Continuous no lugar de -MaxSamples; a mesma documentação o descreve como coleta até ser interrompida explicitamente (Ctrl+C ou Stop-Job em um job em segundo plano).
3. Preserve as amostras brutas e tipadas em vez de achatá-las de imediato: Get-Counter ... -Continuous | Export-Counter -Path C:\perf\capture.blg -FileFormat BLG. A documentação do Export-Counter lista valores de -FileFormat que incluem BLG (o formato binário nativo de log de desempenho) e CSV; gravar primeiro em BLG mantém todos os campos, mesmo que a ferramenta de análise final prefira outro formato. Execute isso no Windows PowerShell 5.1 (powershell.exe); para sobrescrever um arquivo de saída existente é necessário usar -Force.
4. Limite a captura com um -MaxSamples calculado (intervalo × amostras = janela), em vez de depender de alguém para interrompê-la. Um job em segundo plano (Start-Job) termina quando a sessão do PowerShell que o iniciou é fechada; para uma captura que precisa sobreviver à sessão, execute o script como tarefa agendada (ou use um conjunto de coletores de dados do logman).
5. Converta a captura depois: relog C:\perf\capture.blg -f CSV -o C:\perf\capture.csv. A referência de linha de comando do relog o descreve como um comando que extrai dados de contadores de desempenho e os converte para o formato indicado em -f; assim, um .blg capturado em campo ainda pode ser convertido para CSV mais tarde, mesmo sem o comando Export-Counter original.
6. Para ter uma visão ao vivo, sem configuração, das mesmas categorias no console, o Monitor de Recursos (resmon.exe) mostra as visões equivalentes de CPU, memória, disco e rede sem precisar de script.

Resultado esperado

Um arquivo .blg (e, depois do relog, um .csv) contendo todas as amostras dos contadores solicitados ao longo de toda a janela de captura, que sobrevive à sessão quando foi executado como tarefa agendada.

Limites e base de verificação

O conjunto de contadores e os nomes dos contadores são localizados: em uma instalação do Windows que não esteja em inglês, os caminhos em inglês acima falham e é preciso usar os nomes locais (Get-Counter -ListSet * mostra os nomes e caminhos que a máquina realmente usa). A sintaxe de instância com curinga ((*)) precisa corresponder a instâncias que existam; um conjunto de contadores que exige uma função ou um driver não instalado retorna um erro, e não zero.