TP N°9 : Notifier une alerte critique via un webhook, et exposer le rapport via une mini-API

Partie 1 — webhook d’alerte :

$serveurs = Get-Content -Path ".\serveurs.txt"

$resultats = Invoke-Command -ComputerName $serveurs -ScriptBlock {
    $volume = Get-Volume -DriveLetter C
    [PSCustomObject]@{
        EspaceLibrePourcent = [math]::Round(($volume.SizeRemaining / $volume.Size) * 100, 1)
    }
} -ErrorAction SilentlyContinue

$serveursCritiques = $resultats | Where-Object { $_.EspaceLibrePourcent -lt 20 }

if ($serveursCritiques) {
    $listeServeurs = ($serveursCritiques | ForEach-Object { "$($_.PSComputerName) : $($_.EspaceLibrePourcent)%" }) -join "`n"

    $corpsMessage = @{
        text = "⚠️ Alerte espace disque Nordika`n$listeServeurs"
    } | ConvertTo-Json

    try {
        Invoke-RestMethod -Uri $env:NORDIKA_WEBHOOK_TEAMS -Method Post -Body $corpsMessage -ContentType "application/json"
        Write-Output "Alerte envoyée pour $($serveursCritiques.Count) serveur(s)"
    } catch {
        Write-Warning "Échec de l'envoi du webhook : $($_.Exception.Message)"
    }
} else {
    Write-Output "Aucun serveur critique, pas de notification envoyée"
}

Partie 2 — api-supervision.ps1 :

Start-PodeServer {
    Add-PodeEndpoint -Address localhost -Port 8080 -Protocol Http

    Add-PodeRoute -Method Get -Path '/api/supervision' -ScriptBlock {
        $serveurs = Get-Content -Path "C:\Nordika\Scripts\serveurs.txt"

        $resultats = Invoke-Command -ComputerName $serveurs -ScriptBlock {
            $volume = Get-Volume -DriveLetter C
            [PSCustomObject]@{
                Serveur             = $env:COMPUTERNAME
                EspaceLibrePourcent = [math]::Round(($volume.SizeRemaining / $volume.Size) * 100, 1)
            }
        } -ErrorAction SilentlyContinue

        Write-PodeJsonResponse -Value $resultats
    }

    # Étape 6 (bonus)
    Add-PodeRoute -Method Get -Path '/api/supervision/critiques' -ScriptBlock {
        $serveurs = Get-Content -Path "C:\Nordika\Scripts\serveurs.txt"

        $resultats = Invoke-Command -ComputerName $serveurs -ScriptBlock {
            $volume = Get-Volume -DriveLetter C
            [PSCustomObject]@{
                Serveur             = $env:COMPUTERNAME
                EspaceLibrePourcent = [math]::Round(($volume.SizeRemaining / $volume.Size) * 100, 1)
            }
        } -ErrorAction SilentlyContinue

        $critiques = $resultats | Where-Object { $_.EspaceLibrePourcent -lt 20 }
        Write-PodeJsonResponse -Value $critiques
    }
}

Points clés à retenir :

• $env:NORDIKA_WEBHOOK_TEAMS : l’URL du webhook, considérée comme un secret (elle permet à quiconque de poster dans le salon), n’est jamais codée en dur — cohérent avec le principe posé dès la leçon 9.2.
• Le try/catch autour du webhook garantit qu’une notification Teams en échec (service indisponible, URL expirée) ne fait pas planter tout le script de supervision.
• La route bonus /api/supervision/critiques réutilise exactement la même logique Where-Object que la Partie 1 — une belle illustration que les mêmes réflexes de filtrage, vus dès la section 2, s’appliquent aussi bien à un script de notification qu’à une route d’API.