mirror of
https://github.com/hansjone/netx.git
synced 2026-10-09 13:00:44 +08:00
oliver
653baa1b9f
Compare by interface target_id with optional mapped baseline (same window or time-shifted), keep chart samples on target_row_id, and unify UI wording to interface. Co-authored-by: Cursor <cursoragent@cursor.com>
173 lines
4.3 KiB
Python
173 lines
4.3 KiB
Python
"""Pydantic schemas for port traffic monitoring API."""
|
|
|
|
from __future__ import annotations
|
|
|
|
from datetime import datetime
|
|
from typing import Literal
|
|
|
|
from pydantic import BaseModel, Field
|
|
|
|
|
|
class PortTrafficNeRef(BaseModel):
|
|
source: Literal["managed", "ume"]
|
|
id: str
|
|
ne_name: str = ""
|
|
ne_ip: str = ""
|
|
vendor: str = ""
|
|
|
|
|
|
class PortTrafficTargetIn(BaseModel):
|
|
source: Literal["managed", "ume"]
|
|
target_id: str
|
|
ne_name: str = ""
|
|
ne_ip: str = ""
|
|
vendor: str = ""
|
|
ifname: str
|
|
if_description: str = ""
|
|
bw_bps: int = 0
|
|
|
|
|
|
class PortTrafficTaskCreate(BaseModel):
|
|
title: str = Field(min_length=1, max_length=256)
|
|
interval_sec: int = Field(default=60, ge=15, le=3600)
|
|
retention_days: int = Field(default=7, ge=1, le=90)
|
|
concurrency: int = Field(default=5, ge=1, le=20)
|
|
targets: list[PortTrafficTargetIn] = Field(default_factory=list)
|
|
start_now: bool = False
|
|
|
|
|
|
class PortTrafficTaskUpdate(BaseModel):
|
|
title: str | None = Field(default=None, min_length=1, max_length=256)
|
|
interval_sec: int | None = Field(default=None, ge=15, le=3600)
|
|
retention_days: int | None = Field(default=None, ge=1, le=90)
|
|
concurrency: int | None = Field(default=None, ge=1, le=20)
|
|
|
|
|
|
class PortTrafficTaskOut(BaseModel):
|
|
id: str
|
|
title: str
|
|
status: str
|
|
interval_sec: int
|
|
retention_days: int
|
|
concurrency: int
|
|
collect_running: bool = False
|
|
target_count: int = 0
|
|
active_target_count: int = 0
|
|
last_collect_started_at: datetime | None = None
|
|
last_collect_ended_at: datetime | None = None
|
|
last_error: str = ""
|
|
created_at: datetime | None = None
|
|
updated_at: datetime | None = None
|
|
|
|
|
|
class PortTrafficTargetOut(BaseModel):
|
|
id: str
|
|
task_id: str
|
|
series_id: str = ""
|
|
source: str
|
|
target_id: str
|
|
ne_name: str
|
|
ne_ip: str
|
|
vendor: str
|
|
ifname: str
|
|
if_description: str
|
|
bw_bps: int
|
|
status: str
|
|
last_error: str = ""
|
|
last_sample_at: datetime | None = None
|
|
created_at: datetime | None = None
|
|
|
|
|
|
class PortTrafficSeriesOut(BaseModel):
|
|
id: str
|
|
task_id: str
|
|
title: str
|
|
status: str
|
|
active_target: PortTrafficTargetOut | None = None
|
|
retired_target_count: int = 0
|
|
created_at: datetime | None = None
|
|
|
|
|
|
class PortTrafficTargetsPut(BaseModel):
|
|
targets: list[PortTrafficTargetIn]
|
|
|
|
|
|
class PortTrafficReplacePortRequest(BaseModel):
|
|
"""Replace the active interface under a logical series (keeps history)."""
|
|
|
|
source: Literal["managed", "ume"]
|
|
target_id: str
|
|
ne_name: str = ""
|
|
ne_ip: str = ""
|
|
vendor: str = ""
|
|
ifname: str
|
|
if_description: str = ""
|
|
bw_bps: int = 0
|
|
series_title: str | None = Field(default=None, max_length=256)
|
|
|
|
|
|
class DiscoverPortsRequest(BaseModel):
|
|
source: Literal["managed", "ume"]
|
|
id: str
|
|
|
|
|
|
class DiscoverPortItem(BaseModel):
|
|
ifname: str
|
|
attribute: str = ""
|
|
mode: str = ""
|
|
bw_raw: str = ""
|
|
bw_bps: int = 0
|
|
admin: str = ""
|
|
phy: str = ""
|
|
prot: str = ""
|
|
description: str = ""
|
|
|
|
|
|
class DiscoverPortsResponse(BaseModel):
|
|
source: str
|
|
id: str
|
|
ne_name: str = ""
|
|
ne_ip: str = ""
|
|
vendor: str = ""
|
|
vendor_key: str = ""
|
|
ports: list[DiscoverPortItem] = Field(default_factory=list)
|
|
|
|
|
|
class PortTrafficSamplePoint(BaseModel):
|
|
ts: datetime
|
|
in_bps: float
|
|
out_bps: float
|
|
in_util_pct: float
|
|
out_util_pct: float
|
|
bw_bps: int
|
|
rate_period_sec: int = 0
|
|
ts_raw: datetime | None = None # baseline original time when aligned
|
|
|
|
|
|
class PortTrafficSamplesOut(BaseModel):
|
|
target: PortTrafficTargetOut
|
|
points: list[PortTrafficSamplePoint] = Field(default_factory=list)
|
|
|
|
|
|
class PortTrafficCompareMeta(BaseModel):
|
|
target_id: str
|
|
baseline: str = "off"
|
|
offset_hours: float = 0
|
|
range_hours: float = 24
|
|
current_target: PortTrafficTargetOut | None = None
|
|
baseline_target: PortTrafficTargetOut | None = None
|
|
baseline_target_id: str = ""
|
|
|
|
|
|
class PortTrafficCompareOut(BaseModel):
|
|
meta: PortTrafficCompareMeta
|
|
current: list[PortTrafficSamplePoint] = Field(default_factory=list)
|
|
baseline: list[PortTrafficSamplePoint] = Field(default_factory=list)
|
|
|
|
|
|
class PortTrafficDashboardOut(BaseModel):
|
|
task_count: int = 0
|
|
running_task_count: int = 0
|
|
active_target_count: int = 0
|
|
sample_count_24h: int = 0
|
|
last_sample_at: datetime | None = None
|