Troubleshooting

❌ The Service is Unavailable

If your request fails to reach the service, it is likely caused by an unexpected outage of the service. Right now, most outages (excluding a short downtime caused by a re-deploy) are caused by the Out Of Memory (OOM) error at one of the worker pods.

The OOM error can be easily observed in Rancher, as it is indicated by a note next to the worker pod. Usually the affected pod should automatically restart and work normally. If not, feel free to report this situation to us.

⏳ Your Request Timed Out

If your request ended with a TimeoutError, it can either mean that the set timeout value is too strict for your data, or that the request got stuck unexpectedly.

You can try increasing the timeout value and sending the request again. Additionally, you might take a look at the logs of the replica where the WSI is being processed, and look for stuck progress markers (indicated by progress lines that will show the same "x" value for long periods of time). If you think the request is stuck for a longer time, feel free to report us this problem (please make sure to include all details necessary for reproduction).

🚫 Invalid WSI

If a WSI cannot be opened by the service, the request will fail with the HTTP 400 - Bad Request code.

If you encounter this error, please check if the WSI can be opened using tools like PyVips, OpenSlide, or xOpat. If not, then the WSI is likely corrupted. If you are able to open the WSI, but it cannot be opened by the service, feel free to report this problem to us.

🔎 Missing WSI levels

Sometimes, the WSI to be processed may not contain the required pyramid levels. This will cause the request to fail with the HTTP 400 - Bad Request code. The missing level can be then found in the request response.

If you encounter this kind of error, please make sure that your data contain the necessary levels. By default, levels \(1\) and \(3\) are required. If your data does not include these levels, you can use the optional request parameters sample_level and mask_level to specify alternative pyramid levels.

Tip

Currently, we are not aware of any other typical problems. However, if you encounter some unexpected behavior, feel free to report it to us.