@apminsight/native-stats
v1.0.0
Published
Exposes node v8 garbage collection stats
Downloads
4,074
Readme
Native Metrics for Site24x7 Node.js Agent
The Site24x7 Node.js agent uses @apminsight/native-stats, a native node add-on for collecting GC and event loop stats using the Chromes' V8 engine. These metrics can help improve your application's performance and identify bottlenecks in the application.
Before you can use NVM, you need to install the Site24x7 Node.js agent.
To get APM Insight NVM, follow the below given instructions.
Table of contents:
- Node VM installation
- Prerequisites to install NVM *Getting started
- Performance Metrics
Node VM installation
- The native module is automatically installed while installing the Node.js agent.(v3.0.0 or higher).
- During installation, the native module first attempts to build from the source on the target machine. If the build fails, Node.js prints a stack trace to the console, which you can ignore.
- If the native module build is successful, you can see all the metrics, including garbage collection, memory usage, event loop data, and CPU utilization. If the build fails, you can only see memory and CPU related metrics.
Prerequisites to install NVM
| Platform | Python version recommended | Python version not supported | Environment | | ------ | ------ | ------ | ------ | | Unix/Linux | v2.7 | v3.x.x | Make, C/C++ compiler (such as GCC) | | macOS | v2.7 | v3.x.x | Xcode | | Windows | v2.7 | v3.x.x | Visual C++ Build Environment |
Getting started
Gain insight into useful runtime data for troubleshooting performance issues and monitoring your application's health with NVM metrics.
To view the NVM metrics in the client:
- Log in to your Site24x7 web client
- Navigate to APM > your Node.js application > click the Node VM tab.
- Select the time frame for which you need the metrics.
You will get the graphs and metrics using which you can troubleshoot performance issues.
Performance metrics
- GC Pause Time: The amount of time spent on garbage collection. Spikes in GC time usually indicate a problem.
- GC Pause Frequency: The number of GC runs performed per minute.
- Memory Usage: The amount of memory consumed by the Node.js process.
- CPU Utilization: The CPU utilization of the Node.js process.
- Event Loop Ticks Per Minute: The number of event loop ticks per minute.
- Max CPU time per tick: The maximum amount of time spent in a single tick per minute.