docker logy

2026-08-25 08:23:10 +02:00
parent d50093e893
commit f4b42cbdf3
5 changed files with 468 additions and 2 deletions
@@ -0,0 +1,190 @@
+"""Stránka "Logy" v detailu služby - diagnostické čtení Docker logů kontejneru.
+
+Účel: administrátor uvidí konkrétní exception (Kestrel / Uvicorn / Node.js) bez SSH
+přístupu na server. Portál logy nikam neukládá, jen je přečte z Dockeru a zobrazí.
+
+Container se odvozuje z ``app_id`` služby načtené z databáze AppFactory - z URL se bere
+pouze ID služby, nikdy název kontejneru. Vlastní volání dockeru řeší ``app.docker_logs``.
+"""
+
+import html
+from urllib.parse import quote
+
+from fastapi import APIRouter, Depends, HTTPException, Query
+from fastapi.responses import HTMLResponse
+
+from ..auth import require_developer
+from ..db.apps import get_app
+from ..db.audit import log_audit_event
+from ..docker_logs import (
+    ALLOWED_LOG_TAILS,
+    LOG_PERIOD_LABELS,
+    DockerLogsError,
+    docker_daemon_available,
+    filter_log_lines,
+    get_container_logs,
+    is_error_line,
+    normalize_period,
+    normalize_tail,
+    resolve_app_container,
+    split_log_lines,
+    state_label,
+)
+from ..templates.layout import page
+
+router = APIRouter()
+
+# Stav kontejneru -> třída pilulky (stejné barvy jako u ostatních stavů v portálu).
+STATE_PILL_CLASSES = {
+    "running": "pill pill-success",
+    "restarting": "pill pill-warning",
+    "paused": "pill pill-warning",
+    "created": "pill pill-muted",
+    "removing": "pill pill-warning",
+    "exited": "pill pill-danger",
+    "dead": "pill pill-danger",
+}
+
+
+def render_state_pill(status: str | None) -> str:
+    if not status:
+        return '<span class="pill pill-muted">Neexistuje</span>'
+    css = STATE_PILL_CLASSES.get(status, "pill pill-muted")
+    return f'<span class="{css}">{html.escape(state_label(status))}</span>'
+
+
+def render_period_options(selected: str) -> str:
+    options = ""
+    for value, label in LOG_PERIOD_LABELS:
+        selected_attr = " selected" if value == selected else ""
+        options += f'<option value="{value}"{selected_attr}>{label}</option>'
+    return options
+
+
+def render_tail_options(selected: int) -> str:
+    options = ""
+    for value in ALLOWED_LOG_TAILS:
+        selected_attr = " selected" if value == selected else ""
+        options += f'<option value="{value}"{selected_attr}>{value}</option>'
+    return options
+
+
+def render_log_lines(lines: list[str]) -> str:
+    """Vykreslí řádky logu. Obsah se nemění, chybové řádky se jen vizuálně zvýrazní."""
+    if not lines:
+        return '<p class="muted">Ve zvoleném období nejsou žádné řádky logu.</p>'
+
+    rendered = []
+    for line in lines:
+        css = "log-line log-line-error" if is_error_line(line) else "log-line"
+        # Prázdný řádek by se bez pevné mezery smrskl na nulovou výšku.
+        rendered.append(f'<span class="{css}">{html.escape(line) or "&nbsp;"}</span>')
+    return f'<pre class="docker-log log-stdout">{"".join(rendered)}</pre>'
+
+
+def render_docker_error(container_name: str, detail: str) -> str:
+    daemon = "dostupný" if docker_daemon_available() else "nedostupný"
+    return f"""
+        <p class="alert alert-danger">Logy se nepodařilo načíst.</p>
+        <table>
+            <tr><th>Docker daemon</th><td>{daemon}</td></tr>
+            <tr><th>Container</th><td>{html.escape(container_name) or "neznámý"}</td></tr>
+            <tr><th>Detail</th><td>{html.escape(detail)}</td></tr>
+        </table>
+    """
+
+
+@router.get("/apps/{app_id}/logs", response_class=HTMLResponse)
+def app_logs_page(
+    app_id: str,
+    since: str = Query(""),
+    tail: str = Query(""),
+    q: str = Query(""),
+    user=Depends(require_developer),
+):
+    app = get_app(app_id)
+    if not app:
+        raise HTTPException(status_code=404, detail="App not found")
+
+    real_app_id = (app.get("id") or "").strip()
+    app_url_id = quote(real_app_id, safe="")
+    period = normalize_period(since)
+    tail_value = normalize_tail(tail)
+    query = (q or "").strip()
+
+    log_audit_event(
+        user,
+        action="service.logs.view",
+        target_type="service",
+        target_id=real_app_id,
+        metadata={"since": period, "tail": tail_value},
+    )
+
+    container_name = ""
+    container_state: str | None = None
+    error_detail = ""
+    all_lines: list[str] = []
+
+    try:
+        container_name, container_state = resolve_app_container(real_app_id)
+        if container_state:
+            all_lines = split_log_lines(get_container_logs(container_name, since=period, tail=tail_value))
+    except DockerLogsError as exc:
+        error_detail = str(exc)
+
+    visible_lines = filter_log_lines(all_lines, query)
+
+    if error_detail:
+        log_body = render_docker_error(container_name, error_detail)
+    elif not container_state:
+        log_body = (
+            '<p class="alert alert-danger">Container není spuštěný nebo neexistuje.</p>'
+            '<p class="muted">Logy lze číst jen dokud kontejner v Dockeru existuje. '
+            "Po smazání kontejneru (například při redeployi) Docker jeho logy zahodí.</p>"
+        )
+    else:
+        summary = f"Načteno {len(all_lines)} řádků."
+        if query:
+            summary = f"Zobrazeno {len(visible_lines)} z {len(all_lines)} načtených řádků (filtr: {html.escape(query)})."
+        log_body = f'<p class="muted">{summary}</p>{render_log_lines(visible_lines)}'
+
+    return page(
+        "Logy služby",
+        f"""
+        <div class="card">
+            <h2><i class="fa-solid fa-terminal" aria-hidden="true"></i> Logy kontejneru</h2>
+            <p class="muted">
+                Diagnostické čtení Docker logů běžící služby (stdout i stderr dohromady).
+                Portál logy neukládá, jen je čte přímo z Dockeru.
+            </p>
+            <p>
+                <a class="btn" href="/portal/apps/{app_url_id}">&larr; Zpět na detail služby</a>
+                <a class="btn btn-secondary" href="/portal/jobs?target={app_url_id}"><i class="fa-solid fa-list-check" aria-hidden="true"></i> Úlohy služby</a>
+            </p>
+            <table>
+                <tr><th>Aplikace</th><td>{html.escape(real_app_id)}</td></tr>
+                <tr><th>Container</th><td>{html.escape(container_name) or "neurčeno"}</td></tr>
+                <tr><th>Stav</th><td>{render_state_pill(container_state)}</td></tr>
+            </table>
+        </div>
+
+        <div class="card">
+            <h2><i class="fa-solid fa-filter" aria-hidden="true"></i> Výpis</h2>
+            <form method="get" action="/portal/apps/{app_url_id}/logs" class="filter-form">
+                <label class="filter-field">Období
+                    <select name="since">{render_period_options(period)}</select>
+                </label>
+                <label class="filter-field">Počet řádků
+                    <select name="tail">{render_tail_options(tail_value)}</select>
+                </label>
+                <label class="filter-field">Hledat
+                    <input name="q" value="{html.escape(query, quote=True)}" placeholder="např. NullReferenceException">
+                </label>
+                <button type="submit"><i class="fa-solid fa-arrow-rotate-right" aria-hidden="true"></i> Obnovit</button>
+                <a class="btn btn-secondary" href="/portal/apps/{app_url_id}/logs"><i class="fa-solid fa-arrow-rotate-left" aria-hidden="true"></i> Reset</a>
+            </form>
+            {log_body}
+        </div>
+        """,
+        user=user,
+    )
@@ -838,11 +838,14 @@ def app_detail(app_id: str, request: Request, message: str = "", error: str = ""
    )

    # Odkazy jen otevřou a najedou na sekci - všechny sekce jsou defaultně sbalené.
+    # Logy kontejneru mají vlastní stránku (čtou se živě z Dockeru), ostatní záložky
+    # jen otevřou sbalenou sekci na tomto detailu.
    manage_tabs = (
-        """
+        f"""
            <a class="btn btn-secondary" href="#metadata"><i class="fa-solid fa-table-list" aria-hidden="true"></i> Metadata</a>
            <a class="btn btn-secondary" href="#promenne"><i class="fa-solid fa-sliders" aria-hidden="true"></i> Proměnné</a>
            <a class="btn btn-secondary" href="#ip-access"><i class="fa-solid fa-shield-halved" aria-hidden="true"></i> Security / IP Access</a>
+            <a class="btn btn-secondary" href="/portal/apps/{app_url_id}/logs"><i class="fa-solid fa-terminal" aria-hidden="true"></i> Logy</a>
        """
        if can_manage
        else ""