render-monitor

监控 Render 服务

实时监控 Render 服务，包括运行状况检查、性能指标和日志。

何时使用此技能

用户希望进行以下操作时，启用此技能：

• 检查服务是否运行正常
• 查看性能指标
• 监控日志
• 验证部署是否正常运行
• 调查性能缓慢问题
• 检查数据库运行状况

Render 访问权限

在读取服务状态、日志、指标或数据库运行状况之前，请按照 references/render-access.md 建立访问权限，并确认目标工作区。优先使用 MCP；CLI 可以提供服务状态和日志，而指标和数据库查询需要使用 MCP。

在解读部署或运行状况检查状态之前，请阅读 references/deployments.md。

---

快速运行状况检查

运行以下 5 项检查，评估服务运行状况：

# 1. Check service status
list_services()

# 2. Check latest deploy
list_deploys(serviceId: "<service-id>", limit: 1)

# 3. Check for errors
list_logs(resource: ["<service-id>"], level: ["error"], limit: 20)

# 4. Check resource usage
get_metrics(resourceId: "<service-id>", metricTypes: ["cpu_usage", "memory_usage"])

# 5. Check latency
get_metrics(resourceId: "<service-id>", metricTypes: ["http_latency"], httpLatencyQuantile: 0.95)

---

服务运行状况

检查状态

list_services()

get_service(serviceId: "<id>")

检查部署

list_deploys(serviceId: "<service-id>", limit: 5)

请按照 references/deployments.md 解读异步状态和终止状态，确定具体部署，并在其上线后验证工作负载。

检查错误

list_logs(resource: ["<service-id>"], level: ["error"], limit: 50)

list_logs(resource: ["<service-id>"], statusCode: ["500", "502", "503"], limit: 50)

---

性能指标

CPU 和内存

get_metrics(
  resourceId: "<service-id>",
  metricTypes: ["cpu_usage", "memory_usage", "cpu_limit", "memory_limit"]
)

指标	正常	警告	严重
CPU	<70%	70-85%	>85%
内存	<80%	80-90%	>90%

HTTP 延迟

get_metrics(
  resourceId: "<service-id>",
  metricTypes: ["http_latency"],
  httpLatencyQuantile: 0.95
)

p95 延迟	状态
<200ms	极佳
200-500ms	良好
500ms-1s	令人担忧
>1s	有问题

请求数

get_metrics(
  resourceId: "<service-id>",
  metricTypes: ["http_request_count"]
)

按端点筛选

get_metrics(
  resourceId: "<service-id>",
  metricTypes: ["http_latency"],
  httpPath: "/api/users"
)

详细指标指南：references/metrics-guide.md

---

数据库监控

PostgreSQL 状态

list_postgres_instances()
get_postgres(postgresId: "<postgres-id>")

连接数

get_metrics(resourceId: "<postgres-id>", metricTypes: ["active_connections"])

查询数据库

query_render_postgres(
  postgresId: "<postgres-id>",
  sql: "SELECT state, count(*) FROM pg_stat_activity GROUP BY state"
)

查找慢查询

query_render_postgres(
  postgresId: "<postgres-id>",
  sql: "SELECT query, mean_exec_time FROM pg_stat_statements ORDER BY mean_exec_time DESC LIMIT 10"
)

键值存储

list_key_value()
get_key_value(keyValueId: "<kv-id>")

---

日志监控

最新日志

list_logs(resource: ["<service-id>"], limit: 100)

错误日志

list_logs(resource: ["<service-id>"], level: ["error"], limit: 50)

搜索日志

list_logs(resource: ["<service-id>"], text: ["timeout", "error"], limit: 50)

按时间筛选

list_logs(
  resource: ["<service-id>"],
  startTime: "2024-01-15T10:00:00Z",
  endTime: "2024-01-15T11:00:00Z"
)

流式查看日志（CLI）

render logs -r <service-id> --tail -o text

---

快速参考

MCP 工具

# Services
list_services()
get_service(serviceId: "<id>")
list_deploys(serviceId: "<id>", limit: 5)

# Logs
list_logs(resource: ["<id>"], level: ["error"], limit: 100)
list_logs(resource: ["<id>"], text: ["search"], limit: 50)

# Metrics
get_metrics(resourceId: "<id>", metricTypes: ["cpu_usage", "memory_usage"])
get_metrics(resourceId: "<id>", metricTypes: ["http_latency"], httpLatencyQuantile: 0.95)
get_metrics(resourceId: "<id>", metricTypes: ["http_request_count"])

# Database
list_postgres_instances()
get_postgres(postgresId: "<id>")
query_render_postgres(postgresId: "<id>", sql: "SELECT ...")
get_metrics(resourceId: "<postgres-id>", metricTypes: ["active_connections"])

# Key-Value
list_key_value()
get_key_value(keyValueId: "<id>")

CLI 命令（备用）

如果 MCP 工具不可用，请使用以下命令：

# Service status
render services -o json
render services instances <service-id>

# Deployments
render deploys list <service-id> -o json

# Logs
render logs -r <service-id> --tail -o text          # Stream logs
render logs -r <service-id> --level error -o json   # Error logs
render logs -r <service-id> --type deploy -o json   # Build logs

# Database
render psql <database-id>                           # Connect to PostgreSQL

# SSH for live debugging
render ssh <service-id>

服务运行正常的指标

指标	正常	警告	严重
错误率	<0.1%	0.1-1%	>1%
p95 延迟	<500ms	500ms-2s	>2s
CPU 使用率	<70%	70-90%	>90%
内存使用率	<80%	80-95%	>95%

---

参考资料

• Render 访问权限： references/render-access.md
• 计算方案： references/compute-plans.md
• 部署： references/deployments.md
• 指标指南： references/metrics-guide.md

相关技能

• render-deploy — 将新应用部署到 Render
• render-debug — 诊断并修复部署故障
• render-mcp — MCP 服务设置和功能发现

获取最新文档

每当此技能要求查阅 Render 的最新文档时：

1. 使用可用的 URL 获取工具或 HTTP 客户端（例如 curl）直接获取链接中的 Markdown 文档。不要用网页搜索摘要代替文档。
2. 确认获取成功且返回的是预期文档，然后阅读其内容。仅保存文件或打印其路径并不足够。
3. 如果请求失败，或工具无法读取 Markdown 响应，请打开并阅读对应的 HTML 版本。
4. 如果两个版本都无法获取，请说明当前无法访问该参考资料，并遵循此技能中针对相应主题的备用方案。仅将随附指南用于稳定不变的限制条件，不要猜测可能变化的平台细节。

如果任务需要多份参考资料，请对每份资料分别应用此流程，并区分已验证的文档和仍无法访问的文档。