WhatsUpGoldPS

0.1.21

helpers/docker/Get-DockerDashboard.ps1

                                <#

.SYNOPSIS

    Generates an interactive HTML dashboard report for Docker Engine environments.

.DESCRIPTION

    Orchestration script that connects to one or more Docker Engine API endpoints,

    collects container details (CPU, memory, network, block I/O, ports), and

    produces a searchable, sortable Bootstrap Table HTML dashboard. Output

    includes both a JSON data file and a self-contained HTML report.

.PARAMETER DockerHosts

    One or more Docker host addresses (hostname or IP). If omitted, prompts interactively.

.PARAMETER Port

    Docker Engine API port. Defaults to 2375.

.PARAMETER UseTLS

    Use HTTPS instead of HTTP.

.PARAMETER SkipSSLCheck

    Bypass SSL certificate validation for self-signed certificates.

.EXAMPLE

    .\Get-DockerDashboard.ps1

    Prompts for Docker host(s), then generates the dashboard.

.EXAMPLE

    .\Get-DockerDashboard.ps1 -DockerHosts "docker01","docker02" -Port 2375

    Generates a dashboard for multiple Docker hosts.

.EXAMPLE

    .\Get-DockerDashboard.ps1 -DockerHosts "docker01" -Port 2376 -UseTLS -SkipSSLCheck

    Connects via TLS with self-signed cert bypass.

.OUTPUTS

    System.Void

    Produces a JSON file (docker_dashboard.json) and an HTML dashboard

    (Docker-Dashboard.html) in the system temp directory, then opens the HTML in the default browser.

.NOTES

    Author  : jason@wug.ninja

    Version : 1.0.0

    Date    : 2026-03-18

    Requires: PowerShell 5.1+, network access to Docker Engine API, DockerHelpers.ps1 in the same directory.

.LINK

    https://github.com/jayyx2/WhatsUpGoldPS

#>

param (

    [Parameter(Mandatory = $false)]

    [string[]]$DockerHosts,

    [Parameter(Mandatory = $false)]

    [int]$Port = 2375,

    [Parameter(Mandatory = $false)]

    [switch]$UseTLS,

    [Parameter(Mandatory = $false)]

    [switch]$SkipSSLCheck

)

# --- Configuration -----------------------------------------------------------

$helpersPath = Join-Path $PSScriptRoot "DockerHelpers.ps1"

if (Test-Path $helpersPath) {

    . $helpersPath

}

else {

    throw "DockerHelpers.ps1 not found at $helpersPath. Ensure it is in the same directory."

}

if (Get-Module -ListAvailable -Name WhatsUpGoldPS) {

    if (-not (Get-Module -Name WhatsUpGoldPS)) {

        Import-Module -Name WhatsUpGoldPS

    }

}

# --- Input prompts -----------------------------------------------------------

if (-not $DockerHosts -or $DockerHosts.Count -eq 0) {

    $hostInput = Read-Host -Prompt "Enter Docker host(s) - hostname or IP (comma-separated)"

    $DockerHosts = $hostInput -split ',' | ForEach-Object { $_.Trim() } | Where-Object { $_ -ne '' }

}

if (-not $DockerHosts -or $DockerHosts.Count -eq 0) {

    throw "At least one Docker host must be specified."

}

# Output paths

$outputDir = if ($env:TEMP) { $env:TEMP } else { "C:\temp" }

$jsonPath  = Join-Path $outputDir "docker_dashboard.json"

$htmlPath  = Join-Path $outputDir "Docker-Dashboard.html"

if (-not (Test-Path $outputDir)) { New-Item -ItemType Directory -Path $outputDir -Force | Out-Null }

# --- Connect and collect data ------------------------------------------------

$allData = @()

