mcpField
M
monitor

monitor

github.com/permaweb云与 DevOps445 次安装35 周前更新
代码仓库

关于 monitor

AO Monitor CLI 是用于查询 AO Task Monitor 服务的 Node.js 命令行工具，适合监控 AO 进程与排查任务问题。它提供系统概览、任务指标、告警和可筛选的执行日志查询。

主要功能

  1. 01查询系统与任务指标
  2. 02查看当前告警
  3. 03按条件筛选和分页日志
  4. 04支持 JSON 与文本输出
  5. 05提供通用 API 请求命令

适用场景

  1. 01检查 AO 任务运行状况
  2. 02调查失败或超时的执行
  3. 03查看特定任务的指标与日志

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/permaweb/skills --skill monitor

安装后在 Claude Code 中输入/monitor确认已加载。

附带文件index.mjs

详细介绍

AO Monitor CLI

用于 AO Task Monitor 服务的 Node.js 命令行界面。查询系统运行状况、查看警报、分析日志并监控 AO 进程性能。

概览

  • 位置：skills/monitor/index.mjs
  • 运行环境：Node.js 18+
  • 依赖项：无（使用内置的 fetch）
  • 默认 API：https://ao-task-monitor.onrender.com

适用场景

在以下情况下使用此 CLI：

  • 监控 AO 进程的运行状况和性能
  • 检查系统警报或失败的任务
  • 查看和筛选执行日志
  • 分析任务指标和成功率
  • 排查 AO 进程问题
  • 快速获取 AO 进程的状态更新

身份验证设置

CLI 需要通过环境变量设置 API 密钥。

获取 API 密钥

联系 AO Task Monitor 服务管理员获取 API 密钥。

配置环境

对于 zsh（~/.zshrc）：

# Add to ~/.zshrc
export AO_MONITOR_KEY="YOUR_KEY_HERE"

# Reload
source ~/.zshrc

对于 bash（~/.bashrc）：

# Add to ~/.bashrc
export AO_MONITOR_KEY="YOUR_KEY_HERE"

# Reload
source ~/.bashrc

临时设置（仅当前会话有效）：

export AO_MONITOR_KEY="YOUR_KEY_HERE"

单条命令覆盖：

node skills/monitor/index.mjs summary --token "YOUR_KEY_HERE"

命令

summary

获取所有受监控任务的系统级概览。

node skills/monitor/index.mjs summary

选项：

  • --period <1h|4h|8h|24h|48h> - 指标的时间范围
  • --include <csv> - 要包含的字段（例如，counts,kpis,latency）
  • --format <json|text> - 响应格式（默认：json）

示例：

# Default summary
node skills/monitor/index.mjs summary

# Last 24 hours, text format
node skills/monitor/index.mjs summary --period 24h --format text

# Only counts and KPIs
node skills/monitor/index.mjs summary --include counts,kpis
task

获取特定任务的详细指标。

node skills/monitor/index.mjs task <taskId>

选项：

  • --period <1h|4h|8h|24h|48h> - 指标的时间范围
  • --include <csv> - 要包含的字段
  • --format <json|text> - 响应格式

示例：

# Get ao-token-info task details
node skills/monitor/index.mjs task ao-token-info

# With 48-hour window and text output
node skills/monitor/index.mjs task ao-token-info --period 48h --format text
alerts

查看当前系统警报和问题。

node skills/monitor/index.mjs alerts

选项：

  • --period <1h|4h|8h|24h|48h> - 警报的时间范围
  • --format <json|text> - 响应格式

示例：

# Current alerts
node skills/monitor/index.mjs alerts

# Last 4 hours, text format
node skills/monitor/index.mjs alerts --period 4h --format text
logs

查看执行日志，可按任务筛选。

# All logs
node skills/monitor/index.mjs logs

# Task-specific logs
node skills/monitor/index.mjs logs <taskId>

选项：

  • --limit <n> - 最大结果数（默认：100，最大：1000）
  • --offset <n> - 分页偏移量
  • --status <success|failure|timeout> - 按执行状态筛选
  • --error-type <string> - 按错误消息子字符串筛选
  • --since <isoTimestamp> - 此时间之后的日志
  • --until <isoTimestamp> - 此时间之前的日志
  • --task-id <taskId> - 按任务 ID 筛选（可替代位置参数）

示例：

# Recent logs
node skills/monitor/index.mjs logs

# Task-specific logs
node skills/monitor/index.mjs logs ao-token-info

# Failed executions only
node skills/monitor/index.mjs logs --status failure

# Logs with 503 errors
node skills/monitor/index.mjs logs --error-type 503

# Last 50 logs since yesterday
node skills/monitor/index.mjs logs --limit 50 --since 2024-01-01T00:00:00Z

# Paginated results
node skills/monitor/index.mjs logs --limit 100 --offset 100
docs

从服务端获取 API 文档。

