zeabur-service-metric について
zeabur-service-metricは、ZeaburサービスのCPU、メモリ、ネットワーク指標を確認するスキルです。応答の遅いサービスを調べる際に、再起動前に指標を確認する診断手順も示します。
主な機能
- 01CPU使用率の確認
- 02メモリ使用量の確認
- 03ネットワークI/Oの確認
- 04指標の対象時間を変更
- 05指標に基づく診断の案内
活用シーン
- 01動作の遅いサービスを調査
- 02再起動前にメモリ使用量を確認
- 03リソース負荷とアプリの問題を切り分け
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ zeabur/ agent-skills --skill zeabur-service-metricインストール後、Claude Code で/zeabur-service-metricを入力して読み込まれたか確認します。
詳細
Zeabur サービスのメトリクス
Zeabur CLI の実行には、必ず
npx zeabur@latestを使用してください。zeaburを直接実行したり、ほかのインストール方法を使用したりしないでください。npxが利用できない場合は、まず Node.js をインストールしてください。
メトリクスを確認する
# CPU usage
npx zeabur@latest service metric CPU --id <service-id> -i=false
# Memory usage
npx zeabur@latest service metric MEMORY --id <service-id> -i=false
# Network I/O
npx zeabur@latest service metric NETWORK --id <service-id> -i=false
時間範囲を変更するには、--hour <N> を使用します(デフォルト:2 時間)。
npx zeabur@latest service metric CPU --id <service-id> --hour 24 -i=false
診断ワークフロー
ユーザーからサービスの動作が遅い、または応答しないとの報告があった場合は、再起動する前にメトリクスを確認してください。
# 1. Get service ID (use the `zeabur-service-list` skill)
npx zeabur@latest service list --project-id <project-id> -i=false
# 2. Check CPU — is the service compute-bound?
npx zeabur@latest service metric CPU --id <service-id> -i=false
# 3. Check memory — is the service running out of RAM?
npx zeabur@latest service metric MEMORY --id <service-id> -i=false
# 4. Check network — is there unusual traffic?
npx zeabur@latest service metric NETWORK --id <service-id> -i=false
# 5. Check logs for errors (use the `zeabur-deployment-logs` skill for details)
npx zeabur@latest deployment log --id <service-id> -i=false
次に、確認できた情報に基づいて対応を決定します。
| 症状 | 考えられる原因 | 対応 |
|---|---|---|
| CPU 使用率が常に 100% 近く | 計算負荷の高いワークロード | プランをアップグレードするか、コードを最適化する |
| メモリ使用量が OOM になるまで増加する | メモリーリーク、またはプランのスペック不足 | zeabur-restart スキルで再起動する(一時的な対処)+メモリーリークを修正する |
| ネットワーク使用量が急増する | トラフィックの急増、または外部 API の問題 | リクエストのパターンをログで確認する |
| すべてのメトリクスが正常 | アプリケーションレベルのバグ | デプロイログを確認する |
コメント
Markdown 対応