foreach ($host_ in $DockerHosts) {

    $scheme = if ($UseTLS) { 'https' } else { 'http' }

    Write-Host "Connecting to ${scheme}://${host_}:${Port} ..." -ForegroundColor Cyan

    try {

        $splat = @{ DockerHost = $host_; Port = $Port }

        if ($UseTLS) { $splat.UseTLS = $true }

        if ($SkipSSLCheck) { $splat.IgnoreSSLErrors = $true }

        $conn = Connect-DockerServer @splat

        Write-Host "  Connected: Docker $($conn.DockerVersion) on $($conn.OS) ($($conn.Arch))" -ForegroundColor Green

        $data = Get-DockerDashboard -Connection $conn

        if ($data) { $allData += $data }

        $containerCount = @($data | Where-Object { $_.Type -eq 'Container' }).Count

        Write-Host "  Collected $containerCount container(s) from $host_" -ForegroundColor Green

    }

    catch {

        Write-Warning "Failed to connect to ${host_}: $($_.Exception.Message)"

    }

}

if (-not $allData -or $allData.Count -eq 0) {

    Write-Warning "No data collected. Exiting."

    return

}

# --- Summary -----------------------------------------------------------------

$hosts      = @($allData | Where-Object { $_.Type -eq 'Host' }).Count

$containers = @($allData | Where-Object { $_.Type -eq 'Container' }).Count

$running    = @($allData | Where-Object { $_.Type -eq 'Container' -and $_.Status -eq 'running' }).Count

$stopped    = $containers - $running

Write-Host "`n--- Docker Summary ---" -ForegroundColor Yellow

Write-Host "  Docker Hosts : $hosts"  -ForegroundColor Cyan

Write-Host "  Containers   : $containers"

Write-Host "  Running      : $running"  -ForegroundColor Green

Write-Host "  Stopped      : $stopped"  -ForegroundColor Red

# --- Generate outputs --------------------------------------------------------

$allData | ConvertTo-Json -Depth 5 | Out-File $jsonPath -Force -Encoding UTF8

Write-Host "`nJSON data written to $jsonPath" -ForegroundColor Yellow

$templatePath = Join-Path $PSScriptRoot "Docker-Dashboard-Template.html"

Export-DockerDashboardHtml -DashboardData $allData -OutputPath $htmlPath -ReportTitle "Docker Engine Dashboard" -TemplatePath $templatePath

Write-Host "HTML dashboard written to $htmlPath" -ForegroundColor Yellow

# --- Optional: Open in browser -----------------------------------------------

$openBrowser = Read-Host -Prompt "Open dashboard in browser? (Y/N)"

if ($openBrowser -match '^[Yy]') {

    Start-Process $htmlPath

}

Write-Host "`nDone." -ForegroundColor Green

# SIG # Begin signature block

# MIIVlwYJKoZIhvcNAQcCoIIViDCCFYQCAQExDzANBglghkgBZQMEAgEFADB5Bgor

# BgEEAYI3AgEEoGswaTA0BgorBgEEAYI3AgEeMCYCAwEAAAQQH8w7YFlLCE63JNLG

# KX7zUQIBAAIBAAIBAAIBAAIBADAxMA0GCWCGSAFlAwQCAQUABCCEiUmbUdGceZDH

# XEebeVL9WFwp1Yx4mw3xTh4C1BEE7qCCEdMwggVvMIIEV6ADAgECAhBI/JO0YFWU

# jTanyYqJ1pQWMA0GCSqGSIb3DQEBDAUAMHsxCzAJBgNVBAYTAkdCMRswGQYDVQQI

# DBJHcmVhdGVyIE1hbmNoZXN0ZXIxEDAOBgNVBAcMB1NhbGZvcmQxGjAYBgNVBAoM

# EUNvbW9kbyBDQSBMaW1pdGVkMSEwHwYDVQQDDBhBQUEgQ2VydGlmaWNhdGUgU2Vy

# dmljZXMwHhcNMjEwNTI1MDAwMDAwWhcNMjgxMjMxMjM1OTU5WjBWMQswCQYDVQQG

# EwJHQjEYMBYGA1UEChMPU2VjdGlnbyBMaW1pdGVkMS0wKwYDVQQDEyRTZWN0aWdv

# IFB1YmxpYyBDb2RlIFNpZ25pbmcgUm9vdCBSNDYwggIiMA0GCSqGSIb3DQEBAQUA

# A4ICDwAwggIKAoICAQCN55QSIgQkdC7/FiMCkoq2rjaFrEfUI5ErPtx94jGgUW+s

