====== Runbook: Pregled dnevnikov ======

<WRAP round info>
**Trajanje:** ~10 minut \\
**Vloga:** Gateway-operater \\
**Pogostost:** Dnevno / Ob težavah
</WRAP>

Analiza Gateway-dnevnikov za diagnostiko napak in nadzor.

----

===== Potek dela =====

<mermaid>
flowchart TD
    A[Odpri dnevnike] --> B[Filtriraj ERROR]
    B --> C{Napake najdene?}
    C -->|Da| D[Analiziraj napake]
    C -->|Ne| E[Filtriraj WARN]
    D --> F[Ukrepi]
    E --> G{Opozorila?}
    G -->|Da| H[Dokumentiraj]
    G -->|Ne| I[V redu - Končano]
    F --> I
    H --> I

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

----

===== 1. Lokacije dnevnikov =====

| Platforma | Pot |
|-----------|------|
| Windows (konzola) | Izpis v konzoli |
| Windows (storitev) | ''%GATEWAY_ROOT%\logs\'' ali Event Log |
| Linux (systemd) | ''journalctl -u data-gateway'' |
| Docker | ''docker logs gateway'' |

----

===== 2. Prikaz zadnjih dnevnikov =====

**Windows (datoteka):**

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

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

**Linux (systemd):**

<code bash>
# Zadnjih 100 vrstic
journalctl -u data-gateway -n 100 --no-pager

# Živi prenos
journalctl -u data-gateway -f
</code>

**Docker:**

<code bash>
# Zadnjih 100 vrstic
docker logs --tail 100 gateway

# Živi prenos
docker logs -f gateway
</code>

----

===== 3. Filtriranje napak =====

**Windows:**

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

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

**Linux:**

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

# Ali v datoteki
grep -E "ERROR|Exception" /var/log/gateway/gateway.log
</code>

----

===== 4. Pogosti vzorci dnevnikov =====

**Uspešna zahteva:**
<code>
[INFO] GET /api/v1/dsn/demo/tables 200 45ms
</code>

**Napaka:**
<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>

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

----

===== 5. Prilagoditev ravni dnevnikov =====

V ''appsettings.json'':

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

| Raven | Uporaba |
|-------|------------|
| ''Trace'' | Zelo podrobno (razvoj) |
| ''Debug'' | Informacije za razhroščevanje |
| ''Information'' | Normalne operacije (privzeto) |
| ''Warning'' | Potencialne težave |
| ''Error'' | Napake, ki so bile obravnavane |
| ''Critical'' | Resne napake, sesutje |

----

===== 6. Kontrolni seznam =====

| # | Točka preverjanja | V |
|---|-----------|---|
| 1 | ERROR-vnosi pregledani | |
| 2 | WARN-vnosi pregledani | |
| 3 | Počasne poizvedbe zabeležene | |
| 4 | Napake dokumentirane/prijavljene | |
| 5 | Rotacija dnevnikov aktivna | |

----

===== Odpravljanje težav =====

| Sporočilo v dnevniku | Vzrok | Rešitev |
|-------------|---------|--------|
| ''Database not found'' | DSN ni konfiguriran | Preveri appsettings.json |
| ''Connection refused'' | Baza ni dosegljiva | Preveri požarni zid/omrežje |
| ''SqlException: Login failed'' | Napačne poverilnice | Preveri geslo |
| ''OutOfMemoryException'' | Prevelika poizvedba | Nastavi omejitev ''$top'' |
| ''Timeout expired'' | Baza počasna | Optimiziraj indekse |

----

===== Nastavitev rotacije dnevnikov =====

**Serilog (appsettings.json):**

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

----

===== Povezani Runbooks =====

  * [[.:health-check|Health Check]] - Preverjanje razpoložljivosti
  * [[.:server-starten|Zagon strežnika]] - Ob sesutju
  * [[..:monitoring:alerting|Opozarjanje]] - Samodejno obveščanje

----

<< [[.:health-check|<- Health Check]] | [[..:start|-> Pregled operaterja]] >>

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

{{tag>operator runbook logs troubleshooting}}