e34306b2db
build / build (push) Failing after 18s
发布管理: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 档案)。
190 lines
6.4 KiB
TypeScript
190 lines
6.4 KiB
TypeScript
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 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),
|
||
}
|
||
}
|