What happens during an outage
With a Forward endpoint, GetRequest proxies every incoming request to your upstream URL. When your backend is unreachable or returns an error, GetRequest still does its job:- The full incoming request is captured — method, path, headers, and body.
- The upstream response is recorded, including
5xxerrors, timeouts, and connection failures. - The original caller receives the upstream error status directly.
- A log entry is saved with complete failure details.
The 3-second timeout
Forward endpoints wait up to 3 seconds for your upstream to respond. If your backend takes longer — or doesn’t respond at all — GetRequest returns:The 3-second limit applies to the upstream connection and response time. GetRequest’s own processing overhead is well under 5ms.
Identify what failed
Open Logs and filter by status code to surface everything that failed during the incident:- Set the Status filter to
5xxor504. - Set the Time range to the incident window.
- Click any row to inspect the full request — what the caller sent, what your backend returned (or failed to return), and how long it took.
Recovery steps
Once your backend is healthy again, follow these steps to restore the lost traffic:1
Confirm recovery
Send a test request to your endpoint and verify you receive a
2xx response before attempting any replays.2
Find the failed requests
In Logs, filter by
5xx and 504 status codes and set the time range to your incident window. Every failed request is listed there.3
Replay each request
Open a failed log entry and click Replay (Pro). GetRequest re-fires the exact original request — same method, headers, query parameters, and body — to your upstream.
4
Verify the response
Confirm the replay returns a
2xx. The new response appears immediately in the log detail view alongside the original failure.Switch to JSON mode during planned maintenance
If you’re taking your backend down intentionally — for a deploy, a migration, or scheduled maintenance — switch affected endpoints to JSON mode before you start. This eliminates 504s entirely and keeps callers informed:- Edit the endpoint and change Action to
JSON. - Set a meaningful response body, such as a maintenance message or a cached last-known-good payload.
- Callers receive your JSON response immediately instead of a 504.
- All requests during the maintenance window are still logged.
- When your backend is back, switch the endpoint back to
Forwardand replay anything that came in during the window.