APM Insight Node.js agent - Basic Troubleshooting tips

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 ...