Skip to main content
Updated October 19, 2026 Each app page has what you need to see how the app is doing: its logs, charts for the last hour to the last week, a terminal inside a running instance, and a list of what happened to it.

Runtime logs

Open the app and go to Logs. Lines appear within seconds of your app writing to stdout or stderr, newest first, and the list refreshes every 10 seconds.
  • Type in Filter logs… to show only lines with that text.
  • Pick a level: All, Info, Warn or Error.
  • Click Download to save the lines you see.
  • When the app has pull request previews running, pick Production or a pull request under Source.
TODO: Logs tab with the filter box, level buttons and log lines

Build logs

Go to Deploys and click Log on a deploy to see its build output. A failed deploy shows why it failed in plain words, and a failed build ends with the last lines of its log.

Metrics

Go to Metrics and pick the window: 1h, 6h, 24h or 7d.
  • CPU, Memory and Instances for every app type that runs instances.
  • Requests / second, p95 latency and Responses by class (2xx to 5xx) for websites and APIs, and for private services that scale to zero.
  • Tiles at the top show the current values, the error rate and the app’s cost this month.
Cron jobs and one-off jobs have no Metrics tab: see their Runs tab instead.

Shell

Go to Shell to open a terminal inside a running instance of a website, private service or background worker. The tab appears once the app is live.
  • Pick newest running or a specific instance on the left.
  • Click Save command to keep a command you run often. Clicking a saved command types it into the terminal; press Enter to run it. Saved commands are shared with your team.
Commands run inside the live instance, and nothing you change there survives the next deploy. An app that scales to zero has no running instance while it sleeps: open its address first to wake it.
TODO: Shell tab with the instance list, saved commands and the terminal

What happened to the app

  • Overview, Recent events lists the latest events: deploys that went live or failed, scaling changes, pauses and resumes.
  • The Activity tab lists the changes made to the app and who made them. Export CSV downloads the list.

Do it from your tools

$APP_ID is the app’s ID from List app services or raff apps list. $RAFF_API_KEY is an API key. The shell is in the dashboard only. API: List runtime logs, Get deployment build logs, Get service metrics
Logs also take search, and since and until as RFC 3339 times. Metrics take window 1h, 6h, 24h or 7d. CLI

Next steps

Scale an app and let it sleep

Add instances when the charts say so.

Roll back a deploy

Go back to a deploy that worked.
Last modified on October 19, 2026