3.5. 调试

设置网关配置很容易，但您可能仍会遇到错误。在这种情况下，网关可以返回有用的调试信息来跟踪错误。

要从 APIcast 获取调试信息，您必须将以下标头添加到 API 请求中： X-3scale-debug: {SERVICE_TOKEN}，其服务帐户令牌与您要访问的 API 服务对应的服务令牌对应。

当找到标头且服务令牌有效时，网关会将以下信息添加到响应标头中：

X-3scale-matched-rules: /v1/word/{word}.json, /v1
X-3scale-credentials: app_key=APP_KEY&app_id=APP_ID
X-3scale-usage: usage%5Bversion_1%5D=1&usage%5Bword%5D=1

X-3scale-matched-rules 表示在用逗号分开的列表中为请求匹配了哪些映射规则。

标头 X-3scale-credentials 返回传递给 3scale 后端的凭证。

x-3scale-usage 表示报告到 3scale 后端的使用情况。usage%5Bversion_1%5D=1&usage%5Bword%5D=1 是一个 URL 编码的 usage[version_1]=1&usage[word]=1，显示 API 请求递增方法(metrics) version_1，并按 1 按 单词。