Configuring Mobile App Monitor
The Mobile App Monitor includes a simpler and smoother onboarding process by allowing users to skip the manual installation of the DEM Collector by offering users a script that downloads the latest compatible DEM Collector for the Applications Manager version, install the agent, starts it and maps it to the tool.
Browse through the following topics to learn more about configuring Mobile App Monitor:
Note: The DEM Collector communicates with Applications Manager once every minute. Data is collected only when the monitored app is accessed by clients.
Creating a new Mobile App Monitor
To create a new Mobile App Monitor, navigate to Add New Monitor → Web Server/Services → Mobile App Monitor, and enter the following details:
- Basic Details:
- Choose a name for the monitor of the app to be monitored.
- Specify Apdex Threshold (in ms) i.e. the Response Time threshold used to calculate the Apdex score and determine user experience.
- Click on Next.
- Collector Configuration
- Associate monitor instance with DEM Collector of your choice.
Note: For each DEM Collector, we can add only up to 5 apps (5 monitors)
- To deploy the DEM Collector click on the Want to deploy agent? option.
- Choose between Windows and Linux as the OS in which you wish to deploy the agent.
Download the script file to be executed on the server where you want to install the DEM Collector. The script will automatically start the DEM Collector. If necessary, users can also choose to change the installation path before downloading it.
- For Windows:
Open Powershell and run the following sample command:installdem.ps1
- For Linux:
Open command terminal and run the following sample command:sh installdem.sh
If you encounter any issues, please refer to this page.
- Click on Next to successfully complete monitor addition and move to the SDK Installation details.
- SDK Installation:
- Select Application: Select the application type - Android or iOS.
- Follow the steps mentioned in the following links to install SDK in respective mobile applications:
- Click on Complete.
- On successfully completeing the SDK Installation, the page will be automatically redirected to the monitor details page.
Additional Configuration Options
Once a Mobile App Monitor is added, you can fine-tune its behavior from the Edit Monitor page. These options are not available during monitor creation but can be configured later if needed:
- HTTP Calls to Exclude: Specify the http calls (eg : https://zoho.com/api/test) to skip from tracking.
- Screens to Exclude: Specify the screen names (eg : testScreen) to skip from tracking.
These configurations help you tailor Mobile App Monitoring to your specific requirements and refine data collection.
Starting the DEM Collector
Windows
- Open command terminal from the newly-installed <DEMCollector_Home> directory. (Eg:C:\Program File\ManageEngine\DEMCollector)
- Execute the StartServer.bat command in the terminal to start the DEM Collector.
- Upon executing the command, the DEM Collector will start and a new window will be opened in the browser displaying all DEM Collector related information such as it's agent version, hostname, port, and the connectivity status of the agent with the Applications Manager console.
- You can stop the agent by executing the StopServer.bat -force command from command prompt.
Note:
- Above steps are for non-service installations alone. In the case of Service installations, you can start the DEM Collector directly by starting the ManageEngine DEM Collector Agent service from Windows services.
- In case you want to change Application Manager's instance details in DEM Collector after installation, refer here.
Linux
- Open command terminal from the newly-installed <DEMCollector_Home> directory. (Eg:\home\test\ManageEngine\DEMCollector)
- Execute the sh StartServer.sh command in the terminal to start the DEM Collector.
- Upon executing the command, the DEM Collector will be started and a new window will be opened in the browser displaying DEM Collector information such as agent version, hostname, port, and the connectivity status of the agent with the Applications Manager console.
- You can stop the agent by executing the sh StopServer.sh -force command from command terminal.
Note:
For installing DEM Collector as a Linux service, you need to have root privileges in that system. Following steps are applicable only for DEM Collector version 4.4 and above:
- Go to <DEMCollector_Home>/bin directory, execute the installService.sh file. On executing this file, ManageEngine DEM Collector Agent service will be added in Linux Services and the startup type will be set as Automatic, by default.
- Now, when you start a Linux system, DEM Collector will start automatically. You can swap between Automatic and Manual modes.
- To change Application Manager's instance details in the DEM Collector after installation, refer here.
- To uninstall this service, go to <DEMCollector_Home>/bin directory and execute the uninstallService.sh file.
Uninstalling the DEM Collector
Note: Before uninstalling the agent, exit the command prompt and close all the files and folders opened in the <DEM Collector Home> directory. If the DEM Collector is running, stop the agent before uninstalling it to remove all related files completely.
Windows
- If the DEM Collector is running, you should stop the agent before uninstalling it. You can stop the agent by executing the StopServer.bat -force command from command prompt.
- Open Control Panel → Uninstall Program → right click on Applications Manager - DEM Collector → Click Uninstall. Then follow the instructions shown on screen to uninstall the agent.
Linux
- If the DEM Collector is running, you should stop the agent before uninstalling it. You can stop the agent by executing the sh StopServer.sh -force command from command terminal.
- Open terminal from <DEMCollector_Home>/_Applications Manager - DEM Collector_installation directory and execute "./Change\ Applications\ Manager\ -\ DEM\ Collector\ Installation" and follow the process.
