环境诊断
诊断命令查询当前租户的 Soln 部署,不包含同一服务器上的其他软件。空间管理员和已认证的平台操作员可直接使用;其他成员需要在角色功能权限的「集成 → 环境监控」中获得「页面进入」权限,查询日志还需「服务日志」权限,重启服务则需单独授予「重启服务」权限。
查询服务列表
Runtime 命令:system.environment.services.list。
sl system environment services list --json
返回实际 Compose 服务名称、健康状态、启动时间和重启次数。查询日志时使用返回的服务名;available: false 表示无法读取部署服务。
服务状态最后一行显示 域名证书续期(domain-certificate-renewal),对应经验证负责当前域名证书的宿主机任务,不是 Docker 容器。采集器依次匹配 Nginx 域名与证书文件、证书域名覆盖范围、Certbot 续期配置及定时任务触发的执行命令,不依赖固定任务名称。系统 certbot.timer、安装器 soln-certbot.timer 和自定义名称的 Certbot 任务均可识别。无关证书或任务会被排除;多个运行中的任务同时负责该证书、无法识别的管理方式或归属无法确认时均显示未获取。certificateRenewal 同时返回匹配状态、实际任务名、服务名和证书配置名,供 AI 查询。宿主机采集任务每分钟通过已有部署状态挂载发布定时任务启用状态和最近 Certbot 检查结果。scheduled 表示自动检查已启用,checking 表示正在检查,disabled 表示任务未启用或未运行,unhealthy 表示最近检查失败。两次检查之间一次性服务处于空闲状态是正常的。采集信息缺失、格式错误、工作空间或域名不匹配、超过 3 分钟未更新时显示 unknown(未获取);当前证书有效不能证明自动续期已启用。环境总览及服务列表命令都包含这一行,Docker 日志查询不读取该任务的 systemd 日志。已有部署需要更新安装器宿主机采集任务后才能获取状态。
重启服务
Runtime 命令:system.environment.service.restart。
sl system environment service restart --service postgres --yes
服务名必须使用 system.environment.services.list 返回的精确名称。该写命令需要单独授予“重启服务”权限,并通过 --yes 明确确认。命令只会重启当前 Soln Compose 项目中的一个服务;Runtime 管理服务、其他项目、存在多个副本的服务,以及未配置重启策略的容器都会被拒绝。环境监控 AI 助手不开放此写命令。
查询服务日志
Runtime 命令:system.environment.logs.query。
sl system environment logs query --service tenant-runtime-service --since 30m --tail 200 --level error --json
sl system environment logs query --since 1h --keyword '错误中的requestId' --json
| 参数 | 含义 |
|---|---|
--service | 服务列表返回的准确名称,默认 all,表示当前部署全部服务。 |
--since | 最近 1 分钟至 7 天,例如 30m、1h、7d,默认 1h。 |
--tail | 每个服务读取的最近原始行数及合并结果上限,范围 1–1000,默认 200。 |
--level | all、error、warn、info、debug,默认 all。 |
--keyword | 最长 200 字符,不区分大小写的字面关键词,可使用 requestId 或错误码。 |
筛选在有上限的最近原始日志中执行,因此结果可能少于指定行数。返回采集时间、来源服务、日志时间、stdout/stderr、识别的级别和已脱敏内容。敏感凭据在 Runtime 返回结果前脱敏。命令实时读取 Docker 已有日志,不额外建立租户数据库日志归档,也不执行 Shell 命令。
请同时查看 available、truncated 和 unavailableServices。采集失败或结果不完整不能解释为服务没有异常。服务不存在会返回错误,应先查询实际服务名。
AI 辅助排查
进入集成 → 环境监控 → 服务日志,点击 AI 图标或按 Alt+L 展开当前右侧面板。该页面使用独立会话记录,可以查询服务状态、实时日志,并通过已有权限内的只读命令关联业务记录、审批实例和执行回执。当前面板只开放查询命令,不代替用户操作交互终端。服务日志采集需要实际的 Docker 部署环境。
例如:“查看最近 30 分钟的错误,再根据 requestId …… 查询对应的审批执行情况。”
分析整个环境监控页面
sl system environment overview get --json
Runtime 命令:system.environment.overview.get,严格输入 {},需要环境监控及服务日志权限,并遵循当前工作空间 Luna 命令白名单,仅提供读取。页面 AI 对话快捷键和服务日志对话复用此命令链路:CLI → Runtime 命令注册表 → 租户领域 repository;不经过 MCP,也无需 Shell 工具。
覆盖页面全部指标:CPU/核心数、内存、已采集的 CPU/内存及磁盘/网络 IO 历史、存储容量与目录占用、部署版本/运行时间、服务健康与重启次数、连接池使用和等待请求、流程派发/执行的已保存与实际生效并发、Worker 心跳、操作与流程耗时分组及趋势。resources、databasePools、workflowCapacity、performance 分别返回 ready、partial 或 unavailable。总览 collectedAt 是组装时间,判断新旧应使用各部分自己的采集时间,缺失不表示正常。采集异常返回安全错误码,不返回原始数据库或主机错误详情。日志仍通过 system.environment.logs.query 单独限量查询;此命令不打开终端,也不读取手工 Shell 输出。
AI 建议应说明实际证据及覆盖范围,区分启动等待、连接获取与人工/回调等待,并比较已保存和实际生效配置;用大白话给出当前值 → 建议值、原因以及相近负载下比较等待数、P95、错误率的验证方式。证据不足时保持当前配置并说明缺什么,不能凭空推算支持人数、数据库 max_connections、执行器副本数或慢 SQL。执行并发满足 bulk + control + reservedConnections <= databasePoolMax,并发按每个执行器进程生效。此命令不修改配置,建议需确认后在页面的配置入口应用,不授权写入、清理或重启。
顶部指标卡显示 域名证书有效期。环境总览返回 certificate,包括域名、端口、签发机构、有效期、剩余完整天数 remainingDays、证书链可信状态 trusted、域名匹配状态 hostnameMatches、status、reason 和采集时间 collectedAt。仅检查 RUNTIME_ORIGIN 配置的工作空间地址;如果入口使用 CDN 或外层网关,读取该入口实际呈现的证书,不携带应用凭据。证书缓存 5 分钟,采集失败缓存 30 秒,单次握手最多 3 秒。HTTP 地址为 notApplicable,采集失败为 unavailable,均不能视为证书有效。剩余不超过 30 天标记为 expiring,过期、域名不匹配及证书链不可信单独报告。剩余天数按当前时间重新计算,不满一天仍有效时显示 0 天。卡片显示剩余天数,第三行显示域名,不显示悬停详情。30 天及以上为绿色,10~29 天为黄色,不足 10 天为红色。已过期或没有有效期时显示 0 天。缺失数据展示为 0 天不代表已确认过期,AI 仍应读取原始状态和原因。
Runtime 启动后在后台采集部署指标,不依赖用户是否打开页面。CPU/内存、磁盘/网络 IO、服务状态约每 15 秒采集,容量与目录大小约每分钟采集,同一采集任务不会重叠执行。目录与日志扫描较慢时不会阻塞其他采集任务。页面读取最近的内存结果,证书、连接池/流程并发、操作耗时区域独立加载。刷新只读取最新结果,不会强制扫描主机;操作耗时仍使用独立的有时限数据库查询与缓存。证书也在后台采集,复用五分钟 TLS 缓存与 30 秒失败缓存。资源与 IO 趋势各自保留最近一小时的采集点,Runtime 重启后重新积累;history.source 区分 resources 与 io,各趋势仅使用对应来源。resources.data.collection 分别返回 collecting(采集中)、ready、partial、stale(历史采集值)、unavailable。首次采集前对应时间为空,证书首次检查前的 collectedAt 也为空。刷新失败保留前次值与采集时间并标记 stale,超过三个采集周期未更新也标记为历史值。组装时间不能作为测量时间,旧服务状态不能当作当前健康证明。
查询操作耗时
sl system environment performance get --json
Runtime 命令:system.environment.performance.get,严格输入 {},需要环境监控和服务日志权限。返回最近一小时按操作、计时范围分组的样本数、失败数、平均耗时、P95、最大耗时及业务主连接池连接获取累计耗时的 P95。操作耗时、服务响应耗时、请求截至写审计前的耗时分别统计;连接获取包含连接池等待及建立连接,不是 SQL 执行耗时。同时纳入审批/自动化流程与节点、OpenLink 执行/逐条处理及节点时钟、数据处理任务和脚本。流程总耗时包含等待;人工处理、回调等待、启动等待、节点经过时间及后台任务执行分开统计。仅统计已完成的时间区间并按结束时间分桶;启动等待使用创建到开始的间隔,可能含主动串行和重试等待。未完成区间不进入分位数。每个来源最多读取最近更新的 10,000 条记录(脚本按完成时间),派生样本分来源限量 20,000 条,需检查 scannedRecords、timedSamples、truncated。一条来源记录可产生多个计时范围样本;这不是全站请求吞吐量,未计时记录不参与计算。不读取 SQL 文本或消息正文。
结果还包含 bucketSeconds: 300、全部操作的 trends 以及每组操作的 points。每个点包含 UTC 区间起点 at、count、averageMs 和 p95Ms,仅返回有样本的区间;首尾区间仅统计 from/to 范围内的数据,可能不足 5 分钟。全部操作的百分位数由原始事件计算,不对各操作的百分位数求平均。
重启后确认恢复
重启请求成功返回不代表服务已经恢复。环境监测页面对配置了健康检查的服务继续检查,观测到健康后才报告恢复。检查期限内未确认恢复时,查看当前服务状态和日志;超时不代表重启请求从未发送。
CLI 操作后重新查询 system.environment.services.list,确认目标服务健康状态,使用 system.environment.logs.query 排查。页面重启按钮针对配置健康检查的异常/停止服务,不用于重启 Runtime 管理服务自身。