# hJHjUoq14pbe0IdjJImK/+8Skzt9u7aKvb0Ffyeba2XTpQxpsbxJOZrxbW6q5KCD

# J9qaDStQ6Utbs7hkNqR+Sj2pcaths3OzPAsM79szV+W+NDfjlxtd/R8SPYIDdub7

# P2bSlDFp+m2zNKzBenjcklDyZMeqLQSrw2rq4C+np9xu1+j/2iGrQL+57g2extme

# me/G3h+pDHazJyCh1rr9gOcB0u/rgimVcI3/uxXP/tEPNqIuTzKQdEZrRzUTdwUz

# T2MuuC3hv2WnBGsY2HH6zAjybYmZELGt2z4s5KoYsMYHAXVn3m3pY2MeNn9pib6q

# RT5uWl+PoVvLnTCGMOgDs0DGDQ84zWeoU4j6uDBl+m/H5x2xg3RpPqzEaDux5mcz

# mrYI4IAFSEDu9oJkRqj1c7AGlfJsZZ+/VVscnFcax3hGfHCqlBuCF6yH6bbJDoEc

# QNYWFyn8XJwYK+pF9e+91WdPKF4F7pBMeufG9ND8+s0+MkYTIDaKBOq3qgdGnA2T

# OglmmVhcKaO5DKYwODzQRjY1fJy67sPV+Qp2+n4FG0DKkjXp1XrRtX8ArqmQqsV/

# AZwQsRb8zG4Y3G9i/qZQp7h7uJ0VP/4gDHXIIloTlRmQAOka1cKG8eOO7F/05QID

# AQABo4IBEjCCAQ4wHwYDVR0jBBgwFoAUoBEKIz6W8Qfs4q8p74Klf9AwpLQwHQYD

# VR0OBBYEFDLrkpr/NZZILyhAQnAgNpFcF4XmMA4GA1UdDwEB/wQEAwIBhjAPBgNV

# HRMBAf8EBTADAQH/MBMGA1UdJQQMMAoGCCsGAQUFBwMDMBsGA1UdIAQUMBIwBgYE

# VR0gADAIBgZngQwBBAEwQwYDVR0fBDwwOjA4oDagNIYyaHR0cDovL2NybC5jb21v

# ZG9jYS5jb20vQUFBQ2VydGlmaWNhdGVTZXJ2aWNlcy5jcmwwNAYIKwYBBQUHAQEE

# KDAmMCQGCCsGAQUFBzABhhhodHRwOi8vb2NzcC5jb21vZG9jYS5jb20wDQYJKoZI

# hvcNAQEMBQADggEBABK/oe+LdJqYRLhpRrWrJAoMpIpnuDqBv0WKfVIHqI0fTiGF

# OaNrXi0ghr8QuK55O1PNtPvYRL4G2VxjZ9RAFodEhnIq1jIV9RKDwvnhXRFAZ/ZC

# J3LFI+ICOBpMIOLbAffNRk8monxmwFE2tokCVMf8WPtsAO7+mKYulaEMUykfb9gZ

# pk+e96wJ6l2CxouvgKe9gUhShDHaMuwV5KZMPWw5c9QLhTkg4IUaaOGnSDip0TYl

# d8GNGRbFiExmfS9jzpjoad+sPKhdnckcW67Y8y90z7h+9teDnRGWYpquRRPaf9xH

# +9/DUp/mBlXpnYzyOmJRvOwkDynUWICE5EV7WtgwggYaMIIEAqADAgECAhBiHW0M

# UgGeO5B5FSCJIRwKMA0GCSqGSIb3DQEBDAUAMFYxCzAJBgNVBAYTAkdCMRgwFgYD

# VQQKEw9TZWN0aWdvIExpbWl0ZWQxLTArBgNVBAMTJFNlY3RpZ28gUHVibGljIENv

# ZGUgU2lnbmluZyBSb290IFI0NjAeFw0yMTAzMjIwMDAwMDBaFw0zNjAzMjEyMzU5

# NTlaMFQxCzAJBgNVBAYTAkdCMRgwFgYDVQQKEw9TZWN0aWdvIExpbWl0ZWQxKzAp

