Loading...
Loading...
Query and download logs from Papertrail using the paperctl CLI. Use when: (1) Downloading logs from Taskcluster workers or other systems (2) Searching for specific log entries across systems (3) Investigating CI failures by pulling worker logs (4) Listing available systems or groups in Papertrail Triggers: "papertrail", "pull logs", "worker logs", "download logs", "search logs"
npx skill4agent add jwmossmoz/agent-skills papertrailpaperctlPAPERTRAIL_API_TOKEN~/.config/paperctl/config.toml~/.cache/paperctl/logs/<system>.txtpaperctl pull <system-name># Matches vm-abc123def.reddog.microsoft.com
paperctl pull vm-abc123defpaperctl pull vm-abc123 --since -24h
paperctl pull vm-abc123 --since "2026-01-29T00:00:00" --until "2026-01-29T12:00:00"paperctl pull vm-abc123 --output ~/logs/worker.txt
paperctl pull vm-abc123 --output ~/logs/ # Uses system name as filenamepaperctl pull vm-abc,vm-def,vm-ghi --output ~/logs/paperctl search "error" --since -1h
paperctl search "error AND timeout" --since -24h --limit 100paperctl search "error" --system vm-abc123 --since -1hpaperctl search "error" --since -1h --file errors.txtpaperctl systems list| Operator | Example |
|---|---|
| AND | |
| OR | |
| NOT | |
| Exact phrase | |
| Format | Example |
|---|---|
| Relative | |
| ISO timestamp | |
| Natural language | |
--formatpaperctl pull vm-abc123 --format json
paperctl pull vm-abc123 --format csv
paperctl search "error" --output json# Get recent workers from a pool
curl -s "https://firefox-ci-tc.services.mozilla.com/api/worker-manager/v1/workers/gecko-t%2Fwin11-64-24h2-alpha" | \
jq -r '.workers | sort_by(.created) | reverse | .[0:3] | .[].workerId'
# Pull logs using partial worker ID
paperctl pull vm-abc123defpaperctl search "error" --since -1h --file errors.txtpaperctl pull vm-abc123 --since "2026-01-29T10:00:00" --until "2026-01-29T11:00:00" --output incident.txt