2.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 和 word 增加 1 个 hit。