Accessing your logs
Every request to your Fyra app is logged. The fyra logs command
gives you multiple ways to view, filter, pipe, and export those logs — whether
you want a live terminal dashboard or a file you can hand off to another tool.
Open the log viewer
Run fyra logs from any directory that has a .deploy.yaml file. This launches an interactive terminal UI that streams new requests in real time.
The viewer polls for new entries every 3 seconds. Logs are deduplicated across server nodes, so you see a single coherent stream.
Navigate the TUI
Use keyboard shortcuts to move around and inspect individual requests:
Scroll past the bottom to load older entries automatically — the viewer paginates backwards as needed.
Pressing Enter on a row opens a detailed view of that request:
The detail view shows the full user-agent string, the server node that handled the request, and cache status — information that doesn't fit in the table columns. Press Esc to return to the log stream.
Filter by time
Use --since to start from a specific point in time. Accepts relative expressions or absolute timestamps.
Pipe logs to other tools
When stdout is redirected or piped, the TUI is replaced with a plain-text stream — one log line per request. Use --format to control the output shape and --follow to keep streaming new entries as they arrive.
The --follow flag keeps the connection open and prints new lines as requests come in. Combine it with grep, jq, awk, or any tool that reads from stdin.
Export logs to a file
Use --output to dump logs directly to a file without the TUI. Fyra fetches all available pages and writes them out. This is the easiest way to get a file you can feed into log analysis tools.
The combined format is recommended for file exports — it includes referer and user-agent data that most analysis tools expect.
No logs yet? Logs only appear after your first fyra push. If you've just deployed, give it a minute and try again.
