调试 Node.js 代理和对其进行问题排查

您正在查看 Apigee Edge 文档。
前往 Apigee X 文档
信息

最好先确保您添加到代理的所有 Node.js 代码都能正常运行,然后再将其部署到 Edge。本主题介绍了在部署后调试和排查包含 Node.js 应用的代理的方法。

增加连接池大小以提高性能

如果您发现性能缓慢,可通过使用 maxSockets 增加默认的 Node.js 连接池大小或者完全停用套接字池来解决问题。如需了解详情并查看示例代码,请参阅 Apigee 社区中的 Node.js 性能提示:套接字池

查看 Node.js 日志

如需查看有关 Node.js 应用的日志信息,请执行以下操作:

  1. 在主 API 代理页面中,点击要查看的代理。
  2. 在所选代理的摘要页面中,点击工具栏右侧的 Node.js 日志

在“日志”页面中,您可以选择要查看的日志时间范围,如下所示。日志会记录 HTTP 方法调用、调用成功或失败、console.log 消息等。在搜索字段中输入搜索字符串,以显示包含该字符串的所有日志条目。

使用轨迹工具

跟踪工具适用于常规代理调试。如需详细了解如何使用跟踪工具,请参阅使用跟踪工具

输出控制台输出

您可以在 Node.js 代码中嵌入 console.log 语句,并在轨迹工具中查看输出。例如,以下语句会输出变量 config.user 的值:

console.log('Logging in as %s', config.username);

如需在轨迹工具中查看 console.log 消息的输出,请在轨迹工具中调用您的 API,然后点击从所有事务输出 以打开输出面板:

假设您已执行以下代码...

var http = require('http');

console.log('node.js application starting...');

var svr = http.createServer(function(req, resp) {
    resp.end('Hello, World!');
});

svr.listen(9000, function() {
    console.log('Node HTTP server is listening');
});

... 控制台语句会显示在该面板中:

配置 Nginx 目标超时设置

如果您使用 Nginx 作为代理,并看到“Bad Gateway”错误,请尝试延长 Nginx 代理超时配置,如下所述:

例如:

proxy_connect_timeout       60;
proxy_read_timeout          120;

您可以根据服务器的响应时间来确定理想的超时配置。例如,45-60 秒的读取超时时间可能是提供合理缓冲区的理想选择。

配置 Apigee 目标超时设置

您还可以在 TargetEndpoint 的 HttpTargetConnection 元素中配置 Apigee 默认超时值。默认值如下:

connect.timeout.millis - 60 seconds
io.timeout.millis - 120 seconds
<HTTPTargetConnection>
    <Properties>
        <Property name="connect.timeout.millis">5000</Property>
        <Property name="io.timeout.millis">5000</Property>
    </Properties>
    <URL>http://www.google.com</URL>
</HTTPTargetConnection>

另请参阅端点属性参考文档

了解详情

如需详细了解调试,请参阅:

后续步骤

如需了解 Apigee Edge 中的 Node.js 模块支持,包括对 HTTP/HTTPS、TLS 和其他高级主题的支持,请参阅了解 Edge 对 Node.js 模块的支持