75 lines
2.6 KiB
Markdown
75 lines
2.6 KiB
Markdown
---
|
||
name: inspect-shz-logs
|
||
description: 通过有界的只读命令检查和跟踪 SHZ 后端的本地、测试及生产日志。适用于 Codex 在 shz-backend 项目中从本地 backend.log 或测试/生产环境的 backend、error、info 和 user 日志诊断启动失败、异常、请求行为、定时任务或运行时事件。
|
||
---
|
||
|
||
# 检查 SHZ 日志
|
||
|
||
使用随附脚本，不要手动拼接 SSH 命令。每次首次读取都保持范围有界；只有用户明确要求实时监控时，才跟踪日志。
|
||
|
||
## 检查本地日志
|
||
|
||
读取最后 200 行：
|
||
|
||
```bash
|
||
.codex/skills/inspect-shz-logs/scripts/view.sh local 200
|
||
```
|
||
|
||
交互式跟踪本地日志：
|
||
|
||
```bash
|
||
.codex/skills/inspect-shz-logs/scripts/view.sh local 200 --follow
|
||
```
|
||
|
||
## 检查生产日志
|
||
|
||
读取主应用日志：
|
||
|
||
```bash
|
||
.codex/skills/inspect-shz-logs/scripts/view.sh online backend 200
|
||
```
|
||
|
||
读取当前错误日志：
|
||
|
||
```bash
|
||
.codex/skills/inspect-shz-logs/scripts/view.sh online error 200
|
||
```
|
||
|
||
`online` 是现有的生产环境名称，仍受支持。`production` 是等效别名。
|
||
|
||
只选择一种日志类型：`backend`、`error`、`info` 或 `user`。只有在明确的实时监控请求中，才能将 `--follow` 作为最后一个参数添加。
|
||
|
||
## 检查测试日志
|
||
|
||
读取测试环境主应用日志：
|
||
|
||
```bash
|
||
.codex/skills/inspect-shz-logs/scripts/view.sh test backend 200
|
||
```
|
||
|
||
读取当前测试环境错误日志：
|
||
|
||
```bash
|
||
.codex/skills/inspect-shz-logs/scripts/view.sh test error 200
|
||
```
|
||
|
||
测试环境与生产环境使用相同的四种日志类型。默认测试服务器是 SSH 端口 `22` 上的 `root@47.111.103.66`；服务器布局变化时，可使用 `SHZ_TEST_SSH_HOST`、`SHZ_TEST_SSH_PORT` 和 `SHZ_TEST_LOG_DIR` 覆盖端点和日志目录。
|
||
|
||
进行关键词分析时，获取有界窗口并在本地过滤，例如：
|
||
|
||
```bash
|
||
.codex/skills/inspect-shz-logs/scripts/view.sh online error 1000 | rg -i 'exception|error|failed'
|
||
```
|
||
|
||
## 根据日志诊断
|
||
|
||
1. 确认请求涉及本地、测试还是生产行为。
|
||
2. 从相关日志读取最近 100–300 行。
|
||
3. 只有在时间戳或堆栈跟踪需要更多上下文时，才扩展到脚本允许的 5,000 行上限。
|
||
4. 关联时间戳、线程名称、异常原因和相邻请求。
|
||
5. 报告证据和可能原因，不得暴露令牌、密码、个人数据或无关日志内容。
|
||
|
||
将测试和生产访问视为只读。不得通过此 skill 重启服务、编辑文件、部署代码、截断日志或执行任意远程命令。
|
||
|
||
只有在检查服务器身份、路径或支持的日志类型时，才阅读 [references/log-locations.md](references/log-locations.md)。
|