第 34 章 响应代码跟踪
本教程介绍了如何设置和使用响应代码在 3scale 系统中。
从您的 API 产品跟踪响应代码是查看客户端如何使用 API 的方法,并实时查看是否适用于所有服务器。
要启用响应代码跟踪功能,请在使用 Docker 或 OpenShift 部署启动 APIcast 网关时将 APICAST_RESPONSE_CODES
环境变量设置为 1
或 true
。
启用后,APIcast 网关会捕获上游服务为授权调用返回的 API 响应的 HTTP 状态代码,并将它们发送到服务管理 API(在 authrep
调用中)。例如:
https://su1.3scale.net/transactions/authrep.xml?service_token={SERVICE_TOKEN}&service_id={SERVICE_ID}&user_key={USER_KEY}&usage%5Bhits%5D=1&log%5Bcode%5D=200"
在本例中,发送log[code]=200
,这意味着 API 用 200
状态代码响应。
要验证集成,使用有效的 3scale 凭证对 API 产品执行调用,然后验证在 Analytics > Usage 页面中是否正确报告了调用。
注意
- 响应代码跟踪不是所有响应的准确计数。
- 此视图的值是在一段时间内提供趋势的可视化表示。
-
响应代码跟踪和 3scale Auth 缓存模式:
None
不是支持的组合。
如果一切进展顺利,请访问 Analytics >Response codes 页面。您应该可以看到一个图形,其中含有用颜色划分的最新流量,具体取决于响应是 2xx、4xx 或 5xx。
图形工具可让您查看响应代码历史记录。您还可以检查响应代码统计信息的不同时段和不同粒度级别。只需单击时间选择条,再定义适合您需求的时间段和粒度。