# BgNVBAMTIlNlY3RpZ28gUHVibGljIENvZGUgU2lnbmluZyBDQSBSMzYwggGiMA0G

# CSqGSIb3DQEBAQUAA4IBjwAwggGKAoIBgQCbK51T+jU/jmAGQ2rAz/V/9shTUxjI

# ztNsfvxYB5UXeWUzCxEeAEZGbEN4QMgCsJLZUKhWThj/yPqy0iSZhXkZ6Pg2A2NV

# DgFigOMYzB2OKhdqfWGVoYW3haT29PSTahYkwmMv0b/83nbeECbiMXhSOtbam+/3

# 6F09fy1tsB8je/RV0mIk8XL/tfCK6cPuYHE215wzrK0h1SWHTxPbPuYkRdkP05Zw

# mRmTnAO5/arnY83jeNzhP06ShdnRqtZlV59+8yv+KIhE5ILMqgOZYAENHNX9SJDm

# +qxp4VqpB3MV/h53yl41aHU5pledi9lCBbH9JeIkNFICiVHNkRmq4TpxtwfvjsUe

# dyz8rNyfQJy/aOs5b4s+ac7IH60B+Ja7TVM+EKv1WuTGwcLmoU3FpOFMbmPj8pz4

# 4MPZ1f9+YEQIQty/NQd/2yGgW+ufflcZ/ZE9o1M7a5Jnqf2i2/uMSWymR8r2oQBM

# dlyh2n5HirY4jKnFH/9gRvd+QOfdRrJZb1sCAwEAAaOCAWQwggFgMB8GA1UdIwQY

# MBaAFDLrkpr/NZZILyhAQnAgNpFcF4XmMB0GA1UdDgQWBBQPKssghyi47G9IritU

# pimqF6TNDDAOBgNVHQ8BAf8EBAMCAYYwEgYDVR0TAQH/BAgwBgEB/wIBADATBgNV

# HSUEDDAKBggrBgEFBQcDAzAbBgNVHSAEFDASMAYGBFUdIAAwCAYGZ4EMAQQBMEsG

# A1UdHwREMEIwQKA+oDyGOmh0dHA6Ly9jcmwuc2VjdGlnby5jb20vU2VjdGlnb1B1

# YmxpY0NvZGVTaWduaW5nUm9vdFI0Ni5jcmwwewYIKwYBBQUHAQEEbzBtMEYGCCsG

# AQUFBzAChjpodHRwOi8vY3J0LnNlY3RpZ28uY29tL1NlY3RpZ29QdWJsaWNDb2Rl

# U2lnbmluZ1Jvb3RSNDYucDdjMCMGCCsGAQUFBzABhhdodHRwOi8vb2NzcC5zZWN0

# aWdvLmNvbTANBgkqhkiG9w0BAQwFAAOCAgEABv+C4XdjNm57oRUgmxP/BP6YdURh

# w1aVcdGRP4Wh60BAscjW4HL9hcpkOTz5jUug2oeunbYAowbFC2AKK+cMcXIBD0Zd

# OaWTsyNyBBsMLHqafvIhrCymlaS98+QpoBCyKppP0OcxYEdU0hpsaqBBIZOtBajj

# cw5+w/KeFvPYfLF/ldYpmlG+vd0xqlqd099iChnyIMvY5HexjO2AmtsbpVn0OhNc

# WbWDRF/3sBp6fWXhz7DcML4iTAWS+MVXeNLj1lJziVKEoroGs9Mlizg0bUMbOalO

# hOfCipnx8CaLZeVme5yELg09Jlo8BMe80jO37PU8ejfkP9/uPak7VLwELKxAMcJs

# zkyeiaerlphwoKx1uHRzNyE6bxuSKcutisqmKL5OTunAvtONEoteSiabkPVSZ2z7

# 6mKnzAfZxCl/3dq3dUNw4rg3sTCggkHSRqTqlLMS7gjrhTqBmzu1L90Y1KWN/Y5J

# KdGvspbOrTfOXyXvmPL6E52z1NZJ6ctuMFBQZH3pwWvqURR8AgQdULUvrxjUYbHH

