====== Runbook: Logs prüfen ======

<WRAP round info>
**Dauer:** ~10 Minuten \\
**Rolle:** Gateway-Operator \\
**Häufigkeit:** Täglich / Bei Problemen
</WRAP>

Analyse der Gateway-Logs für Fehlerdiagnose und Monitoring.

----

===== Workflow =====

<mermaid>
flowchart TD
    A[Logs öffnen] --> B[Nach ERROR filtern]
    B --> C{Fehler gefunden?}
    C -->|Ja| D[Fehler analysieren]
    C -->|Nein| E[Nach WARN filtern]
    D --> F[Maßnahme ergreifen]
    E --> G{Warnungen?}
    G -->|Ja| H[Dokumentieren]
    G -->|Nein| I[OK - Fertig]
    F --> I
    H --> I

    style I fill:#e8f5e9
    style D fill:#ffebee
    style H fill:#fff3e0
</mermaid>

----

===== 1. Log-Speicherorte =====

| Plattform | Pfad |
|-----------|------|
| Windows (Konsole) | Konsolenausgabe |
| Windows (Service) | ''%GATEWAY_ROOT%\logs\'' oder Event Log |
| Linux (systemd) | ''journalctl -u data-gateway'' |
| Docker | ''docker logs gateway'' |

----

===== 2. Letzte Logs anzeigen =====

**Windows (Datei):**

<code powershell>
# Letzte 50 Zeilen
Get-Content -Path "%GATEWAY_ROOT%\logs\gateway.log" -Tail 50

# Live-Tail
Get-Content -Path "%GATEWAY_ROOT%\logs\gateway.log" -Wait -Tail 10
</code>

**Linux (systemd):**

<code bash>
# Letzte 100 Zeilen
journalctl -u data-gateway -n 100 --no-pager

# Live-Tail
journalctl -u data-gateway -f
</code>

**Docker:**

<code bash>
# Letzte 100 Zeilen
docker logs --tail 100 gateway

# Live-Tail
docker logs -f gateway
</code>

----

===== 3. Nach Fehlern filtern =====

**Windows:**

<code powershell>
# ERROR-Einträge
Select-String -Path "%GATEWAY_ROOT%\logs\*.log" -Pattern "ERROR|Exception"

# Heute
Get-Content "%GATEWAY_ROOT%\logs\gateway.log" | Where-Object { $_ -match "ERROR" -and $_ -match (Get-Date -Format "yyyy-MM-dd") }
</code>

**Linux:**

<code bash>
# ERROR-Einträge
journalctl -u data-gateway --since today | grep -E "ERROR|Exception"

# Oder in Datei
grep -E "ERROR|Exception" /var/log/gateway/gateway.log
</code>

----

===== 4. Häufige Log-Muster =====

**Erfolgreiche Anfrage:**
<code>
[INFO] GET /api/v1/dsn/demo/tables 200 45ms
</code>

**Fehler:**
<code>
[ERROR] GET /api/v1/dsn/invalid/tables 404 Database 'invalid' not found
[ERROR] POST /api/v1/dsn/demo/query 500 SqlException: Invalid syntax
</code>

**Warnung:**
<code>
[WARN] Slow query detected: 2340ms for GET /api/v1/dsn/produktion/tables/BigTable
</code>

----

===== 5. Log-Level anpassen =====

In ''appsettings.json'':

<code javascript>
{
  "Logging": {
    "LogLevel": {
      "Default": "Information",
      "Microsoft": "Warning",
      "WvdS.WebAPI.Data.Gateway": "Debug"
    }
  }
}
</code>

| Level | Verwendung |
|-------|------------|
| ''Trace'' | Sehr detailliert (Entwicklung) |
| ''Debug'' | Debugging-Informationen |
| ''Information'' | Normale Operationen (Standard) |
| ''Warning'' | Potenzielle Probleme |
| ''Error'' | Fehler, die behandelt wurden |
| ''Critical'' | Schwere Fehler, Absturz |

----

===== 6. Checkliste =====

| # | Prüfpunkt | ✓ |
|---|-----------|---|
| 1 | ERROR-Einträge durchgesehen | ☐ |
| 2 | WARN-Einträge durchgesehen | ☐ |
| 3 | Slow Queries notiert | ☐ |
| 4 | Fehler dokumentiert/gemeldet | ☐ |
| 5 | Log-Rotation aktiv | ☐ |

----

===== Troubleshooting =====

| Log-Meldung | Ursache | Lösung |
|-------------|---------|--------|
| ''Database not found'' | DSN nicht konfiguriert | appsettings.json prüfen |
| ''Connection refused'' | DB nicht erreichbar | Firewall/Netzwerk prüfen |
| ''SqlException: Login failed'' | Falsche Credentials | Passwort prüfen |
| ''OutOfMemoryException'' | Zu große Abfrage | ''$top'' Limit setzen |
| ''Timeout expired'' | DB zu langsam | Index optimieren |

----

===== Log-Rotation einrichten =====

**Serilog (appsettings.json):**

<code javascript>
{
  "Serilog": {
    "WriteTo": [
      {
        "Name": "File",
        "Args": {
          "path": "logs/gateway-.log",
          "rollingInterval": "Day",
          "retainedFileCountLimit": 30
        }
      }
    ]
  }
}
</code>

----

===== Verwandte Runbooks =====

  * [[.:health-check|Health Check]] – Verfügbarkeitsprüfung
  * [[.:server-starten|Server starten]] – Bei Absturz
  * [[..:monitoring:alerting|Alerting]] – Automatische Benachrichtigung

----

<< [[.:health-check|← Health Check]] | [[..:start|→ Operator-Übersicht]] >>

----
//Wolfgang van der Stille @ EMSR DATA d.o.o. - Data Gateway Professional//

{{tag>operator runbook logs troubleshooting}}