render-monitor について
render-monitor は、Render のサービス状態、デプロイ、ログ、メトリクス、データベースを確認するスキルです。MCP による確認を優先し、一部の作業には CLI の代替手段も案内します。
主な機能
- 01サービスとデプロイのヘルスチェック
- 02ログの絞り込みと確認
- 03CPU、メモリ、HTTP メトリクス
- 04PostgreSQL とキー・バリューの監視
- 05MCP 優先、CLI による代替
活用シーン
- 01Render のデプロイを検証
- 02サービスのエラーや遅延を調査
- 03PostgreSQL の状態と遅いクエリを確認
MCP 対応
利用可能な場合は Render MCP ツールでサービス状態、ログ、メトリクス、データベースクエリを確認します。CLI は状態やログの確認における代替手段です。
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ render-oss/ skills --skill render-monitorインストール後、Claude Code で/render-monitorを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
references/compute-plans.mddeployments.mdmetrics-guide.mdrender-access.md詳細
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 ドキュメントを参照するよう指示された場合は、必ず次の手順に従ってください。
- 利用可能な URL 取得ツールまたは
curlなどの HTTP クライアントを使って、リンク先の Markdown ドキュメントを直接取得してください。ウェブ検索の要約でドキュメントの代わりにしないでください。 - 取得が成功し、想定したドキュメントが返されたことを確認してから、その内容を読んでください。ファイルを保存したり、ファイルパスを表示したりするだけでは不十分です。
- リクエストに失敗した場合や、ツールで Markdown のレスポンスを読み取れない場合は、リンク先の HTML 版を開いて読んでください。
- どちらの版も取得できない場合は、最新の参照資料を利用できないことを明示し、スキルに記載されたトピック固有の代替手順に従ってください。安定した制約についてのみ同梱のガイダンスを使用し、変更される可能性のあるプラットフォームの詳細を推測しないでください。
複数の参照資料が必要なタスクでは、それぞれにこの手順を適用し、確認できたドキュメントと取得できなかったドキュメントを区別してください。