Node.js Proxy 偵錯與疑難排解

您目前查看的是 Apigee Edge 說明文件。
前往 Apigee X 說明文件
info

建議您先確保新增至 Proxy 的 Node.js 程式碼都能正常運作,再部署至 Edge。本主題將說明如何偵錯及排解包含 Node.js 應用程式的 Proxy,並在部署後進行相關作業。

增加連線集區大小以提升效能

如果您發現效能緩慢,可以使用 maxSockets 增加預設 Node.js 連線集區大小,或完全停用集區,以解決問題。如需更多資訊和程式碼範例,請參閱 Apigee 社群中的「Node.js 效能提示:Socket 集區」。

查看 Node.js 記錄

如要查看 Node.js 應用程式的記錄資訊,請按照下列步驟操作:

  1. 在主要 API Proxy 頁面中,按一下要查看的 Proxy。
  2. 在所選 Proxy 的摘要頁面中,按一下工具列右側的「Node.js Logs」

您可以在「記錄」頁面中選取要查看的記錄時間範圍,如以下所示。記錄會記錄 HTTP 方法呼叫、呼叫成功或失敗、console.log 訊息等等。在搜尋欄位中輸入搜尋字串,以顯示包含該字串的所有記錄項目。

使用追蹤記錄工具

追蹤工具可用於一般代理偵錯。如要進一步瞭解如何使用追蹤工具,請參閱「使用 Trace 工具」。

列印控制台輸出內容

您可以在 Node.js 程式碼中嵌入 console.log 陳述式,並在追蹤工具中查看輸出內容。舉例來說,以下陳述式會列印變數 config.user 的值:

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

如要在追蹤工具中查看 console.log 訊息的輸出內容,請在追蹤工具中呼叫 API,然後按一下「Output from all Transactions」 ,開啟輸出面板:

假設您執行了以下程式碼...

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 做為 Proxy,並看到「Bad Gateway」錯誤,請嘗試增加 Nginx Proxy 逾時時間設定,如下所述:

例如:

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 模組」。