# j95Ejza63zdrEcxWLDX6xWls/GDnVNueKjWUH3fTv1Y8Wdho698YADR7TNx8X8z2

# Bev6SivBBOHY+uqiirZtg0y9ShQoPzmCcn63Syatatvx157YK9hlcPmVoa1oDE5/

# L9Uo2bC5a4CH2RwwggY+MIIEpqADAgECAhAHnODk0RR/hc05c892LTfrMA0GCSqG

# SIb3DQEBDAUAMFQxCzAJBgNVBAYTAkdCMRgwFgYDVQQKEw9TZWN0aWdvIExpbWl0

# ZWQxKzApBgNVBAMTIlNlY3RpZ28gUHVibGljIENvZGUgU2lnbmluZyBDQSBSMzYw

# HhcNMjYwMjA5MDAwMDAwWhcNMjkwNDIxMjM1OTU5WjBVMQswCQYDVQQGEwJVUzEU

# MBIGA1UECAwLQ29ubmVjdGljdXQxFzAVBgNVBAoMDkphc29uIEFsYmVyaW5vMRcw

# FQYDVQQDDA5KYXNvbiBBbGJlcmlubzCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCC

# AgoCggIBAPN6aN4B1yYWkI5b5TBj3I0VV/peETrHb6EY4BHGxt8Ap+eT+WpEpJyE

# tRYPxEmNJL3A38Bkg7mwzPE3/1NK570ZBCuBjSAn4mSDIgIuXZnvyBO9W1OQs5d6

# 7MlJLUAEufl18tOr3ST1DeO9gSjQSAE5Nql0QDxPnm93OZBon+Fz3CmE+z3MwAe2

# h4KdtRAnCqwM+/V7iBdbw+JOxolpx+7RVjGyProTENIG3pe/hKvPb501lf8uBAAD

# LdjZr5ip8vIWbf857Yw1Bu10nVI7HW3eE8Cl5//d1ribHlzTzQLfttW+k+DaFsKZ

# BBL56l4YAlIVRsrOiE1kdHYYx6IGrEA809R7+TZA9DzGqyFiv9qmJAbL4fDwetDe

# yIq+Oztz1LvEdy8Rcd0JBY+J4S0eDEFIA3X0N8VcLeAwabKb9AjulKXwUeqCJLvN

# 79CJ90UTZb2+I+tamj0dn+IKMEsJ4v4Ggx72sxFr9+6XziodtTg5Luf2xd6+Phha

# mOxF2px9LObhBLLEMyRsCHZIzVZOFKu9BpHQH7ufGB+Sa80Tli0/6LEyn9+bMYWi

# 2ttn6lLOPThXMiQaooRUq6q2u3+F4SaPlxVFLI7OJVMhar6nW6joBvELTJPmANSM

# jDSRFDfHRCdGbZsL/keELJNy+jZctF6VvxQEjFM8/bazu6qYhrA7AgMBAAGjggGJ

# MIIBhTAfBgNVHSMEGDAWgBQPKssghyi47G9IritUpimqF6TNDDAdBgNVHQ4EFgQU

# 6YF0o0D5AVhKHbVocr8GaSIBibAwDgYDVR0PAQH/BAQDAgeAMAwGA1UdEwEB/wQC

# MAAwEwYDVR0lBAwwCgYIKwYBBQUHAwMwSgYDVR0gBEMwQTA1BgwrBgEEAbIxAQIB

# AwIwJTAjBggrBgEFBQcCARYXaHR0cHM6Ly9zZWN0aWdvLmNvbS9DUFMwCAYGZ4EM

# AQQBMEkGA1UdHwRCMEAwPqA8oDqGOGh0dHA6Ly9jcmwuc2VjdGlnby5jb20vU2Vj

# dGlnb1B1YmxpY0NvZGVTaWduaW5nQ0FSMzYuY3JsMHkGCCsGAQUFBwEBBG0wazBE

# BggrBgEFBQcwAoY4aHR0cDovL2NydC5zZWN0aWdvLmNvbS9TZWN0aWdvUHVibGlj

# Q29kZVNpZ25pbmdDQVIzNi5jcnQwIwYIKwYBBQUHMAGGF2h0dHA6Ly9vY3NwLnNl

