track-box-logs

分类: 工具与效率 | 上传者: upstash | 下载: 0 | 版本: v1.0（最新）

在此存储库中工作并且用户要求检查、获取、总结 Upstash Box 日志或对其进行故障排除时使用。涵盖每个盒子的日志、全局日志、盒子名称到盒子 ID 的解析以及 BotStreet 盒子的本地帮助程序脚本。

更新日志: Source: GitHub https://github.com/upstash/botstreet

目录结构

当前层级: tree/main/.agents/skills/track-box-logs/

📄 SKILL.md 2.0 KB

SKILL.md

---
name: track-box-logs
description: Use when working in this repo and the user asks to inspect, fetch, summarize, or troubleshoot Upstash Box logs. Covers per-box logs, global logs, box-name to box-id resolution, and the local helper script for BotStreet boxes.
---

# Track Box Logs

Use this skill for operational debugging of BotStreet boxes.

Known box aliases:
- `claude` -> `botstreet-claude-v2`
- `gemini` -> `botstreet-gemini-v2`
- `openai` -> `botstreet-openai-v2`

Prerequisites:
- `UPSTASH_BOX_API_KEY` must be set.
- Default Box API base URL is `https://us-east-1.box.upstash.com`.
- Do not print secrets back to the user.

Preferred workflow:
1. Use the repo helper script first.
2. If the user wants raw API commands, provide the matching `curl` command.
3. Summarize the newest errors and repeated failures before broad overviews.

Helper script:

```bash
npm run logs -- [all|claude|gemini|openai|box-name|box-id] [limit]
```

Examples:

```bash
# Global logs across all boxes, latest 100
npm run logs

# One box by alias
npm run logs -- openai

# One box with more rows
npm run logs -- claude 1000

# Global logs with a larger limit
npm run logs -- all 200
```

The helper script:
- resolves `claude`, `gemini`, and `openai` to this repo's box names
- resolves box names to IDs using `setup/box-utils.ts`
- calls the Box logs API and prints JSON

Direct API fallback:

```bash
# Get logs for one box (default latest 100)
curl -H "X-Box-Api-Key: $UPSTASH_BOX_API_KEY" \
  "https://us-east-1.box.upstash.com/v2/box/{id}/logs"

# Get more logs for one box
curl -H "X-Box-Api-Key: $UPSTASH_BOX_API_KEY" \
  "https://us-east-1.box.upstash.com/v2/box/{id}/logs?limit=1000"

# Get logs across all boxes
curl -H "X-Box-Api-Key: $UPSTASH_BOX_API_KEY" \
  "https://us-east-1.box.upstash.com/v2/box/logs?limit=200"
```

When reviewing logs, prioritize:
- latest error entries
- repeated agent failures
- missing env vars or auth failures
- install/runtime errors
- schedule-triggered failures around the expected run time

登录后下载/点赞/收藏 ❤ 60 | ★ 0

track-box-logs

目录结构

SKILL.md

举报内容

提示