Debug Info

Prev Next

Overview

Use this feature to include helpful debugging information in the client response -- but only when it's explicitly requested.

When a client request includes the specified header (name and value), the server adds debug information to the response in the X-OC-Debug-Info header.

Configure the Rule

Here, we'll describe how to configure the rule with the Delivery Service Management UI.

API Users may choose to build the site configuration offline.

To configure a Debug Info rule:

  1. Navigate to the Select Rule dialog.

  2. In the Select Rule dialog, choose Debug Info.

  3. Set the rule parameters:

    • Request Header Name - Enter the name of the HTTP header that the client request must include to trigger debugging.
    • Request Header Value - Enter the value the header must have to enable debugging.

    DebugInfoRule.png

    When the client request includes the specified header name and value, the CDN adds the X-OC-Debug-Info header to the response. The header contains debugging data such as internal identifiers and transaction details.

  4. Choose Add Rule.

Example Response

< x-oc-debug-info: {
  "listenSock": "127.0.0.1:8080",
  "trxId": "1000000000047b22-1234567-1",
  "sig": "abc123fakeSig",
  "serviceType": "LIVE",
  "disk": "1",
  "cacheStatus": "MISS",
  "cacheKey": "59a6c1bb29e77bd1a34b027fd1234567",
  "cacheKeyStr": "stream1/fakevideo.isml/dash/3-5-video=450000.dash&filter=none&t=0&vbegin=0",
  "cacheExpiry": "0",
  "proxyType": "ORIGIN",
  "proxyDest": "origin.example.com",
  "proxyAddr": "203.0.113.42:80",
  "proxyStatus": "404",
  "rr": "kProxyResponse4xx",
  "prr": "kNginxCacheMiss",
  "cpFailure": "kStatus4xx"
}

SVTA Component: QW.DebugHeaderRule

When you save the configuration version, the QW.DebugHeaderRule SVTA component is added to the configuration JSON. This is a private feature developed by Qwilt.

The configuration object specifies the header and value as match conditions. In this example, debugging information is included when the client requests includes the X-Qwilt-Debug header with the value true. The response will include an X-OC-Debug-Info header with additional data.

{
  "generic-metadata-type": "MI.PrivateFeature.Qwilt.QW.DebugHeaderRule",
  "generic-metadata-value": {
    "request-header-name": "X-Qwilt-Debug",
    "request-header-value": "true"
  }
}