About zeabur-deployment-logs
zeabur-deployment-logs is a skill for retrieving Zeabur service deployment logs with the Zeabur CLI. It covers runtime and build logs, including how the CLI resolves the latest deployment or targets a specified one.
Key features
- 01Fetch runtime logs
- 02Fetch build logs
- 03Resolve the latest deployment automatically
- 04Target a specific deployment
- 05Filter or tail log output
Use cases
- 01Inspect recent service runtime output
- 02Review build failures
- 03Check logs for a particular deployment
Install
Copy the command and run it in a terminal.
npx skills add https:/After installing, type/zeabur-deployment-logsin Claude Code to confirm it loaded.
Details
From the project READMEZeabur Deployment Logs
Always use
npx zeabur@latestto invoke Zeabur CLI. Never usezeaburdirectly or any other installation method. Ifnpxis not available, install Node.js first.
Workflow
# 1. Get service ID (use the `zeabur-service-list` skill)
npx zeabur@latest service list --project-id <project-id> -i=false
# 2. View runtime logs
npx zeabur@latest deployment log --service-id <service-id> -t runtime -i=false 2>&1 | tail -50
Log Types
# Runtime logs (CLI auto-resolves the latest deployment if needed)
npx zeabur@latest deployment log --service-id <id> -t runtime -i=false
# Runtime logs for a specific deployment
npx zeabur@latest deployment log --service-id <id> --deployment-id <deployment-id> -t runtime -i=false
# Build logs (CLI auto-resolves the latest deployment if needed)
npx zeabur@latest deployment log --service-id <id> -t build -i=false
# Build logs for a specific deployment
npx zeabur@latest deployment log --deployment-id <deployment-id> -t build -i=false
# Watch logs (live tail)
npx zeabur@latest deployment log --service-id <id> -w -i=false
DeploymentID Behavior
The CLI automatically resolves the latest deployment when --deployment-id is not provided:
| Scenario | What happens |
|---|---|
Git/Upload service, no --deployment-id | CLI auto-resolves latest deployment → logs returned |
| Pure image service (e.g. Docker image), runtime log | No deployment exists → falls back to prebuilt query → logs returned |
| Pure image service, build log | No deployment exists → returns error (image services have no build logs) |
Explicit --deployment-id provided | Uses the provided ID directly, no auto-resolution |
Use --deployment-id when you need logs from a specific deployment (not the latest). List deployments with:
npx zeabur@latest deployment list --service-id <service-id> -i=false
Tips
| Tip | Details |
|---|---|
Use tail -50 | Logs can be verbose, pipe to tail for recent entries |
Use grep to filter | `... 2>&1 |
| Note singular | deployment log not deployment logs |
| Check service status | Look for SERVER STARTED, Ready, listening |
After diagnosing issues from logs, use the zeabur-restart skill to restart the service if needed.