Analyzer nodejs-ftrace

Name

nodejs-ftrace - Trace Node.js function call entry events

This analyzer traces JavaScript function call entry events in Node.js applications in real-time. It captures detailed information about each function invocation, including function names and optional stack backtraces. The analyzer can operate in single mode to deduplicate repeated entries or print complete call sequences with backtraces. This provides comprehensive visibility into application execution flow, helping diagnose logic errors, understand call patterns, and identify unexpected function invocations in Node.js applications.

Resource Category

CPU.

Application Type & Technical Stack

  • Node.js

Command Line Syntax

The analyzer can be invoked directly on the command-line via the orxray utility from the openresty-xray-cli software package.

Alternatively, the analyzer can also be invoked manually or automatically on the web console UI of OpenResty XRay (like on the Advanced web page).

# PID is the target process PID.
orxray analyzer run nodejs-ftrace -p PID

# trace a shell command directly
orxray analyzer run nodejs-ftrace -c SHELL_CMD

# PGID is the process group ID or any process's PID within the target process
# group.
orxray analyzer run nodejs-ftrace -p -PGID

# trace any processes started from the specified executable path.
orxray analyzer run nodejs-ftrace --exe /path/to/exe/file

Tracing Multiple Processes

Supported.

Output Formats

  • Plain Texts

Author

The OpenResty Inc. Team.

Copyright (C) by OpenResty Inc. All rights reserved.