欢迎页

后端 API

欢迎页路由来自 llm_d_lens/dashboard/router.py。接口只返回最新问题快照。后端后台任务每 60 秒刷新该快照，请求处理时再按调用者过滤。集群容量、服务列表、部署活动和 Token 使用量仍由各自模块的接口负责。

两个路由都需要已登录会话和 cluster:cluster:read。每条问题还会按调用者可访问的集群和问题所属领域的权限过滤。显式传入无权访问的 clusterId 会返回 403，且不包含资源详情。

获取欢迎页概览

返回欢迎页当前范围内的问题数据。已有快照时，refresh=true 会安排一次后台刷新，并立即返回当前快照，不会等待远程数据源。

REST API
Python API

GET /api/v1/welcome/overview

查询参数：

clusterId（string，可选）：一个有权访问的集群。
refresh（boolean，默认 false）：安排一次后台快照刷新。

响应：WelcomeOverview。

{
  "generatedAt": "2026-10-18T12:41:03Z",
  "scope": {
    "mode": "all",
    "clusters": [{ "id": "cluster-a", "name": "prod-a" }]
  },
  "issues": {
    "state": "complete",
    "generatedAt": "2026-10-18T12:41:03Z",
    "observedAt": "2026-10-18T12:40:30Z",
    "stale": false,
    "coverage": { "observed": 1, "expected": 1, "unit": "clusters" },
    "data": [
      {
        "id": "model.provider_unhealthy|cluster-a|model_service|msg-123",
        "code": "model.provider_unhealthy",
        "severity": "warning",
        "category": "model-service",
        "title": "model-alpha: 1 provider(s) not ready",
        "message": "At least one configured provider is unhealthy.",
        "clusterId": "cluster-a",
        "resource": { "type": "model_service", "id": "msg-123", "name": "model-alpha" },
        "evidence": { "providers": { "ready": 1, "active": 2 } },
        "primaryAction": {
          "intent": "inspect_providers",
          "view": "admin/model-service",
          "params": { "clusterId": "cluster-a", "groupId": "msg-123" },
          "permission": "model-service:group:read"
        }
      }
    ]
  }
}

响应不包含硬件汇总、集群容量、服务列表、部署活动、Token 总量或 AI provider 配置。

import asyncio

from llm_d_lens.dashboard.service import default_service

async def main(principal) -> None:
    # `principal` 通常从已认证的请求会话中解析。
    overview = await default_service().welcome_overview(principal, cluster_id="cluster-a")
    for issue in overview.issues.data or []:
        print(issue.severity, issue.code, issue.title)

asyncio.run(main(principal))

列出当前问题

返回相同的规范化当前问题，支持筛选和游标分页。该接口对应 View all issues 页面。

REST API
Python API

GET /api/v1/welcome/issues

查询参数：

clusterId（string，可选）：一个有权访问的集群。
severity（critical、warning、info，可选）。
category（cluster、model-service、deployment、storage、model-cache、monitoring、ai-provider、access，可选）。
search（string，可选）：匹配问题/资源标识或文本。
cursor（string，可选）：由 nextCursor 返回的不透明游标。
limit（integer，默认 25，范围 1..100）。

响应：WelcomeIssuesResponse，包含 snapshotId、total、items、 nextCursor 和 restarted。

{
  "generatedAt": "2026-10-18T12:41:03Z",
  "snapshotId": "8e4f...",
  "total": 3,
  "items": [],
  "nextCursor": null,
  "restarted": false
}

游标包含快照标识。如果快照过期或问题发生变化，服务端会设置 restarted: true 并返回第一页。

import asyncio

from llm_d_lens.dashboard.service import default_service

async def main(principal) -> None:
    page = await default_service().alerts(principal, severity="critical", limit=25)
    print(page.total)
    for issue in page.items:
        print(issue.cluster_name, issue.title)

asyncio.run(main(principal))

后端 API​

获取欢迎页概览​

列出当前问题​

相关接口​

后端 API

获取欢迎页概览

列出当前问题

相关接口