# Y3RpZ28uY29tMA0GCSqGSIb3DQEBDAUAA4IBgQAEIsm4xnOd/tZMVrKwi3doAXvC

# wOA/RYQnFJD7R/bSQRu3wXEK4o9SIefye18B/q4fhBkhNAJuEvTQAGfqbbpxow03

# J5PrDTp1WPCWbXKX8Oz9vGWJFyJxRGftkdzZ57JE00synEMS8XCwLO9P32MyR9Z9

# URrpiLPJ9rQjfHMb1BUdvaNayomm7aWLAnD+X7jm6o8sNT5An1cwEAob7obWDM6s

# X93wphwJNBJAstH9Ozs6LwISOX6sKS7CKm9N3Kp8hOUue0ZHAtZdFl6o5u12wy+z

# zieGEI50fKnN77FfNKFOWKlS6OJwlArcbFegB5K89LcE5iNSmaM3VMB2ADV1FEcj

# GSHw4lTg1Wx+WMAMdl/7nbvfFxJ9uu5tNiT54B0s+lZO/HztwXYQUczdsFon3pjs

# Nrsk9ZlalBi5SHkIu+F6g7tWiEv3rtVApmJRnLkUr2Xq2a4nbslUCt4jKs5UX4V1

# nSX8OM++AXoyVGO+iTj7z+pl6XE9Gw/Td6WKKKsxggMaMIIDFgIBATBoMFQxCzAJ

# BgNVBAYTAkdCMRgwFgYDVQQKEw9TZWN0aWdvIExpbWl0ZWQxKzApBgNVBAMTIlNl

# Y3RpZ28gUHVibGljIENvZGUgU2lnbmluZyBDQSBSMzYCEAec4OTRFH+FzTlzz3Yt

# N+swDQYJYIZIAWUDBAIBBQCggYQwGAYKKwYBBAGCNwIBDDEKMAigAoAAoQKAADAZ

# BgkqhkiG9w0BCQMxDAYKKwYBBAGCNwIBBDAcBgorBgEEAYI3AgELMQ4wDAYKKwYB

# BAGCNwIBFTAvBgkqhkiG9w0BCQQxIgQg9WMZq3n582qQ2uDF6WFxE/ysPEB7r+T/

# p+yAWv63K8IwDQYJKoZIhvcNAQEBBQAEggIAFDHdlCdY00J9kMqmLdeCXFwvGdH8

# x7uZa32m05ZkzmHDKKiQxIPf4Tkhbf0rM8C8E+IwL9vWwo6hEZbh9zfa2WG2v5AB

# Az9BrmDfO4I+zvXgHxReJjQR16HCG1IYrfDUUKHOR8QHLwUwMaa7rUc/2b2STyUw

# U5s7UJxdLk1+YEie7hF3NX3yIVN3NjtJ02BJI8i5f8bCTDIwia0yzkcdcLfsnkt3

# 6A5djDJ8sO1/3Khs/ykRmZRfj7+hMpytb/GdASnAZmrmH7/8T9+14oJwvLqLLwqN

# R/cXGpSCMrxbHSY51PZXdUsVSlR/CsrDIy9Q4gsNl6vatdwTMC/vLZA4LpN3fSvp

# 9/wRQLnBgQz56dSUGsM/wo/RLBjjGWNv4v2VHlxITy5n3nvqUT00vIn8OlzueyFb

# Lpz8xrPpXrn56HCGQeK+OlYti5HNOnKAepMLx1HmcEpZzKLUTZb6pdT0p64NN7ad

# XPRPwhFCpY0BujhpO+C7FdS8NkT8yHQpdi+7sHjhq+h1KsR0SbX+WuVWjP8DOxcC

# 1AiW+SfoL9fIZ5YBKmjXmbZWxPaIBHBxHibvxpn6CRLoRPv0PLR8bRMIPoZ+0QgK

# YUFDZrX1XnuOUd7VPCQ43hBWKZDNpyE1+fwZfGR7Lun7gaqRelCoMmyPZ53B2aXZ

# iMa46J2XF/xzEmE=

# SIG # End signature block