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?

                    • Related Articles

                    • Uninstrumented Block of Code - APM Insight

                      In the traces tab --> Slowest Method Calls and Count we show if you find Un-instrumented block of code the reason is as follows: Basically, What is un-instrumented block of code in APM Insight? By default, APM Insight agent monitors known frameworks ...
                    • APM Insight Troubleshooting - FAQs

                      Monitor Addition - FAQs 1. How to add an APM Insight Monitor? After you deploy the APM Insight agent in your Application Server with suitable Applications Manager credentials in the apminsight.conf file, APM Insight monitors will automatically be ...
                    • Self monitor Applications Manager using APM Insight Java Agent

                      Applications Manager is built with Java, hence we can monitor it using APM Insight Java Agent to measure it's performance continuously, which can be very much useful. Setting up APM Insight Java Agent Follow the below steps to download and set up the ...
                    • How to rename an existing APM - Java agent application's monitor?

                      In Applications Manager's APM(Application Performance Monitoring) doesn't support renaming applications/monitors from the web client. However, the application name of an existing application instance can be renamed in the `apminsight.conf` file and ...
                    • Real User Monitor (RUM) - Troubleshooting

                      If the monitor has not polled data for a long time, follow the steps below for troubleshooting: Step 1: Check the RUM Agent configuration Real User Monitor requires the RUM Agent to be installed and mapped to the Applications Manager. Refer the help ...