Reference: Server Checks

This section contains a reference of all Server (and System-independent) Checks provided by Avantra.

AGENTALIVE

Verifies Avantra Agent alive status and detects cluster switches.

Description

One of the most important Avantra checks. It is different from almost all other checks since it is not executed by the Avantra Agent, but by the Avantra Master.

AGENTALIVE on the one hand is used to self monitor Avantra Agent and is generated by Avantra Master if there is no message from Avantra Agent during a certain period of time.

On the other hand it is used to detect cluster switches.

For a Physical Server, the AGENTALIVE check can only have two status: Ok or Critical. If the AGENTALIVE turns to Critical all other dependent checks will turn to Unknown. A Critical AGENTALIVE check result can have several reasons:

For Virtual Cluster Servers, the AGENTALIVE can also return a Warning state: * The check will be in Ok status if the Virtual Cluster Server is active on one of the configured physical nodes. * The check will be in Warning status if the Virtual Cluster Server has switched from one physical node to the other. The period of time how long the check result remains in Warning state can be configured using the ClusterSwitchMsgDisplayDuration Monitoring Parameter. * The check will be in Critical if the Virtual Cluster Server is not detected on any of the physical nodes, and in any of the reasons given for Physical Servers.

Reference Data
Managed Object

Physical Server, Virtual Cluster Server

Check Cycle

n/a, Check is executed by Avantra Master

Depends on

n/a, the Check is executed independent of any other Check

Monitoring Parameters

AliveTimeout and ClusterSwitchMsgDisplayDuration

AgentConnect

Monitors the connection from Avantra Master to Avantra Agent.

Description

This Avantra check is executed on the Avantra Master. It monitors whether a Avantra Agent can be reached from the Avantra Master. To decide, if a connection was successful or not the Agent Configuration distribution is analyzed. Is there no connection to an agent for more than AgentConnectTimeWarn minutes (default: 10 minutes) the check’s status changes to Warning. If the connection cannot be established for more than AgentConnectTimeCrit minutes (default: 60 minutes) the check turns to Critical.

If the AgentConnect Check is in status Warning or Critical no configuration could be sent to the Avantra Agent from the Avantra Master. When the Check changes to status Ok again the configuration of the Avantra Agent works again.

Virtual Cluster Server do not possess an AgentConnect check.

Reference Data
Managed Object

Physical Server

Check Cycle

n/a, Check is executed by Avantra Master

Depends on

n/a, the Check is executed independent of any other Check

Monitoring Parameters

AgentConnectRoute, AgentConnectTimeCrit, AgentConnectTimeWarn, and AgentProtocolUseSSL

CPULOAD

Verify CPU usage of Physical Servers

Description

The average usage of all detected CPUs is computed over a period of time.

This Check is also available for Virtual Cluster Servers, but by default it is disabled.

FILESYSTEMS

Verify the usage of local (or remote) filesystems

Description

Every filesystem is checked for its usage (and inode usage on Unix-like operating systems), and a forecast is computed when the filesystem limit will be exceeded if current usage rates continue. Thresholds may be defined on a per file system level for both, the usage and the forecast.

By default, only local file systems are considered. Use Monitoring Parameter FSMonitorNetwork to enable monitoring of remote file systems.

On Unix, the file system of the following types are monitored (locally), configured by Monitoring Parameter FSTypeLocal:

advfs, aix, ext2, ext3, ext4, gpfs, hfs, jfs, jfs2, minix, ntfs, ocfs2, reiser4, reiserfs, ufs, vxfs, xfs, xiafs, zfs

On Unix, the filesystems of the following types are monitored if FSMonitorNetwork is activated:

afs, dfs, nfs/nfs2/nfsv2, nfs3/nfsv3, smbfs

MEMORY

Verify physical memory usage of Physical Servers.

Description

MEMORY check verifies physical memory usage of the operating system against configurable thresholds MemoryUsageWarn and MemoryUsageCrit.

If the percentage of memory used is above MemoryUsageWarn the check status will be Critical. If the percentage of memory used is above MemoryUsageWarn but still below MemoryUsageCrit, the check result status will be Warning.

In case monitoring parameter thresholds are configured as remaining free space using KB/MB or GB, the amount of free memory is checked if it is below the corresponding threshold.

MEMORY check is accompanied by check PAGINGSPACE which includes virtual memory i.e. swap space as well. If MEMORY returns a Warning or Critical result, but PAGINGSPACE is still Ok, you will probably notice that the system will perform slower, but should still work correctly. If, however, PAGINGSPACE will result as Warning or even Critical too, the server is definitely in a more serious condition and you may face out-of-memory errors.

PAGINGSPACE

Verify paging space usage of Physical Servers.

Description

Every detected paging space (or swap space) is checked for usage. Thresholds may be defined for the total paging space usage. Depending on the operating system, paging spaces may be devices, file (systems), or in memory. For operating systems using an early paging strategy, paging space being reserved is considered as in use.

There is also an option to check the ratio of paging space to physical memory by defining a value for PagingSpacePhysMemRatioWarn

On Microsoft Windows operating systems: This check reports the paging space usage as reported from windows perfmon.exe. This value may differ from PF Usage as displayed by the Windows Task Manager.

SelfCheck

Performs Avantra Agent self checking.

Description

Besides the checks run by the Avantra Agent, there are many other tasks being done in the background, for example, change or performance data collection. If something goes wrong while doing this background tasks, SelfCheck will tell you.

TimeOffset

Verifies server time accuracy.

Description

The check compares the UTC server time to the UTC time of the Avantra Server. If the time difference exceeds TimeOffsetWarn (default is 30 seconds), the status changes to Warning, and if it exceeds TimeOffsetCrit (default 60 seconds), it changes to Critical.

For this check to provide correct results, it is crucial to keep the Avantra Server host clock properly synchronized.