feat: drill-down filters on overview and outdated agent version highlight

Co-authored-by: Cursor <cursoragent@cursor.com>

backend/app/api/v1/hosts.py

@@ -8,10 +8,12 @@ from app.config import get_settings
 from app.database import get_db
 from app.models import Event, Host
 from app.schemas.list_models import HostDetail, HostListResponse, HostSummary
+from app.services.agent_version import latest_agent_versions_by_product
 from app.services.host_delete import delete_host_and_related
 from app.services.host_health import (
     HEARTBEAT_TYPE,
-    agent_status,
+    agent_status as compute_agent_status,
+    apply_agent_status_host_filter,
     max_daily_report_time_by_host,
     max_event_time_by_host,
 )
@@ -25,6 +27,7 @@ def list_hosts(
     page_size: int = Query(50, ge=1, le=200),
     product: str | None = None,
     hostname: str | None = None,
+    agent_status: str | None = Query(None, pattern="^(online|stale|unknown)$"),
     db: Session = Depends(get_db),
     _user: str = Depends(get_current_user),
 ) -> HostListResponse:
@@ -40,6 +43,15 @@ def list_hosts(
         stmt = stmt.where(host_match)
         count_stmt = count_stmt.where(host_match)
 
+    settings = get_settings()
+    if agent_status:
+        stmt, count_stmt = apply_agent_status_host_filter(
+            stmt,
+            count_stmt,
+            agent_status,
+            stale_minutes=settings.sac_heartbeat_stale_minutes,
+        )
+
     total = db.scalar(count_stmt) or 0
     rows = db.scalars(
         stmt.order_by(Host.last_seen_at.desc())
@@ -47,7 +59,6 @@ def list_hosts(
         .limit(page_size)
     ).all()
 
-    settings = get_settings()
     hb_map = max_event_time_by_host(db, HEARTBEAT_TYPE)
     report_map = max_daily_report_time_by_host(db)
 
@@ -72,13 +83,19 @@ def list_hosts(
                 last_heartbeat_at=last_hb,
                 last_daily_report_at=report_map.get(host.id),
                 last_inventory_at=host.inventory_updated_at,
-                agent_status=agent_status(
+                agent_status=compute_agent_status(
                     last_hb, stale_minutes=settings.sac_heartbeat_stale_minutes
                 ),
             )
         )
 
-    return HostListResponse(items=items, total=total, page=page, page_size=page_size)
+    return HostListResponse(
+        items=items,
+        total=total,
+        page=page,
+        page_size=page_size,
+        latest_agent_versions=latest_agent_versions_by_product(db),
+    )
 
 
 def _host_detail_from_model(
@@ -108,7 +125,7 @@ def _host_detail_from_model(
         last_heartbeat_at=last_hb,
         last_daily_report_at=report_map.get(host.id),
         last_inventory_at=host.inventory_updated_at,
-        agent_status=agent_status(last_hb, stale_minutes=settings.sac_heartbeat_stale_minutes),
+        agent_status=compute_agent_status(last_hb, stale_minutes=settings.sac_heartbeat_stale_minutes),
         agent_instance_id=host.agent_instance_id,
         tags=host.tags if isinstance(host.tags, list) else [],
         use_sac_mode=host.use_sac_mode,

backend/app/api/v1/problems.py

@@ -1,4 +1,4 @@
-from datetime import datetime
+from datetime import datetime, timedelta, timezone
 
 
 
@@ -156,6 +156,10 @@ def list_problems(
 
     hostname: str | None = Query(None),
 
+    created_within_hours: int | None = Query(None, ge=1, le=8760),
+
+    resolved_within_hours: int | None = Query(None, ge=1, le=8760),
+
     db: Session = Depends(get_db),
 
     _user: str = Depends(get_current_user),
@@ -194,6 +198,22 @@ def list_problems(
 
         count_stmt = count_stmt.where(Host.hostname.ilike(like) | Host.display_name.ilike(like))
 
+    if created_within_hours is not None:
+
+        since = datetime.now(timezone.utc) - timedelta(hours=created_within_hours)
+
+        stmt = stmt.where(Problem.created_at >= since)
+
+        count_stmt = count_stmt.where(Problem.created_at >= since)
+
+    if resolved_within_hours is not None:
+
+        since = datetime.now(timezone.utc) - timedelta(hours=resolved_within_hours)
+
+        stmt = stmt.where(Problem.status == "resolved", Problem.updated_at >= since)
+
+        count_stmt = count_stmt.where(Problem.status == "resolved", Problem.updated_at >= since)
+
 
 
     total = db.scalar(count_stmt) or 0

backend/app/schemas/list_models.py

@@ -37,6 +37,7 @@ class HostListResponse(BaseModel):
     total: int
     page: int
     page_size: int
+    latest_agent_versions: dict[str, str] = Field(default_factory=dict)
 
 
 class EventSummary(BaseModel):

backend/app/services/agent_version.py

@@ -0,0 +1,80 @@
+"""Сравнение версий агентов (ssh-monitor / rdp-login-monitor, формат X.Y.Z-SAC)."""
+
+from __future__ import annotations
+
+import re
+from dataclasses import dataclass
+
+from sqlalchemy import select
+from sqlalchemy.orm import Session
+
+from app.models import Host
+
+_VERSION_RE = re.compile(r"^(\d+)\.(\d+)\.(\d+)(?:-SAC)?$", re.IGNORECASE)
+_DEFAULT_LAG_THRESHOLD = 3
+
+
+@dataclass(frozen=True, order=True)
+class ParsedAgentVersion:
+    major: int
+    minor: int
+    patch: int
+
+
+def parse_agent_version(raw: str | None) -> ParsedAgentVersion | None:
+    if not raw:
+        return None
+    text = raw.strip()
+    match = _VERSION_RE.match(text)
+    if not match:
+        return None
+    return ParsedAgentVersion(
+        major=int(match.group(1)),
+        minor=int(match.group(2)),
+        patch=int(match.group(3)),
+    )
+
+
+def agent_version_lag(host: ParsedAgentVersion, latest: ParsedAgentVersion) -> int | None:
+    """Отставание от latest: patch при том же major.minor, иначе None (любое отставание)."""
+    if host > latest:
+        return 0
+    if host.major != latest.major or host.minor != latest.minor:
+        return None
+    return latest.patch - host.patch
+
+
+def is_agent_version_outdated(
+    host_version: str | None,
+    latest_version: str | None,
+    *,
+    lag_threshold: int = _DEFAULT_LAG_THRESHOLD,
+) -> bool:
+    host = parse_agent_version(host_version)
+    latest = parse_agent_version(latest_version)
+    if host is None or latest is None or host >= latest:
+        return False
+    lag = agent_version_lag(host, latest)
+    if lag is None:
+        return True
+    return lag >= lag_threshold
+
+
+def latest_agent_versions_by_product(db: Session) -> dict[str, str]:
+    rows = db.execute(
+        select(Host.product, Host.product_version).where(
+            Host.product_version.isnot(None),
+            Host.product_version != "",
+        )
+    ).all()
+    best: dict[str, ParsedAgentVersion] = {}
+    best_raw: dict[str, str] = {}
+    for product, version in rows:
+        parsed = parse_agent_version(version)
+        if parsed is None:
+            continue
+        current = best.get(product)
+        if current is None or parsed > current:
+            best[product] = parsed
+            best_raw[product] = version.strip()
+    return best_raw

backend/app/services/host_health.py

@@ -62,3 +62,39 @@ def count_stale_hosts(db: Session, stale_minutes: int) -> int:
         for host_id in host_ids
         if agent_status(hb_map.get(host_id), stale_minutes=stale_minutes) == "stale"
     )
+
+
+def apply_agent_status_host_filter(
+    stmt,
+    count_stmt,
+    agent_status_filter: str,
+    *,
+    stale_minutes: int,
+):
+    """Ограничить выборку Host по online / stale / unknown (как в agent_status)."""
+    from datetime import timedelta
+
+    hb_subq = (
+        select(Event.host_id, func.max(Event.received_at).label("last_hb"))
+        .where(Event.type == HEARTBEAT_TYPE)
+        .group_by(Event.host_id)
+        .subquery()
+    )
+    cutoff = datetime.now(timezone.utc) - timedelta(minutes=stale_minutes)
+
+    if agent_status_filter == "online":
+        join = stmt.join(hb_subq, Host.id == hb_subq.c.host_id)
+        count_join = count_stmt.join(hb_subq, Host.id == hb_subq.c.host_id)
+        cond = hb_subq.c.last_hb >= cutoff
+        return join.where(cond), count_join.where(cond)
+    if agent_status_filter == "stale":
+        join = stmt.join(hb_subq, Host.id == hb_subq.c.host_id)
+        count_join = count_stmt.join(hb_subq, Host.id == hb_subq.c.host_id)
+        cond = hb_subq.c.last_hb < cutoff
+        return join.where(cond), count_join.where(cond)
+    if agent_status_filter == "unknown":
+        join = stmt.outerjoin(hb_subq, Host.id == hb_subq.c.host_id)
+        count_join = count_stmt.outerjoin(hb_subq, Host.id == hb_subq.c.host_id)
+        cond = hb_subq.c.last_hb.is_(None)
+        return join.where(cond), count_join.where(cond)
+    return stmt, count_stmt