Debug codes

Learn the meaning of the debug strings

In Transparent Edge, every response is logged with a TCDN-Debug code, that helps us to check what happened with a request in a glance. You can see it in the analytics section of the dashboard

Every code has two parts: the reason and the request id (XID), separated with a colon (`:`). The XID is a unique representation of the request/response and can be disregarded; it's only a identifier we at Transparent Edge use for finding a specific request in the logs.

The reason is far more interesting, because tells us things about the response in case of error. Below is a table including the most common reasons:

ReasonExplanation

TCDN-OK

Everything is fine. Should be the most common reason code.

TCDN-RPE-XXX

RPE is for Request Processed at Edge. The XXX matches the code used in VCL code for processing this request. A TCDN-Command of deny_request or a redirect reners this debug code. You will only see this request in CDN logs, because request and response are entirely managed at the edge node, without any intervention of the backend.

TCDN-BENG-XXX

BENG is for Backend Error, No Grace. This error should appear if the request is a MISS, and the origin server renders a error code ( > 500). If the CDN node has a stale content and the grace isn't disabled by the VCL config, stale content should be served instead the error. This type of error usually tells the backend is giving the XXX error originally, so it must be fixed in the origin.

TCDN-BENG-Service unavailable

Very similar to the previous one. There's no content cached in the node for that URL, and there's a problem with the MISS request. In this case, the backend server couldn't be reached for a reply. Usually means a network problem, usually caused by a firewall or IDS blocking requests from our nodes. It also could mean that your configured healthcheck is returning an incorrect status code, so we're marking your backend as unavailable.

TCDN-SBPR-XXX

SBPR is for Sick Backend, POST/PUT Request. Since usually the only cacheable objects are URLs asked with the GET method, any POST/PUT requests would be uncacheable by default, and hence any stale mechanism is not applied. The XXX part is the original error answered by the backend. Should be fixed in the origin app.

TCDN-DNF

DNF is for `Domain Not Found`. You should see it if a domain is pointing via CNAME to Transparent, but no VCL configuration assigning a backend to that hostname is available.

TCDN-E

Unknown error. If you're seeing this, please contact us, including the XID of the request so we can debug the problem.

TCDN-RPE-GRL-429-Too Many Requests

The request has been stopped by our global rate-limit system, this is a safeguard to protect origin against big and sudden traffic spikes, if your site usually has those kind of spikes coming from legit traffic contact with our support to increase it.

TCDN-RPE-Under Attack

The request has been halted by our "Under Attack" mode.

If this is a legitimate user using a normal web browser (like Chrome, Firefox, or Safari). Our system will quickly check and then automatically redirect to the original page.

TCDN-RPE-UA-429-Too Many Requests

This message appears when we've stopped a request several times in a row because our "Under Attack" mode thinks it might be harmful. This often happens if the requests come too frequently, more than what we expect from regular users. This could mean that the requests are coming from a tool or program that's sending too many requests too quickly, or it might be someone trying to cause trouble on purpose.

TCDN-RPE-UA-403-Denylist

Under Attack Mode is enabled and the IP Address is present on our deny list because it has been involved in attacks in the past.

Last updated