Troubleshooting a Remote Data Collector/Processor
This article provides some tips for troubleshooting problems with your Remote Data Collector
[Release 6.x]: 'Remote Data Collector' renamed to 'Remote Data Processor'
The Remote Collectors screen lists all your Remote Data Collectors and provides a visual queue whether the Remote Data Collector is active. It also lists the last time the collector successfully communicated with the system.
- If your Remote Data Collector is not active then it will show with pink background, and the column for "Last Heartbeat Time" will have a value with the last time it successfully connected. The image below is for a Remote Data Collector that is not active - the Last Heartbeat Time is old and the background is pink. You will need to troubleshoot more
- If your Remote Data Collector is active then it will show with white background, and the column for "Last Heartbeat Time" will have a value within a couple minutes of the current system time.
On the machine that the Remote Data Collector is running, stop and restart the Remote Data Collector
Find the Services menu on the Windows machine and stop and restart the Remote Data Collector. The service is named 'Metric Insights Daemon'
In Version 5.2.0+, you can download log files using the [Get Logs] button from the Remote Data Collector Editor page. The downloaded zip includes the primary insight.log and plugin specific logs like qlik.log and powerbi.log.
For prior versions, open the collapsed sections below for steps on now to view error messages on the Remote Data Collector host machine.
Find the Event Viewer menu on the Windows machine and choose the events for the service named 'Metric Insights Daemon'. Errors are flagged in red and provide information on problems that the Remote Data Collector encountered.
View the errors in the log.
View the errors in the log.
Use https://000.000.00.00:8443/heartbeat and replace the zeros with the server IP address
In case you've encountered HTTP Error 500 (Internal Server Error): <your IP address> is currently unable to handle this request.
1. Connect to the server where MI is installed by ssh:
- Use ssh [email protected] and replace the zeros with the server IP address
- When prompted, enter the root password provided by your IT specialist
2. Open the file with settings of the Data Collection Service:
3. Find the DEBUG setting (see the image below). If 'DEBUG = False', open the file in editor and change it to 'DEBUG = True' and save changes made.
If running on Version 5.0 or above, you can download the Configuration file - Download config file - from the Remote Data Collector Editor. On older versions, open the collapsed articles below to see steps for viewing the Config file on the machine that the Remote Data Collector is running.
Note the setting values for:
- Username for remote agent
- Password for remote agent"
- Domain name of your Metric Insights instance as seen in the web browser URL
These values will be compared to your config file settings.
C:\Program Files (x86)\Metric Insights\Insightd\conf
Verify that the following fields contain the same values recorded in Step 6.1 from the Remote Editor online
- Hostname = Username for remote agent
- Password = Password for remote agent
- requestURL = Domain name of your MI instance
Find the directory where the Remote Data Collector is running and view the configuration file "config.ini". See instructions for where you installed the program.
8. If Windows service could never start up (and exits immediately) then memory size parameter for Metric Insights program might be too large.
Using editor (such as Notepad editor) for file
C:\Program Files (x86)\Metric Insights\Insightd\bin\insightd.cmd
Verify and change program argument -Xmx (e.g., -Xmx2048m or whatever large size it has) to smaller size such as 1GB (e.g., -Xmx1024m)
Using editor (such as Notepad editor) for file:
C:\Program Files (x86)\Metric Insights\Insightd\bin\insightd-service.xml
Verify and change program argument -Xmx (e.g, -Xmx8g or whatever large size it has) to smaller size such as 1GB (e.g., -Xmx1g)