Monitoring Agent
The monitoring agent is installed on workstations (PCs, terminal servers, VDI, etc.) running Windows or Linux operating systems. The main tasks of the monitoring agent are:
- Collecting data on user interaction with the device
- Transmitting collected data to the Operavix server
To download the monitoring agent distribution:
- Click the gear icon in the lower left corner and open the Download monitoring agent section.
- Specify the required agent parameters:
- API Key — for agent authentication on the server. By default, the Monitoring agent key is available; additional keys can be created if needed
- Server address — URL for agent-to-server connection. Filled in automatically, but can be edited to use the full FQDN specified in the application server’s SSL certificate
- Proxy server (On/Off) — if a non-standard proxy configuration is required
- Client — select the distribution format:
- Windows (exe) — executable file
- Windows (msi) — archive with an msi package and an mst file for GPO-based deployment
- Auto-update (On/Off) — automatic download and installation of agent updates
- Click Download client to download the distribution file.
Monitoring agents send data to the Operavix application via the web server. When web server parameters are changed, you must update the settings of previously installed agents or reinstall them.
If the web server address has changed, you can update it in an already installed monitoring agent.
On Windows, this can be done in two ways:
- Use the agent_configurator.exe utility, which is installed with the agent. The file is located at
C:\Program Files\OperavixAgent\agent_configurator.exe. - Manually edit the settings.cfg configuration file located at
C:\ProgramData\OperavixAgent\settings.cfg. After saving changes, reboot the computer or restart the application service.
On Linux, to update the web server address, edit the agent configuration file located at /var/lib/OperavixAgent/settings.cfg. In this file, specify the correct host and API key for agent-to-server communication. Example file contents:
{
"autoupdate_enabled": true,
"web_server": {
"host": "http://example.server.com:PORT/"
},
"server_proxy": {
"value": "",
"user_name": "",
"user_password": ""
},
"auth": {
"value": "your_api_key",
"type": "none"
}
}
A detailed description of the data collected by the monitoring agent is provided in the Monitoring section.
Installing the Monitoring Agent on Windows
To install the monitoring agent on Windows, perform the following steps:
- Download the executable file agent_setup.exe from the Download monitoring agent settings section.
- Run the downloaded file on the computer where you want to install the monitoring agent. During installation, the configuration fields are automatically populated with the values specified during download.
- Click Next to begin installation.
- After installation completes, click OK.
If the application server is unavailable from the computer where the agent is being installed, the process will fail with an error.
Installing the Monitoring Agent on Linux
Event capture specifics for the agent on Linux OS are described in the Known Issues and Limitations section.
Ensure the agent installer file is not located in the user’s home directory. For example, create a folder /opt/repo, place the installer file there, and run it from that directory.
Install the monitoring agent using one of the following commands:
- For apt-based distributions:
# apt install /opt/repo/agent.deb - Or:
# apt-get install /opt/repo/agent.rpm - For rpm-based distributions:
# rpm --nosignature --nodigest -iv path to file (example: rpm --nosignature --nodigest -iv /tmp/agent_setup.rpm)
Was the article helpful?