本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
使用适用于 Node.js 的 X-Ray 开发工具包跟踪对下游 HTTP Web 服务的调用
当应用程序对微服务或公共 HTTP API 发出调用时,您可以使用适用于 Node.js 的 X-Ray 开发工具包客户端来检测这些调用,并将 API 作为下游服务添加到服务图。
将您的 http
或 https
客户端传递给适用于 Node.js 的 X-Ray 开发工具包的 captureHTTPs
方法以跟踪传出调用。
注意
支持通过 captureHTTPsGlobal()
API 使用第三方 HTTP 请求库(如 Axios 或 Superagent)进行调用,并且在使用原生 http
模块时仍会跟踪它们。
例 app.js - HTTP 客户端
var AWSXRay = require('aws-xray-sdk');
var http = AWSXRay.captureHTTPs(require('http'));
要在所有 HTTP 客户端上启用跟踪,请先调用 captureHTTPsGlobal
,然后加载 http
。
例 app.js - HTTP 客户端(全局)
var AWSXRay = require('aws-xray-sdk');
AWSXRay.captureHTTPsGlobal(require('http'));
var http = require('http');
当您检测对下游 Web API 的调用时,适用于 Node.js 的 X-Ray 开发工具包记录一个子分段,其中包含有关 HTTP 请求和响应的信息。X-Ray 使用子分段为远程 API 生成推断分段。
例 下游 HTTP 调用的子分段
{
"id": "004f72be19cddc2a",
"start_time": 1484786387.131,
"end_time": 1484786387.501,
"name": "names.example.com",
"namespace": "remote",
"http": {
"request": {
"method": "GET",
"url": "https://names.example.com/"
},
"response": {
"content_length": -1,
"status": 200
}
}
}
例 下游 HTTP 调用的推断分段
{
"id": "168416dc2ea97781",
"name": "names.example.com",
"trace_id": "1-62be1272-1b71c4274f39f122afa64eab",
"start_time": 1484786387.131,
"end_time": 1484786387.501,
"parent_id": "004f72be19cddc2a",
"http": {
"request": {
"method": "GET",
"url": "https://names.example.com/"
},
"response": {
"content_length": -1,
"status": 200
}
},
"inferred": true
}