node skills/monitor/index.mjs docs
request

对其他命令未涵盖的端点发起通用 API 请求。

node skills/monitor/index.mjs request <endpoint> <method> [body]

参数：

  • endpoint - API 路径（例如，/v1/summary）
  • method - HTTP 方法（GET、POST、PUT、DELETE）
  • body - POST/PUT 请求的 JSON 正文（可选）

示例：

# GET request
node skills/monitor/index.mjs request /v1/summary GET

# GET with query params
node skills/monitor/index.mjs request "/v1/summary?format=text" GET

# POST with JSON body
node skills/monitor/index.mjs request /v1/api/agent POST '{"task_id":"123","status":"running"}'

# PUT request
node skills/monitor/index.mjs request /v1/api/agent/456 PUT '{"name":"Updated Agent"}'

全局选项

以下选项适用于所有命令：

选项说明
--base-url <url>覆盖 API 基础 URL
--token <token>覆盖身份验证令牌（而非 AO_MONITOR_KEY）
--timeout-ms <ms>请求超时时间，单位为毫秒（默认：30000）
--help, -h显示帮助信息

示例：

# Use different API server
node skills/monitor/index.mjs summary --base-url https://my-monitor.example.com

# Override token for single request
node skills/monitor/index.mjs alerts --token "different_key"

# Longer timeout for slow connections
node skills/monitor/index.mjs logs --timeout-ms 60000

查询参数参考

适用于 summary、task、alerts
参数取值说明
--period1h、4h、8h、24h、48h指标的时间范围
--include字段的 CSV 列表响应中要包含的字段
--formatjson、text响应格式

include 字段选项：

  • counts - 执行次数
  • kpis - 关键绩效指标
  • latency - 响应时间指标
适用于 logs
参数类型说明
--limit整数最大结果数（1-1000，默认：100）
--offset整数分页偏移量
--status字符串success、failure 或 timeout
--error-type字符串按错误子字符串筛选
--sinceISO 时间戳此时间之后的日志
--untilISO 时间戳此时间之前的日志
--task-id字符串按任务 ID 筛选

常见用例

检查系统运行状况
# Quick overview
node skills/monitor/index.mjs summary --format text

# Check for any alerts
node skills/monitor/index.mjs alerts
调查任务失败
# See if task has issues
node skills/monitor/index.mjs task ao-token-info --period 24h

# Get recent failures
node skills/monitor/index.mjs logs ao-token-info --status failure --limit 20

# Search for specific error
node skills/monitor/index.mjs logs --error-type "503" --limit 50
查看近期活动
# Last 100 logs
node skills/monitor/index.mjs logs

# Last hour of logs
node skills/monitor/index.mjs logs --since "$(date -u -v-1H +%Y-%m-%dT%H:%M:%SZ)"

# Successful runs only
node skills/monitor/index.mjs logs --status success --limit 50
监控特定任务
# Task metrics
node skills/monitor/index.mjs task ao-token-info --include counts,kpis,latency

# Task logs
node skills/monitor/index.mjs logs ao-token-info --limit 50
调试超时
# Find timeout issues
node skills/monitor/index.mjs logs --status timeout

# Check latency metrics
node skills/monitor/index.mjs summary --include latency

错误处理

缺少身份验证

如果未设置 AO_MONITOR_KEY 且未提供 --token：

Error: No authentication token provided.

Set the AO_MONITOR_KEY environment variable:
  export AO_MONITOR_KEY="your_key_here"

Or use the --token flag:
  node skills/monitor/index.mjs summary --token "your_key_here"
身份验证失败

401 Unauthorized 或 403 Forbidden：

  • 确认 AO_MONITOR_KEY 正确
  • 检查密钥是否已过期
  • 确保密钥有权访问请求的资源
API 错误

非 2xx 响应会显示：

  • HTTP 状态码
  • 服务端返回的错误消息
Error: Request failed with status 404
Not Found: Task 'invalid-task' does not exist
网络/超时错误
  • 默认超时时间为 30 秒
  • 对于较慢的连接，可使用 --timeout-ms 延长超时时间
  • 如果请求失败，请检查网络连接

示例速查表

# System overview
node skills/monitor/index.mjs summary

# Text format summary
node skills/monitor/index.mjs summary --format text

# Last 24h summary
node skills/monitor/index.mjs summary --period 24h

# Check alerts
node skills/monitor/index.mjs alerts

# Task details
node skills/monitor/index.mjs task ao-token-info

# Recent logs
node skills/monitor/index.mjs logs

# Task logs
node skills/monitor/index.mjs logs ao-token-info

# Failed runs
node skills/monitor/index.mjs logs --status failure

# Search errors
node skills/monitor/index.mjs logs --error-type "503"

# API docs
node skills/monitor/index.mjs docs

# Custom request
node skills/monitor/index.mjs request /v1/summary GET

评论

支持 Markdown