fly-logs · git:20260711.696597d · 2026-07-11 · sha256 065fc31fb5e719e4

fly-logs git:20260711.696597dA

Immutable. This exact content never changes and is served at /api/v1/blob/065fc31fb5e719e4.

No tool to install first
claude plugin marketplace add https://markdownregistry.com/mp/a/art_5xoasrkb55ttdhtv/065fc31fb5e719e449d89cc8cf3bc8bfce904b5f5eef96c17dccf0ed409bf85e.json

Then /plugin install fly-logs@markdownregistry-5xoasrkb55ttdhtv in Claude Code. It installs this exact version, the one graded A here, pinned to the commit it was graded at, and leaves it there.

---
name: fly-logs
description: >-
  Fetch and filter production logs from Fly.io apps. Trigger on "посмотри
  логи", "check prod logs", "что в логах", or when debugging any production
  issue on a Fly-hosted app.
---

# Fly logs

## Fetch

```bash
fly apps list                              # find the app name
fly logs -a <app>                          # live tail
fly logs -a <app> --no-tail | tail -200    # recent burst, non-blocking
fly logs -a <app> -i <machine-id>          # one machine only
```

`fly logs` tails by default; for analysis prefer `--no-tail` piped through
grep so the command terminates.

## Filter

```bash
fly logs -a <app> --no-tail | grep -iE 'error|traceback|exception' | tail -50
fly logs -a <app> --no-tail | grep ' 500 '       # server errors on requests
fly logs -a <app> --no-tail | grep '<endpoint>'  # one route's traffic
```

## Read the result properly

- A traceback's LAST frame in app code (not library code) is where to look.
- Repeated identical errors every N seconds = a crash-looping background job
  or health check, not user traffic.
- Shape-mismatch / feature-names errors on prediction routes = FEATURE_COLS
  drift between serving and training repos; fix the sync, don't restart.
- For deeper analysis hand the evidence to the `debugger` subagent.