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) and update RUM API Key as its value.
  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 the 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 server host name in proxy.host key.
  4. Update proxy server 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 key proxy.password (if not present). and update proxy password as its value.
  10. Save the changes and restart RUM Agent.
Example : 
Info
####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
Notes
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.
InfoDefault 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 Enable/Disable Public Access for the RUM Agent Web Console?

Info
Supported from RUM Agent version 4.1 and above
  1. Open the AppServer.properties file located under <RUMAgent_Home>/conf/ directory in any text editor.
  2. Search for apm.rum.secure.webconsole.access key.
  3. To Enable Public Access: Set the key value to false.
  4. To Disable Public Access: Set the key value to true.
  5. 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 (Supported from RUM Agent version 3.5 and above) or by finding out the value displayed for the key apm.rum.version in the AppServer.properties file located under <RUMAgent_Home>/conf directory.