APM Insight Basic Troubleshooting tips - Nodejs

APM Insight Basic Troubleshooting tips - Nodejs

If you have installed the APM Insight Node.js agent and are facing issues with it, follow the instructions given below to troubleshoot your application:

1. License key and logs

  • Check whether the apminsightnode.json file contains the correct license key.
  • Check agent logs (in the apminsightdata directory where node process is started) for any warning related to network communication.  

                       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 Applications Manager 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 Applications Manager client.


  • Check apminsight.json (in the apminsightdata directory where node process is started) file for key "status"- if it is "900", please delete the apminsight.json file and restart the server.

  • The 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 has not been 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.    

2. Proxy and Firewall settings

  • If there is a proxy configuration in your server, provide the proxy details in the application start file. Check this help document for details on the same. 

3. System settings

  1. If the  APM instance is not receiving any data, please perform some transactions on your server and check the APM Insight Tab after a couple of minutes.

           

                  New to ADSelfService Plus?