LogoLogo
  • Welcome
  • Landing in Transparent Edge
  • Sign up process
  • Getting Started
    • Basics concepts
      • Glosary
        • API
        • Brotli Compression
        • Cache-Control
        • Cache key
        • Caching
        • CNAME
        • Cloud Computing
        • Cloud Computing Architecture
        • Cloud Services
        • DASH
        • Data Center
        • Edge Server
        • ETag
        • GSLB
        • HLS (HTTP Live Streaming)
        • HTTP/2
        • Infrastructure as a Service (IaaS)
        • Internet Exchange Point
        • Last-Modified
        • Load Balancing
        • MultiCDN
        • NoSQL (not only SQL)
        • Origin
        • Origin Shield
        • OTT (Over The Top)
        • Platform as a Service (PaaS)
        • PoP (Point of Presence)
        • Private CDN
        • Private Cloud
        • Public Cloud
        • Purge
        • Query String
        • Reverse Proxy
        • RTT (Round-trip Time)
        • SaaS (Software as a Service)
        • SDS (Software Defined Storage)
        • Smooth Streaming
        • Status Code
        • TCP (Transmission Control Protocol)
        • TLS Acceleration
        • TLS (Transport Layer Security)
        • TTFB (Time-to-first-byte)
        • TTL (Time-to-live)
        • Virtual Machine
        • VPS (Virtual Private Server)
        • Web Services
      • Let's start at the beginning
      • Things to consider
      • Houston, we have a problem
      • HTTP, How does it work?
      • Invalidating methods
      • DNS Pointing
      • Log formats
      • Predefined headers
      • Default headers
        • geo_country_code
        • X-Device
        • Vary
        • Cache headers
        • Age
        • TP-Cache
        • True-Client-IP and X-Forwarded-For
      • Forcing No-Cache
      • Architecture
        • Transparent Edge’s IP addresses
        • Locations and PoP
        • Cache layers
      • Cache effectiveness
      • SSL
      • HTTP 5xx Error Codes
      • Features
        • Protection against origin failures
        • Rate Limit
        • Geolocation and geoblocking
        • Prefechting
        • Refetching
        • Fast purging
        • HTTP Redirects
        • Caching static vs. dynamic objects
        • Rewriting of headers
        • Device detection
    • Dashboard
      • Historic
      • Analytics
      • Invalidating content
      • Content invalidation by tags
      • Prefetching Cache
      • Log shipping
      • Provisioning
        • Initial configuration
        • Backends
        • Sites
        • Configuration deployments
        • Network ACLs
        • TLS/SSL Certificates
      • User management
  • Configuration
    • VCL Reference
      • Default Functions
      • VCL Objects
      • Callable Functions
      • Security restrictions
      • Varnish book
    • Network Access Control List
      • Initial configuration
      • Auto generated lists
      • Manage lists via API
    • i3
      • Quality adjustment
      • Cache timing allocation for transformed images
      • Conversion to grayscale
      • Conversion to WebP
      • Blurring
      • Inclusion of graphics in the footer (strip)
      • Automatic resizing
      • Definition of the maximum size (content-length)
    • Transcoding
      • Relaunch or requeue jobs
      • Create a transcode job
      • Get job information
      • Dashboard usage
    • OpenAPI de TransparentCDN
  • Security
    • HTTPS
    • Blocking User-Agent
    • Blocking by IP Address
    • Blocking Requests Geographically
    • Avoiding Hotlinking
    • Bot Mitigation
    • WAF
      • Configuration
      • CAPTCHA
      • Content protected by token
      • Rate limit
    • Anomaly Detection
      • Detection Types
      • Automatic Reactions
      • Detection History
    • Under attack mode
    • Global Whitelists
  • Integrations
    • Wordpress plugin
    • Google Cloud Platform
    • Amazon Web Services
  • GUIDES AND TUTORIALS
    • How to do things
    • Edge Computing
      • ESI Tags
    • Acting on the Query String
    • Working with cookies
    • Making decisions based on HTTP headers
    • Web Application Gateway
    • Configure your servers to send cache headers
    • Caching a version per device
    • True-Client-IP in the origin
    • A/B Testing
    • Routing traffic to different backends
    • JSON Web Tokens
    • Debug codes
    • Streaming logs
    • API
      • Authentication
      • Invalidation
Powered by GitBook
On this page

Was this helpful?

Export as PDF
  1. GUIDES AND TUTORIALS

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:

Reason
Explanation

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.

PreviousJSON Web TokensNextStreaming logs

Last updated 1 year ago

Was this helpful?