Guide system diagnosis

System Diagnosis Module - Vollständiger Guide

Version: 3.1.0 ✅ (Neu)
Status: Produktionsbereit

---

📋 Übersicht

Das VelinScript System Diagnosis Modul ist ein umfassendes Tool zur Überwachung und Analyse von Systemressourcen, Sicherheit und Services. Es bietet:

• ✅ Vollständige Systemressourcen-Überprüfung (CPU, Memory, Disk, Network)
• ✅ Umfassende Sicherheitsprüfungen (Auth, Encryption, Certificates, etc.)
• ✅ Service-Status-Überwachung
• ✅ Log-Analyse mit Pattern-Erkennung
• ✅ Automatische Empfehlungen basierend auf Diagnose-Ergebnissen
• ✅ Health-Score-Berechnung (0-100)
• ✅ Vollständige Test-Suite (20+ Tests)

---

🚀 Schnellstart

Installation

use system_diagnosis;
use security_checks;

Vollständige Diagnose

// Alle Checks durchführen
let report = system_diagnosis.runFullDiagnosis();

println("Status: " + report.overallStatus);
println("Score: " + report.score);
println("Empfehlungen: " + report.recommendations.length);

Einzelne Checks

// Nur Ressourcen
let resources = system_diagnosis.checkResources();

// Nur Sicherheit
let security = security_checks.runSecurityChecks();

// Nur Services
let services = system_diagnosis.checkServices();

Als API-Endpoint

@GET("/api/health")
fn getHealth(): string {
    let report = system_diagnosis.runFullDiagnosis();
    return json.stringify({
        status: report.overallStatus,
        score: report.score,
        timestamp: report.timestamp,
    });
}

---

📊 Hauptfunktionen

Systemdiagnose

Funktion	Beschreibung
runFullDiagnosis()	Vollständige Systemdiagnose
checkResources()	Alle Systemressourcen prüfen
checkServices()	Services überprüfen
analyzeLogs()	Log-Analyse durchführen
collectSystemInfo()	System-Informationen sammeln

Sicherheitsprüfungen

Funktion	Beschreibung
checkAuthentication()	Authentifizierung prüfen
checkEncryption()	Verschlüsselung prüfen
checkCertificates()	Zertifikate prüfen
checkFirewall()	Firewall-Status prüfen
scanVulnerabilities()	Nach Vulnerabilities scannen

---

🔍 Systemressourcen

CPU-Überwachung

let cpu = resources.cpu;
println("Auslastung: " + cpu.usage + "%");
println("Kerne: " + cpu.cores);
println("Status: " + cpu.status);  // "healthy" | "warning" | "critical"

Memory-Überwachung

let mem = resources.memory;
println("Gesamt: " + mem.total + " bytes");
println("Benutzt: " + mem.used + " bytes");
println("Auslastung: " + mem.usagePercent + "%");

Disk-Überwachung

let disk = resources.disk;
println("Festplattenauslastung: " + disk.usagePercent + "%");
println("Partitionen: " + disk.partitions.length);

Network-Überwachung

let net = resources.network;
println("Latenz: " + net.latency + "ms");
println("Bytes empfangen: " + net.totalBytesIn);
println("Bytes gesendet: " + net.totalBytesOut);

---

🔒 Sicherheitsprüfungen

Authentifizierung & Autorisierung

• ✅ JWT/OAuth2-Verwendung
• ✅ RBAC-System
• ✅ Passwort-Richtlinien
• ✅ Session-Sicherheit

Verschlüsselung & Zertifikate

• ✅ Verschlüsselungs-Algorithmen
• ✅ Zertifikats-Gültigkeit
• ✅ TLS-Konfiguration

Netzwerk-Sicherheit

• ✅ Firewall-Status
• ✅ Offene Ports
• ✅ Netzwerk-Verschlüsselung

Sicherheits-Score

let security = security_checks.runSecurityChecks();
println("Score: " + security.score);  // 0-100
println("Status: " + security.overallStatus);  // "secure" | "warning" | "vulnerable"

// Vulnerabilities ausgeben
for (vuln in security.vulnerabilities) {
    if (vuln.severity == "critical") {
        println("KRITISCH: " + vuln.name);
    }
}

---

📈 Health-Score-Berechnung

Der Health-Score wird aus folgenden Komponenten berechnet:

• Ressourcen (40%): CPU, Memory, Disk, Network
• Sicherheit (30%): Alle Sicherheitsprüfungen
• Services (20%): Service-Status
• Logs (10%): Fehlerrate in Logs

Score-Bereiche

• 90-100: Exzellent 🟢
• 70-89: Gut 🟡
• 50-69: Akzeptabel 🟠
• 30-49: Problematisch 🔴
• 0-29: Kritisch ⛔

---

🔧 Integration mit Monitoring

Prometheus

@GET("/metrics")
fn getMetrics(): string {
    let report = system_diagnosis.runFullDiagnosis();
    return "system_health_score " + report.score + "\n" +
           "system_cpu_usage " + report.resources.cpu.usage + "\n";
}

Grafana

Nutze die /metrics Endpoint mit Prometheus als Datenquelle.

Scheduled Monitoring

@scheduled("*/5 * * * *")  // Alle 5 Minuten
fn monitorSystem() {
    let report = system_diagnosis.runFullDiagnosis();
    
    metrics.record("system.health_score", report.score);
    metrics.record("system.cpu_usage", report.resources.cpu.usage);
    metrics.record("system.security_score", report.security.score);
    
    if (report.score < 50) {
        alerting.sendCritical("Health Score kritisch!");
    }
}

---

🧪 Tests ausführen

velin test examples/system-diagnosis/tests/system_diagnosis_test.velin

Test-Suite:

• ✅ 20+ vollständige Tests
• ✅ Systemdiagnose-Tests
• ✅ Sicherheits-Tests
• ✅ Integration-Tests
• ✅ 100% Erfolgsquote

---

📚 Weitere Ressourcen

• System-Diagnose API-Dokumentation - Vollständige API-Referenz
• Beispiel-Projekte - Komplette Beispiele
• CHANGELOG - Alle Änderungen in 3.1.0

---

Erstellt: 2026-02-02
Version: 3.1.0