发布管理:maintenanceSummary 只看 job.state === 'failed' 就给 held 处置文案; 窗口已 released 的旧作业(libsync-internal-1793399248431728863)因此自相矛盾。 改为仅 held 时给 recoveryError,已释放时给 releasedFailure(如实记录失败,不提供强制成功)。 版本记录:LoadVersionHistorySyncState 把可空的 finished_at 扫进 time.Time; 部署重启触发的同步在"进行中"时该列为 NULL,扫描失败使整页 500 (nginx access log:GET /api/v1/version-history?limit=30 → 500,74 字节错误体)。 改为指针接值再判空。前端同时区分"未配置/加载失败"并显示服务端 code。 RED/GREEN:新增 Go 集成用例(NULL finished_at)、两条前端用例; make verify 16/16 通过(local 档案)。
This commit is contained in:
+185
-35
@@ -1,39 +1,189 @@
|
||||
export type MonitorStatus='completed'|'pending'|'processing'|'finalizing'|'failed'|'cancelled'
|
||||
export interface MonitorHost{cpu_percent:number;memory_used_bytes:number;memory_total_bytes:number;disk_used_bytes:number;disk_total_bytes:number;gpu_state:string;gpu_detail:string;simulated:boolean}
|
||||
export interface MonitorService{key:string;name:string;state:string;detail:string;latency_ms:number;observed_at:string;simulated:boolean}
|
||||
export interface KnowledgeProgress{id:string;name:string;visibility:string;imported:number;completed:number;pending:number;processing:number;finalizing:number;failed:number;cancelled:number;planned:number;needs_removal:number;stale_planned:number;internal_imported:number;internal_completed:number;external_imported:number;external_completed:number}
|
||||
export interface ServiceHealth{key:string;name:string;liveness:string;readiness:string;reason:string;latency_ms:number;observed_at:string;last_success_at:string|null;consecutive_failures:number;configured:boolean;applicable:boolean}
|
||||
export interface IngestionPipeline{fetch_pending:number;fetch_failed:number;fetch_missing:number;concurrency:number}
|
||||
export interface MonitorOverview{mode:string;simulated:boolean;observed_at:string;host:MonitorHost;services:MonitorService[];knowledge_bases:KnowledgeProgress[];pipeline?:IngestionPipeline;health:ServiceHealth[]}
|
||||
export interface MonitorFile{name:string;directory:string;visibility:string;status:MonitorStatus;stage_detail:string;elapsed_seconds:number;error_code:string}
|
||||
export interface MonitorFilePage{items:MonitorFile[];total:number;limit:number;offset:number;sample_only:boolean}
|
||||
const record=(value:unknown):value is Record<string,unknown>=>typeof value==='object'&&value!==null
|
||||
export async function fetchMonitorOverview(signal?:AbortSignal):Promise<MonitorOverview>{
|
||||
const response=await fetch('/api/v1/monitor/overview',{headers:{Accept:'application/json'},signal});if(!response.ok)throw new Error(`加载解析监控失败(HTTP ${response.status})`)
|
||||
const value=await response.json() as unknown;if(!record(value)||typeof value.mode!=='string'||typeof value.simulated!=='boolean'||!record(value.host)||!Array.isArray(value.services)||!Array.isArray(value.knowledge_bases))throw new Error('解析监控响应无效')
|
||||
const health=Array.isArray(value.health)?(value.health as unknown[]).filter(record):[]
|
||||
return {...value,health} as unknown as MonitorOverview
|
||||
export type MonitorStatus = 'completed' | 'pending' | 'processing' | 'finalizing' | 'failed' | 'cancelled'
|
||||
export interface MonitorHost {
|
||||
cpu_percent: number
|
||||
memory_used_bytes: number
|
||||
memory_total_bytes: number
|
||||
disk_used_bytes: number
|
||||
disk_total_bytes: number
|
||||
gpu_state: string
|
||||
gpu_detail: string
|
||||
simulated: boolean
|
||||
}
|
||||
export async function fetchMonitorFiles(knowledgeBaseID:string,status:MonitorStatus|'',limit=20,offset=0,signal?:AbortSignal):Promise<MonitorFilePage>{
|
||||
const query=new URLSearchParams();if(status)query.set('status',status);query.set('limit',String(limit));query.set('offset',String(offset))
|
||||
const response=await fetch(`/api/v1/monitor/knowledge-bases/${encodeURIComponent(knowledgeBaseID)}/files?${query}`,{headers:{Accept:'application/json'},signal});if(!response.ok)throw new Error(`加载文档阶段失败(HTTP ${response.status})`)
|
||||
const value=await response.json() as unknown;if(!record(value)||!Array.isArray(value.items)||typeof value.total!=='number'||typeof value.sample_only!=='boolean')throw new Error('文档阶段响应无效')
|
||||
return value as unknown as MonitorFilePage
|
||||
export interface MonitorService {
|
||||
key: string
|
||||
name: string
|
||||
state: string
|
||||
detail: string
|
||||
latency_ms: number
|
||||
observed_at: string
|
||||
simulated: boolean
|
||||
}
|
||||
export interface KnowledgeProgress {
|
||||
id: string
|
||||
name: string
|
||||
visibility: string
|
||||
imported: number
|
||||
completed: number
|
||||
pending: number
|
||||
processing: number
|
||||
finalizing: number
|
||||
failed: number
|
||||
cancelled: number
|
||||
planned: number
|
||||
needs_removal: number
|
||||
stale_planned: number
|
||||
internal_imported: number
|
||||
internal_completed: number
|
||||
external_imported: number
|
||||
external_completed: number
|
||||
}
|
||||
export interface ServiceHealth {
|
||||
key: string
|
||||
name: string
|
||||
liveness: string
|
||||
readiness: string
|
||||
reason: string
|
||||
latency_ms: number
|
||||
observed_at: string
|
||||
last_success_at: string | null
|
||||
consecutive_failures: number
|
||||
configured: boolean
|
||||
applicable: boolean
|
||||
}
|
||||
export interface IngestionPipeline {
|
||||
fetch_pending: number
|
||||
fetch_failed: number
|
||||
fetch_missing: number
|
||||
concurrency: number
|
||||
}
|
||||
export interface MonitorOverview {
|
||||
mode: string
|
||||
simulated: boolean
|
||||
observed_at: string
|
||||
host: MonitorHost
|
||||
services: MonitorService[]
|
||||
knowledge_bases: KnowledgeProgress[]
|
||||
pipeline?: IngestionPipeline
|
||||
health: ServiceHealth[]
|
||||
}
|
||||
export interface MonitorFile {
|
||||
name: string
|
||||
directory: string
|
||||
visibility: string
|
||||
status: MonitorStatus
|
||||
stage_detail: string
|
||||
elapsed_seconds: number
|
||||
error_code: string
|
||||
}
|
||||
export interface MonitorFilePage {
|
||||
items: MonitorFile[]
|
||||
total: number
|
||||
limit: number
|
||||
offset: number
|
||||
sample_only: boolean
|
||||
}
|
||||
const record = (value: unknown): value is Record<string, unknown> => typeof value === 'object' && value !== null
|
||||
export async function fetchMonitorOverview(signal?: AbortSignal): Promise<MonitorOverview> {
|
||||
const response = await fetch('/api/v1/monitor/overview', { headers: { Accept: 'application/json' }, signal })
|
||||
if (!response.ok) throw new Error(`加载解析监控失败(HTTP ${response.status})`)
|
||||
const value = (await response.json()) as unknown
|
||||
if (
|
||||
!record(value) ||
|
||||
typeof value.mode !== 'string' ||
|
||||
typeof value.simulated !== 'boolean' ||
|
||||
!record(value.host) ||
|
||||
!Array.isArray(value.services) ||
|
||||
!Array.isArray(value.knowledge_bases)
|
||||
)
|
||||
throw new Error('解析监控响应无效')
|
||||
const health = Array.isArray(value.health) ? (value.health as unknown[]).filter(record) : []
|
||||
return { ...value, health } as unknown as MonitorOverview
|
||||
}
|
||||
export async function fetchMonitorFiles(
|
||||
knowledgeBaseID: string,
|
||||
status: MonitorStatus | '',
|
||||
limit = 20,
|
||||
offset = 0,
|
||||
signal?: AbortSignal
|
||||
): Promise<MonitorFilePage> {
|
||||
const query = new URLSearchParams()
|
||||
if (status) query.set('status', status)
|
||||
query.set('limit', String(limit))
|
||||
query.set('offset', String(offset))
|
||||
const response = await fetch(
|
||||
`/api/v1/monitor/knowledge-bases/${encodeURIComponent(knowledgeBaseID)}/files?${query}`,
|
||||
{ headers: { Accept: 'application/json' }, signal }
|
||||
)
|
||||
if (!response.ok) throw new Error(`加载文档阶段失败(HTTP ${response.status})`)
|
||||
const value = (await response.json()) as unknown
|
||||
if (
|
||||
!record(value) ||
|
||||
!Array.isArray(value.items) ||
|
||||
typeof value.total !== 'number' ||
|
||||
typeof value.sample_only !== 'boolean'
|
||||
)
|
||||
throw new Error('文档阶段响应无效')
|
||||
return value as unknown as MonitorFilePage
|
||||
}
|
||||
|
||||
export interface JobWindowMetrics{window_seconds:number;jobs_started:number;jobs_completed:number;jobs_failed:number;success_rate:number|null;failure_rate:number|null;duration_avg_seconds:number|null;duration_p50_seconds:number|null;duration_p95_seconds:number|null}
|
||||
export interface RunMetrics{observed_at:string;active_workers:number;worker_source:'pg_lease'|'simulation';queue:{pending:number;running:number;retry:number;failed:number;oldest_pending_age_seconds:number|null};short_window:JobWindowMetrics;long_window:JobWindowMetrics}
|
||||
const finiteOrNull=(value:unknown)=>typeof value==='number'&&Number.isFinite(value)?value:null
|
||||
const numberOr=(value:unknown,fallback=0)=>typeof value==='number'&&Number.isFinite(value)?value:fallback
|
||||
const windowMetrics=(value:unknown):JobWindowMetrics=>{if(!record(value))throw new Error('运行指标窗口响应无效')
|
||||
return{window_seconds:numberOr(value.window_seconds),jobs_started:numberOr(value.jobs_started),jobs_completed:numberOr(value.jobs_completed),jobs_failed:numberOr(value.jobs_failed),success_rate:finiteOrNull(value.success_rate),failure_rate:finiteOrNull(value.failure_rate),duration_avg_seconds:finiteOrNull(value.duration_avg_seconds),duration_p50_seconds:finiteOrNull(value.duration_p50_seconds),duration_p95_seconds:finiteOrNull(value.duration_p95_seconds)}}
|
||||
export async function fetchRunMetrics(signal?:AbortSignal):Promise<RunMetrics>{
|
||||
const response=await fetch('/api/v1/monitor/metrics',{headers:{Accept:'application/json'},signal});if(!response.ok)throw new Error(`加载运行指标失败(HTTP ${response.status})`)
|
||||
const value=await response.json() as unknown;if(!record(value)||!record(value.data))throw new Error('运行指标响应无效')
|
||||
const data=value.data as Record<string,unknown>
|
||||
if(data.worker_source!=='pg_lease'&&data.worker_source!=='simulation')throw new Error('运行指标缺少数据来源标记')
|
||||
if(!record(data.queue)||!record(data.short_window)||!record(data.long_window))throw new Error('运行指标字段不完整')
|
||||
return{observed_at:typeof data.observed_at==='string'?data.observed_at:'',active_workers:numberOr(data.active_workers),worker_source:data.worker_source as RunMetrics['worker_source'],
|
||||
queue:{pending:numberOr(data.queue.pending),running:numberOr(data.queue.running),retry:numberOr(data.queue.retry),failed:numberOr(data.queue.failed),oldest_pending_age_seconds:finiteOrNull(data.queue.oldest_pending_age_seconds)},
|
||||
short_window:windowMetrics(data.short_window),long_window:windowMetrics(data.long_window)}
|
||||
export interface JobWindowMetrics {
|
||||
window_seconds: number
|
||||
jobs_started: number
|
||||
jobs_completed: number
|
||||
jobs_failed: number
|
||||
success_rate: number | null
|
||||
failure_rate: number | null
|
||||
duration_avg_seconds: number | null
|
||||
duration_p50_seconds: number | null
|
||||
duration_p95_seconds: number | null
|
||||
}
|
||||
export interface RunMetrics {
|
||||
observed_at: string
|
||||
active_workers: number
|
||||
worker_source: 'pg_lease' | 'simulation'
|
||||
queue: { pending: number; running: number; retry: number; failed: number; oldest_pending_age_seconds: number | null }
|
||||
short_window: JobWindowMetrics
|
||||
long_window: JobWindowMetrics
|
||||
}
|
||||
const finiteOrNull = (value: unknown) => (typeof value === 'number' && Number.isFinite(value) ? value : null)
|
||||
const numberOr = (value: unknown, fallback = 0) =>
|
||||
typeof value === 'number' && Number.isFinite(value) ? value : fallback
|
||||
const windowMetrics = (value: unknown): JobWindowMetrics => {
|
||||
if (!record(value)) throw new Error('运行指标窗口响应无效')
|
||||
return {
|
||||
window_seconds: numberOr(value.window_seconds),
|
||||
jobs_started: numberOr(value.jobs_started),
|
||||
jobs_completed: numberOr(value.jobs_completed),
|
||||
jobs_failed: numberOr(value.jobs_failed),
|
||||
success_rate: finiteOrNull(value.success_rate),
|
||||
failure_rate: finiteOrNull(value.failure_rate),
|
||||
duration_avg_seconds: finiteOrNull(value.duration_avg_seconds),
|
||||
duration_p50_seconds: finiteOrNull(value.duration_p50_seconds),
|
||||
duration_p95_seconds: finiteOrNull(value.duration_p95_seconds),
|
||||
}
|
||||
}
|
||||
export async function fetchRunMetrics(signal?: AbortSignal): Promise<RunMetrics> {
|
||||
const response = await fetch('/api/v1/monitor/metrics', { headers: { Accept: 'application/json' }, signal })
|
||||
if (!response.ok) throw new Error(`加载运行指标失败(HTTP ${response.status})`)
|
||||
const value = (await response.json()) as unknown
|
||||
if (!record(value) || !record(value.data)) throw new Error('运行指标响应无效')
|
||||
const data = value.data as Record<string, unknown>
|
||||
if (data.worker_source !== 'pg_lease' && data.worker_source !== 'simulation')
|
||||
throw new Error('运行指标缺少数据来源标记')
|
||||
if (!record(data.queue) || !record(data.short_window) || !record(data.long_window))
|
||||
throw new Error('运行指标字段不完整')
|
||||
return {
|
||||
observed_at: typeof data.observed_at === 'string' ? data.observed_at : '',
|
||||
active_workers: numberOr(data.active_workers),
|
||||
worker_source: data.worker_source as RunMetrics['worker_source'],
|
||||
queue: {
|
||||
pending: numberOr(data.queue.pending),
|
||||
running: numberOr(data.queue.running),
|
||||
retry: numberOr(data.queue.retry),
|
||||
failed: numberOr(data.queue.failed),
|
||||
oldest_pending_age_seconds: finiteOrNull(data.queue.oldest_pending_age_seconds),
|
||||
},
|
||||
short_window: windowMetrics(data.short_window),
|
||||
long_window: windowMetrics(data.long_window),
|
||||
}
|
||||
}
|
||||
|
||||
Reference in New Issue
Block a user