The following parameters control the behavior of the PerformanceGuard web interface. They can be set either in the config_params database table or in the file performanceguard.xml (the default location of the file is \[PerformanceGuard installation folder\]\display\conf)
This parameter controls the PerformanceGuard Web Server service.
| Port | |
|---|
| Set in | performanceguard.xml |
| Type | Number |
| Default value | 80 |
| Description | TCP/IP listener port for the PerformanceGuard Web Server service. Default is HTTP port 80. |
| In performanceguard.xml | text<br/><Parameter name="port" override="false" value="80"/><br/> |
These parameters control the maximum number of rows to show on a page. If the actual number of rows exceeds the parameter value, navigation links are added to the page.
| Protocol.Page.Size | |
|---|
| Set in | config_params database table |
| Type | Number |
| Default value | 500 |
| Description | Maximum number of ports to concurrently show on the port management page. |
| Server.Page.Size | |
|---|
| Set in | config_params database table |
| Type | Number |
| Default value | 500 |
| Description | Maximum number of servers to concurrently show on the server management page. |
| Report.Page.Size | |
|---|
| Set in | config_params database table |
| Type | Number |
| Default value | 50 |
| Description | Maximum number of reports to concurrently show on the report management page. |
These parameters control image format and refreshing intervals for generated graphs.
| Refresh.interval | |
|---|
| Set in | config_params database table |
| Type | Seconds |
| Default value | 120 |
| Description | Time (sec) between automatic refreshing of the Time View, Server/Port and Server/Agent graphs. A value of 0 disables automatic refreshing. |
| image.format | |
|---|
| Set in | config_params database table |
| Type | String. “image/jpeg” or “image/png” |
| Default value | ”image/jpeg” |
| Description | Graph image format. PNG is smaller in size, but takes approximately 1-2 seconds longer to generate. JPEG is about three times the size of a PNG, and the quality of the image isn’t as good as PNG |
| moving.average | |
|---|
| Set in | config_params database table |
| Type | Number |
| Default value | 10 |
| Description | The number of samples to use when calculating moving averages in graphs. The value must be larger than 1. |
These parameters control which status color agents will have on the agent search and agent management pages.
| ClientInactivityMinutesYellow | |
|---|
| Set in | config_params database table |
| Type | Minutes |
| Default value | 30 |
| Description | Minutes of inactivity before an agent’s status color changes from green to yellow. |
| ClientInactivityMinutesred | |
|---|
| Set in | config_params database table |
| Type | Minutes |
| Default value | 1440 (that is 24 hours) |
| Description | Minutes of inactivity before an agent’s status color changes from yellow to red. |
These parameters control database connection.
| jdbc.prefetch.size | |
|---|
| Set in | performanceguard.xml |
| Type | Integer |
| Default value | 20 |
| Description | JDBC row prefetch size, applies to all prepared statements |
| In performanceguard.xml | text<br/><Parameter name="jdbc.prefetch.size" override="false" value="20"/><br/> |
| sql.folder | |
|---|
| Set in | performanceguard.xml |
| Type | Folder name |
| Default value | local/ |
| Description | The SQL statements used in the application are defined in various files in this folder.
⚠️ This value should only be changed by a CapaSystems consultant |
| JdbcDriver | |
|---|
| Set in | performanceguard.xml |
| Type | JDBC driver class |
| Default value | com.microsoft.sqlserver.jdbc.SQLServerDriver |
| Description | JDBC driver for access to the PerformanceGuard database |
| In performanceguard.xml | ⚠️ Parameter name=“JdbcDriver” override=“false” value=“com.microsoft.sqlserver.jdbc.SQLServerDriver”/> |
| JdbcConnectString | |
|---|
| Set in | performanceguard.xml |
| Type | String |
| Default value | jdbc:sqlserver://localhost |
| Description | Database connection string. |
| In performanceguard.xml | text<br/>Parameter name="JdbcConnectString" override="false" value="jdbc:sqlserver://localhost"/><br/> |
| User | |
|---|
| Set in | performanceguard.xml |
| Type | String |
| Default value | pguard |
| Description | PerformanceGuard backend server database user name. |
| In performanceguard.xml | text<br/><Parameter name="User" override="false" value="pguard"/><br/> |
| Password | |
|---|
| Set in | performanceguard.xml |
| Type | String |
| Default value | pguard |
| Description | PerformanceGuard backend server database password. |
| In performanceguard.xml | text<br/><Parameter name="Password" override="false" value="[encrypted password]"/> <br/>]]><br/> ⚠️ The password is stored in encrypted form in performanceguard.xml. |
| Connection.pool.size | |
|---|
| Set in | performanceguard.xml |
| Type | Number of connections |
| Default value | 15 |
| Description | The number of simultaneous connections to the PerformanceGuard database. If an SQL error occurs on one of the connections in the pool, the application tries to re-establish the connection. |
| In performanceguard.xml | ⚠️ <Parameter name=“Connection.pool.size” override=“false” value=“15”/> |
| demo.mode | |
|---|
| Set in | config_params database table |
| Type | Integer |
| Default value | 0 |
| Description | Set demo.mode to 1 to activate demo mode. When demo mode is activated, the internal clock in the PerformanceGuard web interface will be stopped and reset to the time stamp of the last delivered sample. When in demo mode PerformanceGuard won’t accept incoming data from agents, and it won’t delete old data (the cleanup job is stopped). |
Access logging, that is logging of who accesses the PerformanceGuard system, is by default not enabled. When access logging has been enabled, you can view the access log in the folder [PerformanceGuard installation folder]\display\accesslogs.
| accessLogEnabled | |
|---|
| Set in | performanceguard.xml |
| Type | True/false |
| Default value | False |
| Description | Determines whether access logging is enabled or not. |
| In performanceguard.xml | ⚠️ <Parameter name=“accessLogEnabled” override=“false” value=“False”/> |
| accessLogRetainDays | |
|---|
| Set in | performanceguard.xml |
| Type | Number of days |
| Default value | 7 |
| Description | Determines how the log access log is kept for if access logging is enabled.
⚠️ The value 0 (zero) will keep the log forever. We don’t recommend that you keep the log forever because it will take up more and more disk space. |
| In performanceguard.xml | text<br/><Parameter name="accessLogRetainDays" override="false" value="7"/><br/> |
