使用适用于 Node.js 的 X-Ray 开发工具包跟踪对下游 HTTP Web 服务的调用 - Amazon X-Ray
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅中国的 Amazon Web Services 服务入门。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

使用适用于 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-5880168b-fd5153bb58284b67678aa78c",
  "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
}