Monitoring is a new feature of Exago v2017.1 that allows you to track report management, execution, and performance statistics for the web application and schedulers. Monitoring data is stored in local sqlite database files, and can be reported on using Exago.
When you install the Exago web application, the monitoring system is automatically installed, but it is disabled by default. You must configure and enable it manually. Many actions in the application can be tracked:
Monitoring for these components can be toggled on or off depending on your needs.
Additionally, you can track track CPU and memory load for each scheduler application so you can fine-tune your load balancing setup.
To set up monitoring, you need to configure the monitoring application, set your options for which data to collect, and then set the monitoring service to run automatically.
The monitoring system is located in a folder MonitoringService
, in the same folder as where the web application is installed. The web application stores its monitoring data in a Monitoring
subfolder of the installation. So you should have the following folders:
Windows: Ensure that the IIS user has Full Control permissions for the ExagoWeb\Monitoring
and MonitoringService
folders. See Configuring IIS for instructions.
To configure monitoring:
ExagoWeb.Monitoring
, open the file Monitoring.exe.config
in a text or xml editor. For each of the following keys in the <appSettings>
element, set the values as follows:
exagoAppPath, value="path"
where path
is the file path to the web app"C:\file\path\"
(Windows), "/file/path/"
(Linux)userConfig, value="config"
where config
is the application config file"filename.xml"
Use extension .xml
for either the encrypted or unencrypted versionwebAppUri, value="uri"
where uri
is the url virtual path to the web app"http://local/path/"
A trailing backslash (/) is requiredExtractionIntervalMinutes, value="i"
where i
is the number of minutes between updates to the core database. The default is 3.StatisticsIntervalMinutes, value="j"
where j
is the number of minutes between when each scheduler is polled for performance statistics. The default is 1.<appSettings>
<add key="ExtractionIntervalMinutes" value="3" />
<add key="StatisticsIntervalMinutes" value="1" />
<add key="exagoAppPath" value="C:\ExagoWeb\" />
<add key="userConfig" value="WebReports.xml" />
<add key="webAppUri" value="http://localhost/monitoring/" />
</appSettings>
ExagoWeb
, open the file appSettings.config
in a text or xml editor. In the <appSettings>
element, set the Monitoring.DbPath
key to the folder where your web application's monitoring data file is. The default location is ExagoWeb\Monitoring
.
<appSettings>
<add key="Monitoring.DbPath" value="C:\Exago\ExagoWeb\Monitoring\" />
...
</appSettings>
Note. Keys are formatted as "Monitoring.Option"
; The "Monitoring."
prefix is omitted below.
<appSettings>
...
<add key="Monitoring.CollectDeleteReportUsage" value="true" />
<add key="Monitoring.CollectRenameReportUsage" value="false" />
<add key="Monitoring.CollectDuplicateReportUsage" value="true" />
<add key="Monitoring.CollectExecuteReportUsage" value="true" />
...
</appSettings>
If you want to track scheduled report execution, do the following for each scheduler application:
Open the eWebReportsScheduler.exe.config file in a text or xml editor. Add the following key to the <appSettings>
element:
<add key="Monitoring.CollectExecuteReportUsage" value="true" />
The monitoring system uses a Windows or Linux service that updates the core database with data from the web application and schedulers at specified intervals. This way you have the data from every component in a single location.
The service is installed automatically, but it is not enabled by default.
To enable the service:
services.msc
.Exago Monitoring Service vX.X.X.X
, where vX.X.X.X
is your Exago version. Right-click the service and select Properties.Before using monitoring data in reports, you need to add the core database file MonitoringService/Monitoring.sqlite
as an Exago data source. See Using SQLite Data Sources for instructions.