Muestreo de contadores de rendimiento de Windows Server con Get-Counter y exportación a CSV

Objetivo

Recopilar con PowerShell un conjunto definido de contadores de rendimiento de Windows a lo largo del tiempo, guardarlo en un archivo que sobreviva a la sesión y convertirlo entre formatos para su análisis posterior.

Requisitos previos

PowerShell en Windows Server (el módulo integrado Microsoft.PowerShell.Diagnostics; Export-Counter existe solo en Windows PowerShell 5.1, no en PowerShell 7). La lectura local de la mayoría de los contadores funciona sin privilegios elevados, mientras que para leer desde un equipo remoto se necesita pertenecer allí al grupo Usuarios del monitor de rendimiento (Performance Monitor Users) o Administradores (Administrators). Además, hace falta suficiente espacio libre en disco, ya que el tamaño de la salida crece con el número de muestras y de contadores.

Pasos

1. Tome un primer conjunto de muestras que cubra los cuatro recursos clásicos: 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. La documentación de Get-Counter describe -SampleInterval como el número de segundos entre muestras y -MaxSamples como la cantidad de muestras que se recopilan antes de detenerse.
2. Para una captura de duración indefinida durante un incidente, use -Continuous en lugar de -MaxSamples; la misma documentación lo describe como un muestreo que continúa hasta que se detiene de forma explícita (Ctrl+C, o Stop-Job si se ejecuta como trabajo en segundo plano).
3. Conserve las muestras originales con sus tipos en lugar de aplanarlas de inmediato: Get-Counter ... -Continuous | Export-Counter -Path C:\perf\capture.blg -FileFormat BLG. La documentación de Export-Counter enumera para -FileFormat valores como BLG (el formato binario nativo de registros de rendimiento) y CSV; escribir primero en BLG conserva todos los campos, aunque la herramienta de análisis final prefiera otro formato. Ejecute este comando en Windows PowerShell 5.1 (powershell.exe); para sobrescribir un archivo de salida existente se necesita -Force.
4. Acote la captura con un -MaxSamples calculado (intervalo × muestras = ventana) en lugar de depender de que alguien la interrumpa. Un trabajo en segundo plano (Start-Job) termina cuando se cierra la sesión de PowerShell que lo inició; para una captura que deba sobrevivir a la sesión, ejecute el script como tarea programada (o use un conjunto de recopiladores de datos de logman).
5. Convierta la captura después: relog C:\perf\capture.blg -f CSV -o C:\perf\capture.csv. La referencia de línea de comandos de relog lo describe como una herramienta que extrae datos de contadores de rendimiento y los convierte al formato indicado con -f; por tanto, un .blg capturado sobre el terreno puede transformarse más tarde en CSV aunque no se disponga del comando Export-Counter original.
6. Para obtener en la consola una vista en vivo y sin configuración de las mismas categorías, el Monitor de recursos (resmon.exe) muestra las vistas equivalentes de CPU, memoria, disco y red sin necesidad de un script.

Resultado esperado

Un archivo .blg (y, tras relog, un .csv) que contiene todas las muestras de los contadores solicitados a lo largo de toda la ventana de captura y que sobrevive a la sesión cuando se ejecutó como tarea programada.

Límites y base de verificación

El conjunto de contadores y los nombres de los contadores están localizados: en una instalación de Windows que no esté en inglés, las rutas en inglés anteriores fallan y hay que usar los nombres locales (Get-Counter -ListSet * muestra los nombres y rutas que el equipo utiliza realmente). La sintaxis de instancia con comodín ((*)) debe coincidir con instancias que existan; un conjunto de contadores que requiere un rol o un controlador no instalado devuelve un error en lugar de un cero.