Real User Monitoring Agent - Frequently asked questions

Real User Monitoring Agent - Frequently asked questions

How to change Applications Manager details in RUM Agent?

  1. Open the AppServer.properties file located under <RUMAgent_Home>/conf/ directory in any text editor.
  2. Update Applications Manager hostname in apm.host key.
  3. Update Applications Manager SSL Port in apm.https.port key.
  4. Remove the key apm.apikey.encrypted (if present).
  5. Add the apm.apikey (if not present). Update RUM API Key in apm.apikey key.
  6. Save the changes and restart RUM Agent.

How to setup Proxy in RUM Agent to communicate with Applications Manager?

  1. Open the AppServer.properties file located under <RUMAgent_Home>/conf/ directory in any text editor.
  2. Search for proxy.required key.
    1. If the key is not present uncomment following keys proxy.host, proxy.port, proxy.ishttps, proxy.authscheme, proxy.username and proxy.password by removing "#" present before the keys.
    2. If the key is present set proxy.required key value as true.
  3. Update proxy host name in proxy.host key.
  4. Update proxy port number in proxy.port key,
  5. Update  proxy.ishttps key based on the proxy protocol. Set the value as true for HTTPS protocol.
  6. Update proxy authscheme in proxy.authscheme key.
  7. Update proxy user name in proxy.username key.
  8. Remove the key proxy.password.encrypted (if present).
  9. Add the proxy.password (if not present). Update proxy password in proxy.password key.
  10. Save the changes and restart RUM Agent.
Example : 
####proxy properties to connect to AppManager                                                                                                                                                       
proxy.host=127.0.01
proxy.port=8081
proxy.ishttps=true
proxy.authscheme=basic
proxy.username=admin
proxy.password=admin
If proxy is not required
  1. Search for proxy.required key.
    1. If the key is not present, comment following keys proxy.host, proxy.port, proxy.ishttps, proxy.authscheme, proxy.username and proxy.password by adding "#" before the keys.
    2. If the key is present, set proxy.required key value as false.

How to change RUM Agent HTTP port?

  1. Open the awsadapterconf.properties file located under <RUMAgent_Home>/conf/ directory in any text editor.
  2. Update the port in webserver.port key.
  3. Save the changes and restart RUM Agent.

How to change RUM Agent HTTPs port?

  1. Open the sslservers.properties file located under <RUMAgent_Home>/conf/ directory in any text editor.
  2. Replace the existing port with new port number.
  3. Save the changes and restart RUM Agent.

How to change from HTTP to HTTPS or HTTPS to HTTP protocol in RUM Agent?

  1. To change Agent protocol from HTTP to HTTPS refer this KB.
  2. To change Agent protocol from HTTPS to HTTP follow the below steps.
    1. Open the AppServer.properties file located under <RUMAgent_Home>/conf/ directory in any text editor.
    2. Set apm.rum.isHttps key value as false.
    3. Save the changes and restart RUM Agent.

How to use default RUM Agent Geolocation API?

  1. To make use of any other third party Geolocation API refer this KB.
  2. To use default RUM Agent Geolocation API follow the below steps
    1. Open the AppServer.properties file located under <RUMAgent_Home>/conf/ directory in any text editor.
    2. Set geo.api.type key value as 0.
    3. Save the changes and restart RUM Agent.
Default RUM Agent Geolocation API will not provide ISP data of end user. To get ISP data make use of any third party Geolocation API.

How to enable debugging in RUM Agent?

  1. Open the AppServer.properties file located under <RUMAgent_Home>/conf/ directory in any text editor.
  2. Search for "apm.rum.debug" key.
  3. Update "apm.rum.debug" key value as true.
  4. Save the changes and restart RUM Agent.

How to check the RUM Agent version?

You can check the version of RUM agent directly from the RUM agent home page (shown after starting the agent) or by finding out the value displayed for the key apm.rum.version in the AppServer.properties file located under <RUMAgent_Home>/conf directory.




        New to ADManager Plus?

          New to ADSelfService Plus?

            • Related Articles

            • 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 prerequisites to be done Real User Monitor requires the RUM Agent to be installed and mapped to the Applications Manager. Refer the help ...
            • Self monitor Applications Manager using Real User Monitoring

              We can monitor the Applications Manager using Real User Monitoring with a Java Script injection and this can be used to measure the Applications Manager's performance continuously. All you need is to install and setup the Real User Monitoring (RUM) ...
            • How to get ISP data in Real User Monitor?

              The default setting of the Real User Monitor does not display ISP data for the end user. To obtain ISP data, you have the option to use a third-party Geolocation API. Currently, RUM exclusively supports APIs that provide responses in JSON format. ...
            • How to enable HTTPS connection between end user and RUM Agent?

              By default end user data will be collected and sent via HTTP connection to RUM Agent. To enable HTTPS connection you should have an valid SSL Certificate (keystore file basically), not a self signed certificate. Open the AppServer.properties file ...
            • How to upgrade Real User Monitoring Agent?

              Currently, we don't have an update manager for the RUM Agent. Therefore, you need to uninstall the old agent and install the new RUM Agent. Steps to upgrade RUM Agent Take a backup of <RUMAgent_Home>/conf/ folder and place it outside of the RUM_Agent ...