Timeouts working with external resources (TimeoutsInExternalResources)¶

Type	Scope	Severity	Activated by default	Minutes to fix	Tags
`Error`	`BSL` `OS`	`Critical`	`Yes`	`5`	`unpredictable` `standard`

Parameters¶

Name	Type	Description	Default value
`analyzeInternetMailProfileZeroTimeout`	`Boolean`	`Analyze the timeout for "InternetMailProfile"`	`true`

Description¶

When working with external resources using the WSDefinitions, WSProxy, HTTPConnection, FTPConnection there should be a time out - the time limit for the operation to be completed. Otherwise, as a result of endless waiting, the program will freeze or some of the functionality of the program will become unavailable.
For the InternetMailProfile the platform sets the default timeout value to 30 seconds, but despite this, it is worth explicitly specifying the timeout value when using it.

Setting a timeout protects against external factors:

unstable Internet connection, when the connection is interrupted regularly, and the system cannot receive a complete response from the server to which the connection is made;
when anti-virus programs are enabled or if the firewall settings are incorrect;
incorrect proxy-server settings;
unreliable operation of the web server due to increased load or incorrect operation of scripts.

Examples¶

Incorrect:

HTTPConnection = New HTTPConnection("zabbix.localhost", 80);

or

FTPConnection = New FTPConnection(Server, Port, Login, Password, Proxy, PassiveMode);

Correct:

HTTPConnection = New HTTPConnection("zabbix.localhost", 80,,,, 1);

or

ConnectiomTimeout = 180;
HTTPConnection = New HTTPConnection("zabbix.localhost", 80,,,, ConnectiomTimeout);

Sources¶

Snippets¶

Diagnostic ignorance in code¶

// BSLLS:TimeoutsInExternalResources-off
// BSLLS:TimeoutsInExternalResources-on

Parameter for config¶

"TimeoutsInExternalResources": {
    "analyzeInternetMailProfileZeroTimeout": true
}