Debugging and troubleshooting Node.js proxies
It's a good practice to make sure any Node.js code you add to a proxy works before you deploy it to Edge. This topic discusses ways to debug proxies that include Node.js applications after they are deployed.
To view log information about your Node.js application:
- In the main API proxies page, click on the proxy you wish to view.
- In the summary page of the selected proxy, click Node.js Logs on the right-hand side of the tool bar.
The Node.js Logs button does not appear for non-Node.js API proxies.
In the Logs page, you can select a time range of logs to view, as shown below. The logs record HTTP method calls, success or failure of calls, console.log messages, and so on. Enter a search string in the search field to display all log entries that contain the string.
The trace tool is useful for general proxy debugging. For detailed information on using the trace tool, see Using the Trace tool.
You can embed console.log statements in your Node.js code and view the output in the trace tool. For example, the following statement prints the username of the user who is logging in to access the proxy:
console.log('Logging in as %s', config.username);
You can view the output of this console.log message in the trace tool. Simply call your API in the trace tool and open the Script Output panel of the final response, as shown below.
To learn more about debugging, see:
- Using the Trace tool
- Using performance metrics
- Audits: API, Product, and organization history
This section provides troubleshooting tips and information for Node.js in Edge.
Node.js performance degradation can occur when connection pool settings are too low. See Node.js Performance Tips: Socket Pooling in the Apigee Community for information on increase connection pool size with
For information about Node.js module support in Apigee Edge, including information about support for HTTP/HTTPS, TLS, and other advanced topics, see Understanding Edge support for Node.js modules.
Help or comments?