Basic troubleshooting tips for the APM Insight Node.js agent
If you have installed the APM Insight Node.js agent and are facing issues with it, follow the instructions below to troubleshoot your application.
License key and logs
- Check whether your apminsightnode.json file contains the correct license key (Refer Site24x7 APM Insight page for the correct license key).
- Check the agent logs (located in the apminsightdata directory where you run the application) for any network communication warnings.
Message | Cause | Corrective action |
LICENSE_EXPIRED | Your license has expired, or there has been a delay in bill payments. | Upgrade your plan. |
LICENSE_INSTANCES_EXCEEDED | The limit on the number of advanced monitors has been reached. Agent communication happens once every 15 minutes, so invalid licenses won't be reflected immediately. | Ensure you have sufficient advanced monitor licenses and the correct license keys. |
MARKED_FOR_DELETE | Your application has been marked for deletion (Trying to add a monitor after deleting it in the Site24x7 console). | Navigate to the apminsightdata folder to delete the apminsight.json file. Delete it and restart the application. (This will recycle the app pools). |
UNMANAGE_AGENT | Your application has been suspended. | If it is suspended due to autoscaling, it will be activated automatically. If not, please activate it from the site24x7 client. |
- Check the apminsight.json file (located in the apminsightdata directory where you run the application) for the key "status." If it is "900," delete the file and restart the server.
- apminsightnode.json file should not have any line comments.
- JSON is a data-only format. JSON does not permit comments of the form //, #, or /* */, which are commonly used in programming languages. You may add comments to JSON as custom JSON elements that will hold your comments, but these elements will still be data.
- If the apminsightdata folder is not created, check for any console print related to APM Insight. The console print will provide details on how to add an agent. In addition, if an error occurs, it will be printed there.
Proxy and Firewall settings
- If your server has a proxy configuration, provide the proxy details in the apminsightnode.json file. Check the help document for more information.
- Check your firewall settings—Site24x7 agent collects and sends data to the Site24x7 servers (plusinsight.site24x7.com) via port 443. If your firewall settings block connections over these ports, modify your settings accordingly.
System settings
- Check whether the app server and your Site24x7 account are in the same time zone. To change your account's time zone, go to Admin > My Account.
- If your APM instance is not receiving data, please perform some transactions on your server and check the Site24x7 console after a couple of minutes.
Related Articles
Troubleshooting false positive alerts in monitoring
Problem False positive alerts are being generated. Possible cause The monitoring system is down in some locations. The Website monitor might be configured for one location, such as Seattle, but may appear down when accessed from another location, ...
No data for service and process in Windows server monitor
If you see "No Data" for process and service metrics (such as CPU or memory usage of monitored services) in the Site24x7 Windows server monitor user interface, follow the troubleshooting steps below. Run PowerShell Commands Open PowerShell as ...
Compare our various methodologies for Website Monitoring
Get to know Site24x7 monitors better and choose the one that best fits your monitoring needs. Compare the functionality of the following monitors: Website Monitoring Webpage Speed (Browser) Web Transaction Monitoring Web Transaction (Browser) SSL/TLS ...
Site24x7 Real User Monitoring (RUM) - Data Collection
When you include Site24x7 RUM beacon script in your web pages, the following data is collected. All data that's being collected is in accordance with GDPR compliance. Performance details of web page load time - Metrics like response time of web page ...
How to configure the NGINX status page for monitoring NGINX performance
The NGINX plugin uses the NGINX status page to pull the performance metrics of the NGINX server. You may encounter the following errors while installing the NGINX plugin integration: Error_code : HTTP Error 404: This error usually indicates that the ...