Search

 

Version: 21.01+

Applicable to: Futurama Website/Futurama Webservice

 

Description

In case Futurama is running in Website mode or in Webservice mode it is possible to use settings in the configuration file to generate performance warnings for page loading and load balancing. These settings are set in the performancelog-section of the configuration file. Page loading time is the time for processing the web request and rendering the page in HTML on the server. Load balancing time in Futurama is the time it takes to assign a host to handle a web request from the client. 

Configuration

Settings

Within the configuration element the next code has to be included:

<configSections>
	<sectionGroup name="futuramaSettings">
		<section type="ActuIT.Futurama.Library.PerformanceLogSection, ActuIT.Futurama.Library, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null" name="performancelog"></section>
	</sectionGroup>
</configSections>

Next to this code, also within the configuration element the next code has to be included:

<futuramaSettings>
	<performancelog enabled="{true/false}" pageLoadTimeWarning="{integer}" loadBalanceTimeWarning="{integer}"></performancelog>
</futuramaSettings>

Explanation

Within the performancelog element some attributes can be set. Below the possible values of these attributes.

enabled

Indicates Futurama should use the log settings

  • this attribute is required and can have the value true or false;
  • this attribute is only used in Website and Webservice mode;
  • enabled='true' means that performance warnings should be generated in the logs, enabled='false' means that performance warnings should be disabled;
pageLoadTimeWarning

The time in milliseconds it takes to load a page before a warning is generated after completion. If the page loading time exceeds this value a warning is logged. If the page loading time is shorter no warning is logged. Notes:

  • this attribute is optional;
  • if this attribute is included and enabled="true" and if the page loading takes longer than the specified number of milliseconds, a warning with the actual amount of waiting time for the page loading will be generated in the logs;
  • if this attribute is not included, page loading will not generate a warning;
  • this attribute is only used in Website mode;

Example: Suppose enabled="true" and pageLoadTimeWarning="400". If page loading takes 300 milliseconds, no warning is generated. If page loading takes 450 milliseconds, a warning is generated mentioning 450 milliseconds, because page loading takes more than 400 milliseconds. If enabled="false" (regardless of pageLoadTimeWarning) or pageLoadTimeWarning is ommitted, no warnings will be logged at all.

loadBalanceTimeWarning

The time in milliseconds it takes to assign a host to handle a webrequest before a warning is generated after completion. If the time to assign to an available host exceeds this value a warning is logged. If the time is shorter no warning is logged. Notes:

  • this attribute is optional;
  • if this attribute is included and enabled="true" and if the load balancing takes longer than the specified number of milliseconds, a warning with the actual amount of waiting time for the load balancing will be generated in the logs;
  • if this attribute is not included, load balancing will not generate a warning;
  • this attribute is only used in Website and Webservice mode;

Example: Suppose enabled="true" and loadbalanceTimeWarning="400". If load balancing takes 300 milliseconds, no warning is generated. If load balancing takes 450 milliseconds, a warning is generated mentioning 450 milliseconds, because load balancing takes more than 400 milliseconds. If enabled="false" (regardless of loadBalanceTimeWarning) or loadBalanceTimeWarning is ommitted, no warnings will be logged at all.

Feedback

If you have any questions about this subject or if you want to provide us feedback please send us an e-mail.

Updated: 2021-01-25