Real User Monitoring Agent - Frequently asked questions
How to change Applications Manager details in RUM Agent?
- Open the AppServer.properties file located under <RUMAgent_Home>/conf/ directory in any text editor.
- Update Applications Manager hostname in apm.host key.
- Update Applications Manager SSL Port in apm.https.port key.
- Remove the key apm.apikey.encrypted (if present).
- Add the apm.apikey (if not present). Update RUM API Key in apm.apikey key.
- Save the changes and restart RUM Agent.
How to setup Proxy in RUM Agent to communicate with Applications Manager?
- Open the AppServer.properties file located under <RUMAgent_Home>/conf/ directory in any text editor.
- Search for proxy.required key.
- 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.
- If the key is present set proxy.required key value as true.
- Update proxy host name in proxy.host key.
- Update proxy port number in proxy.port key,
- Update proxy.ishttps key based on the proxy protocol. Set the value as true for HTTPS protocol.
- Update proxy authscheme in proxy.authscheme key.
- Update proxy user name in proxy.username key.
- Remove the key proxy.password.encrypted (if present).
- Add the proxy.password (if not present). Update proxy password in proxy.password key.
- 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
- Search for proxy.required key.
- 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.
- If the key is present, set proxy.required key value as false.
How to change RUM Agent HTTP port?
- Open the awsadapterconf.properties file located under <RUMAgent_Home>/conf/ directory in any text editor.
- Update the port in webserver.port key.
- Save the changes and restart RUM Agent.
How to change RUM Agent HTTPs port?
- Open the sslservers.properties file located under <RUMAgent_Home>/conf/ directory in any text editor.
- Replace the existing port with new port number.
- Save the changes and restart RUM Agent.
How to change from HTTP to HTTPS or HTTPS to HTTP protocol in RUM Agent?
- To change Agent protocol from HTTP to HTTPS refer this KB.
- To change Agent protocol from HTTPS to HTTP follow the below steps.
- Open the AppServer.properties file located under <RUMAgent_Home>/conf/ directory in any text editor.
- Set apm.rum.isHttps key value as false.
- Save the changes and restart RUM Agent.
How to use default RUM Agent Geolocation API?
- To make use of any other third party Geolocation API refer this KB.
- To use default RUM Agent Geolocation API follow the below steps
- Open the AppServer.properties file located under <RUMAgent_Home>/conf/ directory in any text editor.
- Set geo.api.type key value as 0.
- 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?
- Open the AppServer.properties file located under <RUMAgent_Home>/conf/ directory in any text editor.
- Search for "apm.rum.debug" key.
- Update "apm.rum.debug" key value as true.
- Save the changes and restart RUM Agent.
How to Enable/Disable Public Access for the RUM Agent Web Console?
Supported from RUM Agent version 4.1 and above
- Open the AppServer.properties file located under <RUMAgent_Home>/conf/ directory in any text editor.
- Search for "apm.rum.secure.webconsole.access" key.
- To Enable Public Access: Set the key value to false.
- To Disable Public Access: Set the key value to true.
- 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 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 the RUM Agent configuration 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 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. For RUM Agent version below 4.0, Open ...How to get ISP and Region data in Real User Monitor?
The default setting of the Real User Monitor does not display ISP and region data for the end user. To obtain the data, you have the option to use a third-party Geolocation API. Currently, RUM exclusively supports APIs that provide responses in JSON ...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 ...