Skip to content

Commit 65ec0d3

Browse files
committed
Add troubleshooting docs for API request errors (#1165)
(cherry picked from commit 25fa192)
1 parent f211d34 commit 65ec0d3

File tree

2 files changed

+8
-0
lines changed

2 files changed

+8
-0
lines changed

docs/summary.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -46,6 +46,7 @@
4646
## Troubleshooting
4747

4848
* [API is stuck updating](troubleshooting/stuck-updating.md)
49+
* [404/503 API responses](troubleshooting/api-request-errors.md)
4950
* [NVIDIA runtime not found](troubleshooting/nvidia-container-runtime-not-found.md)
5051
* [TF session in predict()](troubleshooting/tf-session-in-predict.md)
5152

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,7 @@
1+
# 404 or 503 error responses from API requests
2+
3+
When making prediction requests to your API, it's possible to get a `{"message":"Not Found"}` error message (with HTTP status code `404`), or a `no healthy upstream` error message (with HTTP status code `503`). This means that there are currently no live replicas running for your API. This could happen for a few reasons:
4+
5+
1. It's possible that your API is simply not ready yet. You can check the status of your API with `cortex get API_NAME`, and stream the logs with `cortex logs API_NAME`.
6+
1. Your API may have errored during initialization or while responding to a previous request. `cortex get API_NAME` will show the status of your API, and you can view the logs with `cortex logs API_NAME`.
7+
1. If `cortex get API_NAME` shows your API's status as "updating" for a while and if `cortex logs API_NAME` doesn't shed any light onto what may be wrong, please see the [API is stuck updating](stuck-updating.md) troubleshooting guide.

0 commit comments

Comments
 (0)