Files
yttrium-virtio-gpu/Tools/debug/CollectSystemInfo.ps1
T

430 lines
16 KiB
PowerShell

# This script collects various system information for diagnostic
# purposes. The collected data includes system configuration,
# event logs, driver lists, registry information, update logs,
# services, uptime, running processes, installed applications,
# installed KBs, and memory dumps.
# Copyright (c) 2024 Red Hat, Inc. and/or its affiliates. All rights reserved.
# Redistribution and use in source and binary forms, with or without
# modification, are permitted provided that the following conditions
# are met:
# 1. Redistributions of source code must retain the above copyright
# notice, this list of conditions and the following disclaimer.
# 2. Redistributions in binary form must reproduce the above copyright
# notice, this list of conditions and the following disclaimer in the
# documentation and/or other materials provided with the distribution.
# 3. Neither the names of the copyright holders nor the names of their contributors
# may be used to endorse or promote products derived from this software
# without specific prior written permission.
# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
# ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS OR CONTRIBUTORS BE LIABLE
# FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
# DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
# OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
# HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
# LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
# OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
# SUCH DAMAGE.
# Ensure the script runs with an unrestricted execution policy (for Windows 10 and Windows Server 2016)
# Set-ExecutionPolicy -ExecutionPolicy Unrestricted -Scope Process -Force
# For gathering event logs run the script as an administrator
# IncludeSensitiveData is used to include memory dumps add this parameter to your command line to collect them
# Example: .\CollectSystemInfo.ps1 -IncludeSensitiveData
param (
[switch]$IncludeSensitiveData,
[switch]$Help
)
Add-Type -AssemblyName 'System.IO.Compression.FileSystem'
function Compress-Files {
param (
[string]$SourcePath,
[string]$DestinationPath
)
[System.IO.Compression.ZipFile]::CreateFromDirectory($SourcePath, $DestinationPath)
}
function Show-Help {
Write-Host "Usage: .\CollectSystemInfo.ps1 [-IncludeSensitiveData] [-Help]"
Write-Host ""
Write-Host "Parameters:"
Write-Host " -IncludeSensitiveData Include sensitive data (memory dump)"
Write-Host " -Help Show this help message"
Write-Host ""
Write-Host "If no parameters are provided, the script will run with default behavior."
}
function Export-SystemConfiguration {
try {
Write-Host 'Collecting system configuration started it may take a while...'
Start-Process -FilePath 'msinfo32.exe' -ArgumentList '/report', (Join-Path $logfolderPath 'msinfo32.txt') -Wait
Write-Host 'System configuration collection completed.'
} catch {
Write-Warning "Failed to collect system configuration: $_"
}
}
function Export-EventLogs {
try {
$logNames = @('system', 'security', 'application')
foreach ($logName in $logNames) {
$logPath = Join-Path $logfolderPath "$logName.evtx"
wevtutil epl $logName $logPath
wevtutil al $logPath
}
Write-Host 'Event logs collection completed.'
} catch {
Write-Warning "Failed to collect event logs: $_"
}
}
function Get-PerfIOLimits {
param($Drive, $Duration = 60, $Interval = 1)
$disk = if ($Drive -match ':$') { $Drive } else { "${Drive}:" }
$counters = @(
"\LogicalDisk($disk)\Disk Reads/sec", # IOPS (Reads)
"\LogicalDisk($disk)\Disk Writes/sec", # IOPS (Writes)
"\LogicalDisk($disk)\Avg. Disk sec/Read", # Read Latency
"\LogicalDisk($disk)\Avg. Disk sec/Write", # Write Latency
"\LogicalDisk($disk)\Disk Bytes/sec", # Throughput (Total)
"\LogicalDisk($disk)\Disk Read Bytes/sec", # Throughput (Read)
"\LogicalDisk($disk)\Disk Write Bytes/sec",# Throughput (Write)
"\LogicalDisk($disk)\Disk Transfers/sec", # Total I/O Operations
"\LogicalDisk($disk)\Current Disk Queue Length" # Queue Length
)
$maxSamples = [math]::Ceiling($Duration / $Interval)
$data = $null
$out = [ordered]@{}
foreach ($path in $counters) {
$out[$path] = "PerfCounter Error"
}
try {
$data = Get-Counter -Counter $counters -SampleInterval $Interval -MaxSamples $maxSamples -ErrorAction Stop
foreach ($path in $counters) {
$vals = $data.CounterSamples |
Where-Object Path -like "*$path" |
Select-Object -ExpandProperty CookedValue
if ($vals.Count -eq 0) {
$out[$path] = "N/A" # Keep N/A if counter exists but has no values
continue
}
if ($path -match 'Reads/sec|Writes/sec|Transfers/sec') {
$maxValue = (@($vals) | Measure-Object -Maximum).Maximum
$out[$path] = "{0:N2} IOPS" -f $maxValue
} elseif ($path -match 'Bytes/sec') {
$maxValue = (@($vals) | Measure-Object -Maximum).Maximum
$out[$path] = "{0:N2} KB/s" -f ($maxValue / 1024)
} else {
$minValue = (@($vals) | Measure-Object -Minimum).Minimum
$ms = $minValue * 1000
$out[$path] = "{0:N2} ms" -f $ms
}
}
} catch {
Write-Warning "Failed to get performance counters for drive $disk. Error: $($_.Exception.Message)"
}
return $out
}
function Test-WinSatDisk {
param($Drive)
$ErrorActionPreference = 'SilentlyContinue'
$seqOutput = Invoke-Command { winsat disk -seq -read -drive $Drive } 2>&1
$ranOutput = Invoke-Command { winsat disk -ran -write -drive $Drive } 2>&1
$ErrorActionPreference = 'Continue'
$seqVal = $null
$ranVal = $null
foreach ($line in $seqOutput) {
if ($line -match 'Disk\s+Sequential\s+\d+(\.\d+)?\s+Read\s+([\d\.]+)\s+MB/s') {
$seqVal = $matches[2] + " MB/s"
break
}
}
foreach ($line in $ranOutput) {
if ($line -match 'Disk\s+Random\s+\d+(\.\d+)?\s+Write\s+([\d\.]+)\s+MB/s') {
$ranVal = $matches[2] + " MB/s"
break
}
}
if (-not $seqVal) {
$seqVal = ($seqOutput | Select-String 'Sequential Read' | ForEach-Object { ($_ -split ':\s*', 2)[-1].Trim() }) -join ''
}
if (-not $ranVal) {
$ranVal = ($ranOutput | Select-String 'Random Write' | ForEach-Object { ($_ -split ':\s*', 2)[-1].Trim() }) -join ''
}
$result = [pscustomobject]@{
SequentialRead = if ($seqVal -and $seqVal -notmatch '^\s*$') { $seqVal } else { 'N/A' }
RandomWrite = if ($ranVal -and $ranVal -notmatch '^\s*$') { $ranVal } else { 'N/A' }
}
return $result
}
function Export-IOLimits {
param($Duration = 60, $Interval = 1)
try {
$disks = Get-Disk
foreach ($disk in $disks) {
$parts = Get-Partition -DiskNumber $disk.Number | Where-Object DriveLetter
foreach ($p in $parts) {
$drive = "$($p.DriveLetter):"
$perf = Get-PerfIOLimits -Drive $drive -Duration $Duration -Interval $Interval
$ws = Test-WinSatDisk -Drive $drive
$outFile = Join-Path $logfolderPath "IOLimits_$($p.DriveLetter).txt"
$perf.GetEnumerator() | ForEach-Object {
"$($_.Key): $($_.Value)" | Out-File -FilePath $outFile -Append
}
"SequentialRead: $($ws.SequentialRead)" | Out-File -FilePath $outFile -Append
"RandomWrite: $($ws.RandomWrite)" | Out-File -FilePath $outFile -Append
"Drive $drive I/O limits saved to $outFile" |
Out-File -FilePath (Join-Path $logfolderPath 'IOLimits.txt') -Append
}
}
Write-Host 'IO Limits collection completed.'
} catch {
Write-Warning "Failed to collect IO Limits: $_"
}
}
function Export-DriversList {
try {
Get-WindowsDriver -Online -All | Select-Object -Property * | Export-Csv -Path (Join-Path $logfolderPath 'drv_list.csv') -NoTypeInformation
Write-Host 'Drivers list collection completed.'
} catch {
Write-Warning "Failed to collect drivers list: $_"
}
}
function Export-VirtioWinStorageDrivers {
$registryPaths = @(
'HKLM:\SYSTEM\CurrentControlSet\Services\Disk',
'HKLM:\SYSTEM\CurrentControlSet\Services\viostor\Parameters',
'HKLM:\SYSTEM\CurrentControlSet\Services\vioscsi\Parameters'
)
$valuesToQuery = @('IoTimeoutValue', 'TimeoutValue')
foreach ($path in $registryPaths) {
foreach ($value in $valuesToQuery) {
$property = Get-ItemProperty -Path $path -Name $value -ErrorAction SilentlyContinue
$output = "$path\$value : $($property.$value)"
$output | Out-File -FilePath (Join-Path $logfolderPath 'virtio_disk.txt') -Append
}
}
Write-Host 'Virtio-Win storage drivers configuration collection completed.'
}
function Export-WindowsUpdateLogs {
try {
$logPath = Join-Path $logfolderPath 'WindowsUpdate.log'
$command = "Get-WindowsUpdateLog -LogPath '$logPath'"
Start-Process -FilePath 'powershell.exe' -ArgumentList '-NoLogo', '-NoProfile', '-Command', $command -NoNewWindow -Wait -RedirectStandardOutput (Join-Path $logfolderPath 'OutputWindowsUpdate.log') -RedirectStandardError (Join-Path $logfolderPath 'ErrorWindowsUpdate.log')
Write-Host 'Windows Update logs collection completed.'
} catch {
Write-Warning "Failed to collect Windows Update logs: $_"
}
}
function Export-WindowsUptime {
try {
$uptime = (Get-Date) - (gcim Win32_OperatingSystem).LastBootUpTime
$uptime.ToString() | Out-File -FilePath (Join-Path $logfolderPath 'WindowsUptime.txt')
Write-Host 'Windows uptime collection completed.'
} catch {
Write-Warning "Failed to collect Windows uptime: $_"
}
}
function Export-ServicesList {
try {
Get-Service | Select-Object -Property Name, DisplayName, Status, StartType | Export-Csv -Path (Join-Path $logfolderPath 'Services.csv') -NoTypeInformation
Write-Host 'Services list collection completed.'
} catch {
Write-Warning "Failed to collect list of services: $_"
}
}
function Export-RunningProcesses {
try {
Get-Process | Select-Object -Property Id, ProcessName, StartTime | Export-Csv -Path (Join-Path $logfolderPath 'RunningProcesses.csv') -NoTypeInformation
Write-Host 'Running processes collection completed.'
} catch {
Write-Warning "Failed to collect list of running processes: $_"
}
}
function Export-InstalledApplications {
try {
Get-ItemProperty -Path 'HKLM:\Software\Microsoft\Windows\CurrentVersion\Uninstall\*' |
Select-Object -Property DisplayName, DisplayVersion, Publisher, InstallDate |
Export-Csv -Path (Join-Path $logfolderPath 'InstalledApplications.csv') -NoTypeInformation
Write-Host 'Installed applications collection completed.'
} catch {
Write-Warning "Failed to collect list of installed applications: $_"
}
}
function Export-InstalledKBs {
try {
Get-HotFix | Select-Object -Property Description, HotFixID, InstalledOn | Export-Csv -Path (Join-Path $logfolderPath 'InstalledKBs.csv') -NoTypeInformation
Write-Host 'Installed KBs collection completed.'
} catch {
Write-Warning "Failed to collect list of installed KBs: $_"
}
}
function Export-NetworkConfiguration {
try {
Get-NetAdapterAdvancedProperty | Out-File -FilePath (Join-Path $logfolderPath 'NetworkInterfaces.txt')
ipconfig /all | Out-File -FilePath (Join-Path $logfolderPath 'IPConfiguration.txt')
Write-Host 'Network configuration collection completed.'
} catch {
Write-Warning "Failed to collect network configuration: $_"
}
}
function Export-WindowsMemoryDump {
$memoryDumpPaths = @("$env:SystemRoot\MEMORY.DMP", "$env:SystemRoot\Minidump")
foreach ($dump in $memoryDumpPaths) {
Copy-Item -Path $dump -Destination $dumpfolderPath -Recurse -ErrorAction SilentlyContinue
}
Write-Host 'Windows memory dump collection completed.'
}
function Export-SetupAPILogs {
try {
$infPath = "$env:SystemRoot\INF"
$files = Get-ChildItem -Path $infPath -Filter 'setupapi*.log'
if (Test-Path "$env:SystemRoot\setupapi.log") {
$files += Get-Item "$env:SystemRoot\setupapi.log"
}
foreach ($file in $files) {
try {
Copy-Item -Path $file.FullName -Destination $logfolderPath -ErrorAction Stop
} catch {
Write-Warning "Failed to copy $($file.Name): $_"
}
}
Write-Host 'SetupAPI logs collection completed.'
} catch {
Write-Warning "Failed to collect SetupAPI logs: $_"
}
}
function Write-InformationToArchive {
param (
[string]$FolderPath,
[string]$SubFolderPath,
[string]$ArchiveFileName
)
try {
$archivePath = Join-Path -Path $FolderPath -ChildPath "$ArchiveFileName.zip"
Compress-Files -SourcePath $SubFolderPath -DestinationPath $archivePath
Write-Host "Archiving completed ($ArchiveFileName.zip)."
} catch {
Write-Warning "Failed to archive ($ArchiveFileName.zip): $_"
}
}
function StopTranscriptAndCloseFile {
if ($transcriptStarted) {
Stop-Transcript | Out-Null
$transcriptStarted = $false
}
}
$validParams = @('IncludeSensitiveData', 'Help')
if ($Help -or $args -contains '-?' -or $args -contains '--Help') {
Show-Help
return
}
foreach ($param in $args) {
if ($param -notlike '-*' -or ($param -like '-*' -and $validParams -notcontains $param.TrimStart('-'))) {
Write-Host "A parameter cannot be found that matches parameter name '$param'"
Show-Help
return
}
}
$breakHandler = {
Write-Host "Script interrupted by user. Stopping transcript..."
StopTranscriptAndCloseFile
exit
}
Register-EngineEvent -SourceIdentifier ConsoleBreak -Action $breakHandler | Out-Null
Register-EngineEvent -SourceIdentifier PowerShell.Exiting -Action $breakHandler | Out-Null
$timestamp = Get-Date -Format 'yyyy-MM-dd_HH-mm-ss'
$folderName = "SystemInfo_$timestamp"
$logfolderName = "Log_folder_$timestamp"
$dumpfolderName = "Dump_folder_$timestamp"
$folderPath = Join-Path -Path (Get-Location) -ChildPath $folderName
$logfolderPath = Join-Path -Path $folderPath -ChildPath $logfolderName
$dumpfolderPath = Join-Path -Path $folderPath -ChildPath $dumpfolderName
$progressFile = "$folderPath\Collecting_Status.txt"
New-Item -Path $logfolderPath -ItemType Directory | Out-Null
New-Item -Path $progressFile -ItemType File | Out-Null
Write-Host "Starting system info collecting into $folderPath"
Write-Output "Log folder path: $logfolderPath"
try {
Start-Transcript -Path $progressFile -Append
$transcriptStarted = $true
Export-IOLimits
Export-SystemConfiguration
Export-EventLogs
Export-DriversList
Export-VirtioWinStorageDrivers
Export-WindowsUpdateLogs
Export-ServicesList
Export-WindowsUptime
Export-RunningProcesses
Export-InstalledApplications
Export-InstalledKBs
Export-NetworkConfiguration
Export-SetupAPILogs
if ($IncludeSensitiveData) {
Write-Output "Dump folder path: $dumpfolderPath"
New-Item -Path $dumpfolderPath -ItemType Directory | Out-Null
Export-WindowsMemoryDump
}
} catch {
$errorMsg = "An error occurred: $_"
Write-Host $errorMsg
Add-Content -Path $progressFile -Value $errorMsg
} finally {
StopTranscriptAndCloseFile
Unregister-Event -SourceIdentifier ConsoleBreak
Unregister-Event -SourceIdentifier PowerShell.Exiting
}
Remove-Item -Path $progressFile -ErrorAction SilentlyContinue
Write-InformationToArchive -FolderPath $folderPath -SubFolderPath $logfolderPath -ArchiveFileName $logfolderName
if ($IncludeSensitiveData) {
Write-InformationToArchive -FolderPath $folderPath -SubFolderPath $dumpfolderPath -ArchiveFileName $dumpfolderName
}