Reference: SAP System Monitoring Parameters

This section contains a reference of all SAP System Monitoring Parameters provided by Avantra.

ABAP_DD_DB_Exclude

Configure exceptions for the ABAP_DD_DB check

Description

Indexes defined in this parameter are excluded from the "indexes missing" and "unknown indexes" part of the ABAP_DD_DB check. Please note that this parameter can only be used for indexes, but not for tables. Indexes listed must be separated by one or more spaces.

Reference Data
Configures

ABAP_DD_DB

Default Value
Unit

String

ABAPDBSchema

Override DB schema used for the DB2_CBO_STATS check

Description

If the tables required for the DB2_CBO_STATS check cannot be found in the default schema you may define the appropriate schema in here.

Reference Data
Configures

DB2_CBO_STATS

Default Value
Unit

String

AbapJsonMode

Configure which ABAP class to use for generating JSON

Description

If there are problems with the default ABAP class used to generate JSON in an SAP system, a compatibility mode can be chosen.

Reference Data
Configures

SAP System

Default Value

Automatic

Unit

Enum, either Automatic or Compatibility

AutoChangeDetectionIgnore

Description

AutoChangeDetectionIgnore is used to exclude parameters from System Change Auto Detection. If, for example, a parameter value changes regularly and this behavior is well-known, you may add the parameter to the exclude list. The parameter value is still updated in the Avantra Database, but no change record will be created. Since there are several change detection objects, you must prefix the list with a keyword to indicate the object type.

For SAP Systems, only DBPARAM is currently supported. Wildcard * is supported to define multiple parameters, e.g. DBPARAM: *MEMORY*, CPU_COUNT

Reference Data
Configures

System Change Auto Detection

Unit

Keyword followed by comma-separated value list, optionally followed by a semicolon followed by a keyword followed by comma-separated value list, …​ Colon, semicolon, and comma must be escaped by \ (backslash) if used as a value.

BatchInputClientExclude

Exclude clients from batch input check

Description

This parameter specifies clients which are excluded from all checks provided by BATCH_INPUT.

Reference Data
Configures

BATCH_INPUT

Default Value

000 066

Unit

String

BatchInputMaxAge

Configure warning threshold for batch input session age

Description

This parameter specifies the maximum age of batch input sessions. If there are records older than BatchInputMaxAge found, BATCH_INPUT will result as Warning. You can turn this part of BATCH_INPUT off if you change the parameter to 0.

Reference Data
Configures

BATCH_INPUT

Default Value

60

Unit

Days

BatchInputMaxRunTime

Configure warning threshold for batch input session runtime

Description

This parameter specifies the maximum run time of batch input sessions. If there are running sessions older than BatchInputMaxRunTime found, BATCH_INPUT will result as Warning.

Reference Data
Configures

BATCH_INPUT

Default Value

24

Unit

Hours

BatchInputQIDExclude

Exclude sessions from batch input check by Queue-ID

Description

This parameter defines batch input sessions by Queue-ID which are excluded from all sub-Checks of the BATCH_INPUT Check. The list of Queue-IDs may be separated by blanks or commas. Wildcards are not supported.

Reference Data
Configures

BATCH_INPUT

Default Value
Unit

String

BcsOutboundClientList

Configure a list of clients to be either excluded or included in Business Communication Services checks

Description

Works together with BcsOutboundClientMode, either to specify clients to be excluded (BcsOutboundClientMode is in mode Blacklist) or limited to only clients listed (BcsOutboundClientMode is in mode Whitelist). Please be aware that if you change parameter BcsOutboundClientMode, you can also change this parameter to another list, since the default value 000 066 is intended to work in Blacklist mode.

Reference Data
Configures

BCS_OutboundErrors, BCS_OutboundErrStat, and BCS_OutboundWaitStat

Default Value

000 066

Unit

String, i.e. list of three-digit clients separated by space, comma, or semicolon

BcsOutboundClientMode

Configure to use either Blacklist or Whitelist mode to exclude clients from being checked by Business Communication Services checks

Description

All Business Communication Services checks are designed to retrieve data of all clients found in an SAP system, no matter which client is used for RFC by the Avantra Agent. To exclude clients from being checked, you may use BcsOutboundClientList in either Blacklist or Whitelist mode. The default value is Blacklist, i.e. all clients will be checked except clients 000 and 066. If you want to, for instance, only check on specific clients, you may change this mode to Whitelist and specify the clients to be checked using parameter BcsOutboundClientList.

Reference Data
Configures

BCS_OutboundErrors, BCS_OutboundErrStat, and BCS_OutboundWaitStat

Default Value

Blacklist

Unit

Enum, either Blacklist or Whitelist

BcsOutboundErrorsNumCrit

Configures Critical threshold for BCS_OutboundErrors check

Description

If the number of erroneous outbound business communication records since the last Daily Check start is equal to or above the defined value, the check status is set to Critical.

Reference Data
Configures

BCS_OutboundErrors

Default Value

20

Unit

Number

BcsOutboundErrorsNumWarn

Configures Warning threshold for BCS_OutboundErrors check

Description

If the number of erroneous outbound business communication records since the last Daily Check start is equal to or above BcsOutboundErrorsNumWarn but below BcsOutboundErrorsNumCrit, the check status is set to Warning.

Reference Data
Configures

BCS_OutboundErrors

Default Value

5

Unit

Number

BcsOutboundErrStatNumCrit

Configures Critical threshold for BCS_OutboundErrStat check

Description

If the number of erroneous outbound business communication records in the last BcsOutboundErrStatTimeSpan minutes is equal to or above the defined value, the check status is set to Critical.

Reference Data
Configures

BCS_OutboundErrStat

Default Value

5

Unit

Number

BcsOutboundErrStatNumWarn

Configures Warning threshold for BCS_OutboundErrStat check

Description

If the number of erroneous outbound business communication records in last BcsOutboundErrStatTimeSpan minutes is equal to or above BcsOutboundErrStatNumWarn but below BcsOutboundErrStatNumCrit, the check status is set to Warning.

Reference Data
Configures

BCS_OutboundErrStat

Default Value

1

Unit

Number

BcsOutboundErrStatTimeSpan

Configure time in minutes to look back in time from now for erroneous business communication records

Description

If the date/time of an erroneous business communication record is after now minus BcsOutboundErrStatTimeSpan minutes, the record will be counted, otherwise, it is no longer retrieved.

Reference Data
Configures

BCS_OutboundErrStat

Default Value

60

Unit

Minutes

BcsOutboundWaitTimeExceptions

Configure exceptions for BcsOutboundWaitNumCrit and BcsOutboundWaitNumWarn for waiting business communication records that match client and send method

Description

If you want to use different wait times thresholds for certain outbound waiting records, you may use this parameter which follows the syntax:

<list of clients> or * for all | <list of send methods> or * for all | warning threshold in minutes | critical threshold in minutes`

Multiple clients and send methods of an exception are separated by comma (,). Please use the short name of the send method. Multiple exceptions are separated by semicolon (;). Spaces may exist at any place of the parameter string, since they will be ignored.

There is also a special value 0 for the warning and critical thresholds. 0 means that the corresponding threshold will not be verified. So if you set both to 0, you can exclude records completely from being verified. They are, however, still displayed in the result table.

Example 1. Examples: Exceptions
101,102|FAX|60|120 ; *|INT|20|40

For clients 101 and 102 send method FAX the warning/critical thresholds are changed to 60/120 minutes. For all clients and send method INT the warning/critical thresholds are changed to 20/40 minutes

900|FAX|0|0

In client 900 all waiting records for sent method FAX are completely ignored and will not contribute to the check result.

Reference Data
Configures

BCS_OutboundWaitStat

Unit

String

BcsOutboundWaitNumCrit

Configure Critical number threshold for waiting business communication records

Description

If the number of waiting business communication records in an SAP client is above BcsOutboundWaitNumCrit and the wait time is above BcsOutboundWaitTimeCrit, the check result status of BCS_OutboundWaitStat will be Critical.

Reference Data
Configures

BCS_OutboundWaitStat

Default Value

5

Unit

Number

BcsOutboundWaitNumWarn

Configure Warning number threshold for waiting business communication records

Description

If the number of waiting business communication records in an SAP client is above BcsOutboundWaitNumWarn and the wait time is above BcsOutboundWaitTimeWarn, the check result status of BCS_OutboundWaitStat will be Warning, as long as the number and time are still below the Critical thresholds.

Reference Data
Configures

BCS_OutboundWaitStat

Default Value

1

Unit

Number

BcsOutboundWaitTimeCrit

Configures Critical time threshold for waiting business communication records

Description

See description of BcsOutboundWaitNumCrit.

Reference Data
Configures

BCS_OutboundWaitStat

Default Value

15

Unit

Minutes

BcsOutboundWaitTimeWarn

Configures Warning time threshold for waiting business communication records

Description

See description of BcsOutboundWaitNumWarn.

Reference Data
Configures

BCS_OutboundWaitStat

Default Value

5

Unit

Minutes

BWProcessChainsCancelledStatus

Configure how to rate cancelled process chains

Description

Define the status that should be reported if one of the process chains is cancelled.

Reference Data
Configures

BW_PROCESSCHAINS

Default Value

2 (i.e. Critical)

Unit

Number

BWProcessChainsExclude

Exclude process chains from being verified

Description

Process chains defined in this parameter are not considered for the check status.

Reference Data
Configures

BW_PROCESSCHAINS

Default Value
Unit

String

BWProcessChainsRTCrit

Configure critical runtime threshold for process chains

Description

If one of the process chains exceeds the runtime threshold defined, the check status turns to Critical.

Reference Data
Configures

BW_PROCESSCHAINS

Default Value

240

Unit

Minutes

BWProcessChainsRTWarn

Configure warning threshold for process chains

Description

If one of the process chains exceeds the runtime threshold defined, but none exceeds the threshold defined in BWProcessChainsRTCrit and none terminates with errors, the check status turns to Warning.

Reference Data
Configures

BW_PROCESSCHAINS

Default Value

120

Unit

Minutes

BWQueryRuntimeCrit

Configure critical threshold for BW/BI queries

Description

If a query within an SAP BW/BI System runs longer than the time defined in this parameter, the check turns to Critical.

Reference Data
Configures

BW_QUERYRUNTIME

Default Value

1200

Unit

Seconds

BWQueryRuntimeExclude

Exclude BW/BI queries from being monitored

Description

Queries added to this list are not considered for the check result.

Reference Data
Configures

BW_QUERYRUNTIME

Default Value
Unit

String

BWQueryRuntimeWarn

Configure warning threshold for BW/BI queries

Description

If a query within an SAP BW/BI System runs longer than the time defined in this parameter, but not longer than BWQueryRuntimeCrit, the check turns to Warning.

Reference Data
Configures

BW_QUERYRUNTIME

Default Value

900

Unit

Seconds

CCMSMonsetMTEMaxCount

Configure a maximum number of Monitoring Tree Elements (MTEs) for the CCMS_MONSET Custom Check

Description

A CCMS monitor tree of a CCMS_MONSET Custom Check may contain a lot of MTEs, which results in many checks being created in Avantra’s RealTime Monitoring. If you want to limit this number of checks, you can set the CCMSMonsetMTEMaxCount parameter. When MTEs are CCMS Monitor tree is read, and the number of CCMSMonsetMTEMaxCount is exceeded, the remaining MTEs are ignored and the corresponding CCMS_MONSET Custom Check will report a Warning result.

Per default, this parameter is 0, i.e. it is inactive and the number of MTEs is unlimited.

Reference Data
Configures

CCMS_MONSET Custom Check

Default Value

0

Unit

Number

CompVersFunction

Configure the function used to get component versions from the SAP system

Description

If any component version shows 0 instead of the correct version using the function DELIVERY_GET_INSTALLED_COMPS, it is recommended to use the function OCS_GET_INSTALLED_COMPS.

Reference Data
Configures

SAP System

Default Value

OCS_GET_INSTALLED_COMPS

Unit

Enum, either DELIVERY_GET_INSTALLED_COMPS or OCS_GET_INSTALLED_COMPS

DialogPerfMinStepCount

Configure a lower bound for the executed steps in dialog performance and workload checks

Description

If during a reported day period the number of dialog steps is less than the defined value, the runtime of the steps is not considered for the Check Result of the DIALOGPERF and WORKLOAD Checks.

Roughly speaking, if you have less than 1000 dialog steps from — let’s say — 6h to 7h, it won’t hurt if 20% of them run longer than a second. Obviously, this is different for 10000 dialog steps.

Reference Data
Configures

DIALOGPERF and WORKLOAD

Default Value

1000

Unit

Number

DialogPerfPctCumulatedCrit

Configure critical threshold for dialog performance

Description

The check turns Critical if less than DialogPerfPctCumulatedCrit percent of the dialog steps finish within DialogPerfRespTimeLimit, except if only less than DialogPerfMinStepCount are performed.

Reference Data
Configures

DIALOGPERF

Default Value

85

Unit

%

DialogPerfPctCumulatedWarn

Configure warning threshold for dialog performance

Description

The check turns to Warning if more than DialogPerfPctCumulatedCrit percent but less than DialogPerfPctCumulatedWarn percent of the dialog steps finish within DialogPerfRespTimeLimit except if only less than DialogPerfMinStepCount are performed.

Reference Data
Configures

DIALOGPERF

Default Value

95

Unit

%

DialogPerfRespTimeLimit

Configure dialog performance runtime threshold

Description

Defined the runtime threshold. Valid parameters are: 0.1, 0.2, 0.3, 0.4, 0.5, 1, 2, 3, 10

Reference Data
Configures

DIALOGPERF

Default Value

1

Unit

Seconds

DialogPerfTimePeriod

Configure time range for dialog performance check

Description

Defines the time period the check should consider. Valid values are within the range 00-24, like e.g. 06-18.

Reference Data
Configures

DIALOGPERF

Default Value

00-24

Unit

Formatted String

DialogRespTimeCrit

Configure critical threshold for the workload check

Description

If the SAP Systems average dialog response time exceeds DialogRespTimeCrit ms, the check status is set to Critical.

Reference Data
Configures

WORKLOAD

Default Value

2000

Unit

Milliseconds

DialogRespTimeWarn

Configure warning threshold for the workload check

Description

If the SAP Systems average dialog response time exceeds DialogRespTimeWarn ms, but does not exceed DialogRespTimeCrit ms, the check status is set to Warning.

Reference Data
Configures

WORKLOAD

Default Value

1000

Unit

Milliseconds

DialogResponseTimeNames

Configure response times to include in DialogResponseTimes check.

Description

By default, the DialogResponseTimes check only monitores FrontendResponseTime.

Other typical response times are: ResponseTimeDialog, ResponseTimeDialogRFC, ResponseTimeHTTP.

Reference Data
Configures

DialogResponseTimes

Default Value

FrontendResponseTime

Unit

String

IdocsAgeWarn

Configure warning threshold for IDOC age

Description

If there are IDOCs older than IdocsAgeWarn days, the check result is set to Warning.

Reference Data
Configures

IDOCS

Default Value

365

Unit

Days

IdocsGrpRedCountCrit

Define critical RealTime Monitoring threshold for the number of IDOCs

Description

If the number of IDOCS in group "red" exceeds IdocsGrpRedCountCrit during IdocsGrpRedTimeSpan minutes, the check result is set to Critical.

Reference Data
Configures

IDOCSTAT

Default Value

5

Unit

Number

IdocsGrpRedCountWarn

Define warning RealTime Monitoring threshold for the number of IDOCs

Description

If the number of IDOCS in group "red" exceeds IdocsGrpRedCountWarn during IdocsGrpRedTimeSpan minutes, but does not exceed IdocsGrpRedCountCrit, the check result is set to Warning.

Reference Data
Configures

IDOCSTAT

Default Value

1

Unit

Number

IdocsGrpRedDailyCountCrit

Define critical Daily Check threshold for the number of IDOCs

Description

If the number of IDOCS in group "red" exceeds IdocsGrpRedDailyCountCrit in the daily check, the result of IDOCS check is set to Critical.

Reference Data
Configures

IDOCS

Default Value

50

Unit

Number

IdocsGrpRedDailyCountWarn

Define warning Daily Check threshold for the number of IDOCs

Description

If the number of IDOCS in group "red" exceeds IdocsGrpRedDailyCountWarn in the daily check, but does not exceed IdocsGrpRedDailyCountCrit, the result of IDOCScheck is set to Warning.

Reference Data
Configures

IDOCS

Default Value

1

Unit

Number

IdocsGrpRedTimeSpan

Configure monitoring time span for RealTime Monitoring IDOCs check

Description

See the description of parameters IdocsGrpRedCountCrit and IdocsGrpRedCountCrit

Reference Data
Configures

IDOCSTAT

Default Value

60

Unit

Minutes

JavaDBSchema

Override DB schema used retrieval of J2EE Software Components

Description

If the tables required to retrieve the J2EE Software Components cannot be found in the default schema you may define the appropriate schema in here.

Reference Data
Configures

SAP System

Default Value
Unit

String

JavaJobStatTimeSpan

Description

Defines the time the span jobs are checked by the JavaJobStat check.

Reference Data
Configures

JavaJobStat

Default Value

60

Unit

Minutes

JavaJobsSelectRange

Description

Defines the time the span jobs are checked by the JavaJobs check.

Reference Data
Configures

JavaJobs

Default Value

1

Unit

Days

JobAbortCountCrit

Define critical threshold for RealTime Monitoring check of aborted jobs

Description

If the number of aborted jobs exceeds JobAbortCountCrit during the last JobAbortTimespan minutes, the check result is set to Critical.

Reference Data
Configures

JOBSTAT

Default Value

2

Unit

Number

JobAbortCountWarn

Define warning threshold for RealTime Monitoring check of aborted jobs

Description

If the number of aborted jobs exceeds JobAbortCountWarn during the last JobAbortTimespan minutes, but does not exceed JobAbortCountCrit, the check result is set to Warning

Reference Data
Configures

JOBSTAT

Default Value

1

Unit

Number

JobAbortExclude

Exclude jobs from being watched for aborts

Description

Defines job names excluded from aborted jobs monitoring. Separate multiple entries by spaces (wildcard * allowed). If your job name includes spaces, put double quotes (") around it.

Reference Data
Configures

JOBS and JOBSTAT

Default Value
Unit

String

JobUsersExclude

Exclude jobs from being watched

Description

Defines job users excluded from aborted jobs or delayed jobs monitoring. Separate multiple entries by spaces (wildcard * allowed). If your job user includes spaces, put double quotes (") around it.

Reference Data
Configures

JOBS and JOBSTAT

Default Value
Unit

String

JobAbortTimespan

Configure watch period for RealTime Monitoring aborted jobs check

Description

See the description of parameters JobAbortCountCrit and JobAbortCountWarn

Reference Data
Configures

JOBSTAT

Default Value

60

Unit

Minutes

JobDelayedCountCrit

Configure critical RealTime Monitoring threshold for the number of delayed jobs

Description

If JobDelayedCountCrit jobs are delayed for more than JobDelayedTimeCrit minutes, the check status is set to Critical.

Reference Data
Configures

JOBSTAT

Default Value

1

Unit

Number

JobDelayedCountWarn

Configure warning RealTime Monitoring threshold for the number of delayed jobs

Description

If JobDelayedCountWarn jobs are delayed for more than JobDelayedTimeWarn minutes, but jobs are still below JobDelayedCountCrit/JobDelayedTimeCrit criteria, the check status is set to Warning.

Reference Data
Configures

JOBSTAT

Default Value

1

Unit

Number

JobDelayedExclude

Exclude jobs from being watched for delays

Description

Defines job names excluded from job delay monitoring. Separate multiple entries by spaces (wildcard \* allowed). If your job name includes spaces, put double quotes (") around it.

Reference Data
Configures

JOBSTAT

Default Value
Unit

String

JobDelayedIncludeExpired

Define if expired jobs are considered delayed

Description

If set (which is the default), jobs with configured and expired No start after date/time are considered as delayed jobs as well. You can exclude expired jobs from delay monitoring by disabling this parameter.

Reference Data
Configures

JOBSTAT

Default Value

1

Unit

Boolean

JobMaxSelect

Configure maximal number of jobs to include in RealTime Monitoring

Description

For the monitoring of aborted and delayed jobs, only this number of jobs are considered.

Reference Data
Configures

JOBSTAT

Default Value

1000

Unit

Number

JobDelayedTimeCrit

Configure critical threshold for delay time of jobs

Description

See description of JobDelayedCountCrit above.

Reference Data
Configures

JOBSTAT

Default Value

10

Unit

Minutes

JobDelayedTimeWarn

Configure warning threshold for delay time of jobs

Description

See description of JobDelayedCountWarn above.

Reference Data
Configures

JOBSTAT

Default Value

2

Unit

Minutes

JobsDailyCountCrit

Configure critical Daily Check threshold for the number of delayed jobs

Description

If the number of aborted jobs reported in a daily check exceeds this value, the daily check result is set to Critical.

Reference Data
Configures

JOBS

Default Value

20

Unit

Number

JobsDailyCountWarn

Configure warning Daily Check threshold for the number of delayed jobs

Description

If the number of aborted jobs reported in a daily check exceeds this value but does not exceed JobsDailyCountCrit, the daily check result is set to Warning.

Reference Data
Configures

JOBS

Default Value

1

Unit

Number

KernelBackupDir

Configure a backup directory for kernel upgrades

Description

This parameter configures the local SAP Kernel Backup directory where existing kernel packages are backed up.

Reference Data
Configures

Automated Kernel Upgrade

Default Value

<agent directory>/sap_kernel_backup

Unit

String

KernelDownloadDir

Configure a download directory for kernel upgrades

Description

This parameter configures the target directory for kernel packages on the SAP server.

Reference Data
Configures

Automated Kernel Upgrade

Default Value

<agent directory>/sap_kernel_download

Unit

String

LocalMonitoringOff

Turn local monitoring off

Description

If you set this parameter Avantra will stop monitoring the System.

This setting can be used if you want to monitor this System only using End-to-End Application Monitoring (from a different System).

Do not change this Monitoring Parameter unless you really know what you are doing.
Reference Data
Configures

All checks assigned to the System.

Unit

Boolean

LockAgeCrit

Configure critical threshold for age of locks

Description

If an SAP lock is older than LockAgeCrit hours, the check status is set to Critical

Reference Data
Configures

LOCKTABLE

Default Value

24

Unit

Hours

LockAgeWarn

Configure warning threshold for age of locks

Description

If an SAP lock is older than LockAgeWarn hours, but not older than LockAgeCrit hours, the check status is set to Warning

Reference Data
Configures

LOCKTABLE

Default Value

8

Unit

Hours

LockExclude

Exclude users, clients, or tables in check for locks

Description

This parameter is used to exclude certain locks from the LOCKTABLE check. You can specify the locks to be excluded by client, user, table, and optionally argument. The syntax of parameter values is: client:user:table. If you want to exclude by the lock argument, use this syntax: client:user:table:argument. Wildcards * are allowed, e.g. if you specify *:*:*, all locks will be excluded and the check will always result in Ok (which is certainly not recommended). Multiple lock exclude specs are separated by one or more spaces.

If you, for instance; want to exclude all locks of user BGRFCSUPER on all tables starting with BGRFC, and additionally all locks on WSRM_EH* tables, no matter which user but only in client 000, your LockExclude specification would look like:

 *:BGRFCSUPER:BGRFC* 000:*:WSRM_EH*

If you want to exclude all locks containing ESH in lock arguments, your LockExclude specification would look like:

 *:*:*:*ESH*

Colons : and spaces must be escaped by \ (backslash) if used as values.

Reference Data
Configures

LOCKTABLE

Default Value
Unit

String

MIIDataServerNames

Description

Filter data server names for MII_DataServers check. Use a comma to separate multiple schedules, wildcard * is supported.

Reference Data
Configures

MII_DataServers

Default Value
Unit

String

MIIDataServerConnectorTypes

Description

Filter data servers by connector types for MII_DataServers check. Use a comma to separate multiple schedules, wildcard * is supported. Valid connector types are: AGG, PIC, KPI, XCT, XML and many more.

Reference Data
Configures

MII_DataServers

Default Value
Unit

String

MIIScheduleNames

Description

Filter schedule names for MII_Schedules check. Use a comma to separate multiple schedules, wildcard * is supported.

Reference Data
Configures

MII_Schedules

Default Value
Unit

String

MIIScheduleStatus

Description

Filter by schedule status for MII_Schedules check. Use a comma to separate multiple schedules status. Valid status are: PENDING, RUNNING, STOPPED, DISABLED.

Reference Data
Configures

MII_Schedules

Default Value
Unit

String

MIIFailedMessageNames

Description

Filter message names for MII_FailedMessageStat and MII_FailedMessages check. Use a comma to separate multiple message names, wildcard * is supported.

Reference Data
Configures

MII_FailedMessageStat MII_FailedMessages

Default Value
Unit

String

MIIFailedMessageTypes

Description

Filter message types for MII_FailedMessageStat and MII_FailedMessage check. Use a comma to separate multiple message types, wildcard * is supported.

Reference Data
Configures

MII_FailedMessageStat MII_FailedMessages

Default Value
Unit

String

MIIFailedMessageServers

Description

Filter message servers for MII_FailedMessageStat and MII_FailedMessage check. Use a comma to separate multiple message servers, wildcard * is supported.

Reference Data
Configures

MII_FailedMessageStat MII_FailedMessages

Default Value
Unit

String

MIIFailedMessageTimeSpan

Description

Configures time span to look back for failed messages.

Reference Data
Configures

MII_FailedMessageStat

Default Value

60

Unit

Minutes

MIIFailedTransactionNames

Description

Filter transaction names for MII_FailedTransactions and MII_FailedTransactionsStat check. Use comma to separate multiple transaction names, wildcard * is supported.

Reference Data
Configures

MII_FailedTransactionStat MII_FailedTransactions

Default Value
Unit

String

MIIFailedTransactionTimeSpan

Description

Configures time span to look back for failed transactions.

Reference Data
Configures

MII_FailedTransactionStat

Default Value

60

Unit

Minutes

MIILongRunningTransactionWarn

Description

Configures a warning threshold in minutes for long-running MII transactions.

Reference Data
Configures

MII_LongRunningTransactions

Default Value

30

Unit

Minutes

MIILongRunningTransactionCrit

Description

Configures a critical threshold in minutes for long-running MII transactions.

Reference Data
Configures

MII_LongRunningTransactions

Default Value

60

Unit

Minutes

NumRangesUsageWarn

Configure warning threshold for number ranges exhaustion

Description

If the number range’s exhaustion exceeds NumRangesUsageWarn percent, but does not exceed NumRangesUsageCrit percent, the check status turns to Warning.

Reference Data
Configures

NumberRanges

Default Value

85 %

Unit

%

NumRangesUsageCrit

Configure critical threshold for number ranges exhaustion

Description

If the NumberRanges exhaustion exceeds NumRangesUsageCrit percent, the check status turns to Critical.

Reference Data
Configures

NumberRanges

Default Value

95 %

Unit

%

NumRangesClientMode

Configure to use either Blacklist or Whitelist mode to exclude clients from being checked by NumberRanges check.

Description

To exclude clients from being checked, you may use NumRangesClientList in either Blacklist (default) or Whitelist mode. If you want to exclude specific clients, change this mode to Blacklist and specify the clients to be excluded using parameter NumRangesClientList. If you want to check on specific clients only, change this mode to Whitelist and specify the clients to be checked using parameter NumRangesClientList.

Reference Data
Configures

NumberRanges

Default Value

Blacklist

Unit

Enum, either Blacklist or Whitelist

NumRangesClientList

Configure a list of clients to be either excluded or included in number ranges checks

Description

Works together with NumRangesClientMode either to specify clients to be excluded or to specify clients to include.

Reference Data
Configures

NumberRanges

Default Value

066

Unit

String, i.e. list of three-digit clients separated by space, comma, or semicolon

NumRangesExclude

Define Number Ranges to exclude from NumberRanges checks

Description

You may exclude some Number Ranges from monitoring with this monitoring parameter. The syntax of an exclude specification is:<Object>:<Subobject>:<Number>. Please make sure to not use any spaces between the separation char : since spaces or semicolon ; are used to separate multiple entries. You can use wildcard * in an exclude specification.

To exclude all Number Ranges you can use *. This makes sense if you would want to use the individual thresholds only as defined in SAP transaction SNUM. See NumRangesUseObjectDef for further information.

Examples:

Example 2. NumRangesExclude
Value Selection
AUFTRAG

All number ranges AUFTRAG are excluded, no matter which object or Subobject

ANLAGENNR:1000

All number ranges with Object ANLAGENNR AND Subobject 1000 are excluded

ANLAGENNR:1000:03

All number ranges with Object ANLAGENNR AND Subobject 1000 AND Number 03 are excluded

RKE_BELEG::02

All number ranges with Object RKE_BELEG, any Subobject AND Number 02 are excluded

ANLAGENNR:1000,3000:02,03

All number ranges with Object ANLAGENNR, AND Subobject 1000 or Subobject 3000 AND Number 02 or NUMBER 03 are excluded

RKE*

All number ranges with Object name starting with RKE are excluded, no matter which object or Subobject

Reference Data
Configures

NumberRanges

Unit

String

NumRangesInclude

Define Number Ranges to include from NumberRanges checks

Description

You may include some Number Ranges from monitoring with this monitoring parameter. The syntax of an include specification is:<Object>:<Subobject>:<Number>. It is exactly the same syntax as described in NumRangesExclude parameter. Please note that NumRangesInclude precedes before NumRangesExclude.

Reference Data
Configures

NumberRanges

Unit

String

NumRangesUsageEx

Define individual Number Ranges warning and critical thresholds for specific Number Ranges.

Description

The default warning and critical thresholds for Number Ranges can be set with NumRangesUsageWarn and NumRangesUsageCrit monitoring parameters. If you need different threshold values for your Number Ranges, then use NumRangesUsageEx to define individual thresholds. The syntax is as follows:

<Client>:<Object>:<Subobject>:<Number>:warn:crit

Please make sure to not use any spaces between the separation char : since spaces or semicolon ; are used to separate multiple entries. You can use wildcard *. Please note that all 6 values must be set for a valid usage specification.

Examples:

Example 3. NumRangesUsageEx
Value Selection
000:COPA_PLAN:0012:01:80:99

All number ranges from Client 000, Object COPA_PLAN, Subobject 0012 and Number 01 get a warning threshold of 80% and a critical threshold of 99%.

*:GL*:*:05:20:90

All number ranges from all Clients (*), Objects starting with GL (GL*), all Subobjects (*) and Number 05 get a warning threshold of 20% and a critical threshold of 90%.

Configures

NumberRanges

Unit

String

NumRangesUseObjectDef

Use the threshold of the object to monitor this number range and not the thresholds defined in NumRangesUsageWarn and NumRangesUsageCrit

Description

Each SAP Number Range may define a specific threshold. Those thresholds can have a different value. Avantra does not use those thresholds by default. Avantra uses the monitoring parameters NumRangesUsageWarn and NumRangesUsageCrit to define thresholds. If you want to use the threshold defined for the Number Range in your SAP System, use this monitoring parameter. Since the SAP System only provides one threshold, you need to specify if the check status is set to Critical or Warning when the threshold exceeds. The syntax is: <Object>:<CRITICAL|WARNING>. Multiple specifications are separated by a space or semicolon. You can use wildcard * in a specification.

Example 4. NumRangesUseObjectDef examples
Value Selection
AUFTRAG

For all number ranges AUFTRAG, the threshold defined on AUFTRAG number range is used. If the number range exhausts the threshold, the check reports WARNING.

RKE_BELEG:CRITICAL

For all number ranges RKE_BELEG, the threshold defined on RKE_BELEG number range is used. If the number range exhausts the threshold, the check reports CRITICAL.

Reference Data
Configures

NumberRanges

NumRangesRollingIntervals

Show rolling Number Ranges.

Description

SAP Number Ranges can be rolling or not. NumberRanges selects by default both rolling and non-rolling Number Ranges. If you want to select only non-rolling Number Ranges, then deselect this option.

Reference Data
Configures

NumberRanges

Default Value

true

Unit

boolean

PerfDataCollectABAPTaskTypes

Choose ABAP task types for performance data collection

Description

This parameter does exactly the same as SAP Instances, except that it will control the Performance Data Collection of the SAP system, i.e. the total values of the configured ABAP task types.

Reference Data
Configures

SAP System Performance Data Collection

Default Value

BACKGROUND, HTTP

Unit

String, i.e. list of task types separted by comma or semicolon (,;). Leading, trailing or multiple spaces between the separation chars are allowed and will be trimmed away. Though unlikely to be necessary, you must escape ,; by a backslash \, should these chars appear in a task type name.

PerfDataCollection

Turn Performance Data Collection on or off (for SAP Systems)

Description

Controls whether or not Performance Data Collection is turned on for Systems. If you do not want the Avantra Agent to collect performance data you may remove the flag.

Reference Data
Configures

System

Default Value

On

Unit

Check box

PerfDataTARuntimeStepsMinPct

Restrict transactions considered for Performance Data Collection

Description

Transactions with a percentage of the total number of transaction steps below threshold PerfDataTARuntimeStepsMinPct will not be listed in section Top N transaction response times sorted by average response time of the Service Level Report. This is to ignore transactions with a very low number of steps which often have a high response time and thus makes the service level report more significant.

Reference Data
Configures

SAP System Performance Data Collection

Default Value

2

Unit

%

PerfDataTARuntimeTop

Configure the N in Top N transactions (by runtime)

Description

Defines the number of transactions to be listed in the section Top N transaction response times sorted by average response time of the service level report.

Reference Data
Configures

SAP System Performance Data Collection

Default Value

20

Unit

Number

PerfDataTAStepsTop

Configure the N in Top N transactions (by steps)

Description

Defines the number of transactions to be listed in the section Top N transaction response times sorted by number of steps of the service level report.

Reference Data
Configures

SAP System Performance Data Collection

Default Value

20

Unit

Number

PerfDataTopNIncludeReports

Include Reports in Top N transactions.

Description

Set this monitoring parameter to include reports in Top N performance chart. If this monitoring parameter is not set, only transactions are included in Top N performance chart.

Reference Data
Configures

SAP System Performance Data Collection

Default Value

not set

Unit

Boolean

PerfDataTransactions

Configure named transactions

Description

Defines the SAP transactions of which you want to explicitly collect performance data. The response times of these transactions will be reported in the service level report in section Monthly average response times of named transactions.

Reference Data
Configures

SAP System Performance Data Collection

Default Value
Unit

String

PerfDataCollectABAPTimeRange

Limit ABAP transaction performance collection to certain time ranges

Description

Defines the time ranges in days and hours for which performance data of SAP transactions defined in PerfDataTransactions is effectively collected. If this parameter is not set, performance data is collected 7 days a week and 24 hours per day. If, for instance, you want to collect transaction performance data only from Monday to Friday and from 08:00 to 17:00, then set this value to: 1-5:8-17

The first part defines the day range, where 1 is Monday and 7 is Sunday. The second part defines the hours within a day.

You can define multiple ranges by separating them with a comma. Following patterns selects transaction performance data from Monday to Thursday from 08:00 to 17:00 and Friday from 08:00 to 16:00 only: 1-4:8-17,5:8-16

Reference Data
Configures

SAP System Performance Data Collection

Default Value
Unit

String

PIAEMessagesNumCrit

Configure Critical threshold for PI_AEMessages check

Description

If the number of erroneous PI Adapter Engine XML messages since the last Daily Check start is equal to or above this value, the check status is set to Critical.

Reference Data
Configures

PI_AEMessages

Default Value

20

Unit

Number

PIAEMessagesNumWarn

Configure Warning threshold for PI_AEMessages check

Description

If the number of erroneous PI Adapter Engine XML messages since the last Daily Check start is equal to or above PIAEMessagesNumWarn but below PIAEMessagesNumCrit, the check status is set to Warning.

Reference Data
Configures

PI_AEMessages

Default Value

1

Unit

Number

PIAEMessagesStatNumCrit

Configure Critical threshold for PI_AEMessagesStat check

Description

If the number of erroneous PI Adapter Engine XML messages in last PIAEMessagesStatTimeSpan minutes is equal to or above this value, the check status is set to Critical.

Reference Data
Configures

PI_AEMessagesStat

Default Value

5

Unit

Number

PIAEMessagesStatNumWarn

Configure Warning threshold for PI_AEMessagesStat check

Description

If the number of erroneous PI Adapter Engine XML messages in last PIAEMessagesStatTimeSpan minutes is equal to or above PIAEMessagesStatNumWarn but below PIAEMessagesStatNumCrit, the check status is set to Warning.

Reference Data
Configures

PI_AEMessagesStat

Default Value

1

Unit

Number

PIAEMessagesStatTimeSpan

Configure time in minutes to look back in time from now for erroneous PI Adapter Engine XMLmessages

Description

If the date/time of an erroneous PI Adapter Engine XML message is after now minus PIAEMessagesStatTimeSpan minutes, the message will be counted, otherwise, it is no longer retrieved.

Reference Data
Configures

PI_AEMessagesStat

Default Value

60

Unit

Minutes

PIAEMessagesUseHttps

Configures PI_AEMessages and PI_AEMessagesStat checks to use https to connect instead of http

Description

If your PI J2EE instance is configured to use https only, usually due to security reasons, please use this parameter to indicate that the Agent shall use https to get the PI Adapter engine data.

Reference Data
Configures

PI_AEMessages and PI_AEMessagesStat

Default Value

0

Unit

Boolean

PICommChannelsCountCrit

Number of failed channels necessary to turn the check status to CRITICAL

Description

Defines the amount of channels that must have a failure state at the same time to turn the check state of the entire PI_CommChannels check to Critical. Channels are checked every Medium Check Cycle, i.e. per default every 10 minutes.

Reference Data
Configures

PI_CommChannels

Default Value

1

Unit

Number

PICommChannelsCountWarn

Number of failed channels necessary to turn the check status to WARNING

Description

Defines the amount of channels that must have a failure state at the same time to turn the check state of the entire PI_CommChannels check to Warning. When PICommChannelsCountCrit is smaller or equal, this parameter won’t have any effect. Channels are checked every Medium Check Cycle, i.e. per default every 10 minutes.

Reference Data
Configures

PI_CommChannels

Default Value

1

Unit

Number

PICommChannelsErrsCrit

Delays reporting of channel ERROR states

Description

Defines the number of subsequent ERROR channel states, before the check state of a channel is Critical. Channels are checked every Medium Check Cycle, i.e. per default every 10 minutes.

Reference Data
Configures

PI_CommChannels

Default Value

1

Unit

Number

PICommChannelsErrsWarn

Delays reporting of channel ERROR states

Description

Defines the number of subsequent ERROR channel states, before the check state of a channel is Warning. However, if the number of subsequent ERROR channel states is equal to or above PICommChannelsErrsCrit, this parameter has no effect. Channels are checked every Medium Check Cycle, i.e. per default every 10 minutes.

Reference Data
Configures

PI_CommChannels

Default Value

1

Unit

Number

PICommChannelsTimeCrit

Delays reporting of channel ERROR states

Description

Defines the number of minutes before the check state of a channel is reported as Critical. Please consider that channels are checked every Medium Check Cycle, i.e. per default every 15 minutes, so the reporting might be delayed additionally by the Medium Check Cycle interval.

Reference Data
Configures

PI_CommChannels

Default Value
Unit

Minutes

PICommChannelsTimeWarn

Delays reporting of channel ERROR states

Description

Defines the number of minutes before the check state of a channel is reported as Warning. Please consider that channels are checked every Medium Check Cycle cycle, i.e. per default every 10 minutes, so the reporting might be delayed additionally by the Medium Check Cycle interval.

If the setting is equal to or above PICommChannelsTimeCrit, this parameter has no effect.

Reference Data
Configures

PI_CommChannels

Default Value
Unit

Minutes

PICommChannelsExclude

Define the channels to be excluded from the PI_CommChannels check

Description

If a channel matches at least one criteria of the list of exclude criteria provided, it will be excluded from the check evaluation. The syntax of an excluded criterion is:

Exclude term: party|service|channel|activationState|channelState=<pattern>. A pattern may contain placeholders * (for any number of any characters) and/or ? (for a single character).

An exclude criteria consists of at least one or multiple exclude terms separated by a comma and surrounded by {}: {`Exclude specification(,Exclude specification)*}`. All exclude terms must match, i.e. the exclude terms are combined by logical AND.

Multiple criteria can be concatenated either by comma (,) or semicolon (;). A channel is excluded if it matches any of the listed criteria, i.e. the criteria are combined by logical OR.

Example 5. Exclusions

{party=bad,service=Test*},{channelState=INACTIVE}

Excludes all channels with a party that contain the term bad and with a service that starts with Test. Channels with an inactive channel state are excluded by the 2nd criterion {channelState=INACTIVE}. Please be aware that all string comparisons are case sensitive.

Reference Data
Configures

PI_CommChannels

Default Value

{channelState=INACTIVE}

Unit

String

PIExcludeSelftestFeatures

Exclude listed self-test features of PI checks that report self-tests

Description

Under certain circumstances, PI checks might report features with status not OK which results in Critical status of the whole check. You can exclude a certain feature from contributing to the check status. To do this, simply put the name of the feature on the comma-separated list provided by PIExcludeSelftestFeatures.

Excluded features will still be listed in the check result table, but the not OK status is are marked in grey color and is appended by Excluded info.

Reference Data
Configures

PI_AdapterFramework, PI_BusinessProcessEngine, PI_IntegrationDirectory, PI_IntegrationEngine, PI_IntegrationRepository, PI_J2SEAdapterEngine, PI_MappingRunTime, PI_RuntimeWorkbench, PI_SystemLandscapeDir

Default Value

WS_Security_Check

Unit

String, i.e. list of features to be excluded separated by comma

PIForceEnable

Override automatic SAP PI detection algorithm

Description

You can set this Monitoring Parameter to force the Avantra Agent to detect an SAP PI system in the rare case it does not automatically.

Reference Data
Configures

PI_CONNECT

Default Value

Not set

Unit

Boolean

PIIEMessagesClientList

Configure a list of clients to be either excluded or included in PI_IEMessages and PI_IEMessagesStat checks

Description

Works together with PIIEMessagesClientMode, either to specify clients to be excluded (PIIEMessagesClientMode is in mode Blacklist) or limited to only clients listed (PIIEMessagesClientMode is in mode Whitelist). Please be aware that if you change parameter PIIEMessagesClientMode, you can also change this parameter to another list, since the default value 000 066 is intended to work in Blacklist mode.

Reference Data
Configures

PI_IEMessages and PI_IEMessagesStat

Default Value

000 066

Unit

String, i.e. list of three-digit clients separated by space, comma, or semicolon

PIIEMessagesClientMode

Configure to use either Blacklist or Whitelist mode to exclude clients from being checked by PI Integration Engine XML messages checks

Description

PI Integration Engine XML messages checks are designed to retrieve data of all clients found in an SAP system, no matter which client is used for RFC by the Avantra Agent. To exclude clients from being checked, you may use PIIEMessagesClientList in either Blacklist or Whitelist mode. The default value is Blacklist, i.e. all clients will be checked except client 000 and 066. If you want to, for instance, only check on specific clients, you may change this mode to Whitelist and specify the clients to be checked using parameter PIIEMessagesClientList.

Reference Data
Configures

PI_IEMessages and PI_IEMessagesStat

Default Value

Blacklist

Unit

Enum, either Blacklist or Whitelist

PIIEMessagesNumCrit

Configure Critical threshold for PI_IEMessages check

Description

If the number of erroneous PI Integration Engine XML messages since the last Daily Check start is equal to or above this value, the check status is set to Critical.

Reference Data
Configures

PI_IEMessages

Default Value

20

Unit

Number

PIIEMessagesNumWarn

Configure Warning threshold for PI_IEMessages check

Description

If the number of erroneous PI Integration Engine XML messages since the last Daily Check start is equal to or above PIIEMessagesNumWarn but below PIIEMessagesNumCrit the check status is set to Warning.

Reference Data
Configures

PI_IEMessages

Default Value

1

Unit

Number

PIIEMessagesStatNumCrit

Configure Critical threshold for PI_IEMessagesStat check

Description

If the number of erroneous PI Integration Engine XML messages in last PIIEMessagesStatTimeSpan minutes is equal to or above this value the check status is set to Critical. Please note that the threshold is applied to each client individually, see PIIEMessagesClientMode and PIIEMessagesClientList parameters.

Reference Data
Configures

PI_IEMessagesStat

Default Value

5

Unit

Number

PIIEMessagesStatNumWarn

Configure Warning threshold for PI_IEMessagesStat check

Description

If the number of erroneous PI Integration Engine XML messages in last PIIEMessagesStatTimeSpan minutes is equal to or above PIIEMessagesStatNumWarn but below PIIEMessagesStatNumCrit the check status is set to Warning. Please note that the threshold is applied to each client individually, see PIIEMessagesClientMode and PIIEMessagesClientList parameters.

Reference Data
Configures

PI_IEMessagesStat

Default Value

1

Unit

Number

PIIEMessagesStatTimeSpan

Configure time in minutes to look back in time from now for erroneous PI Integration Engine XMLmessages

Description

If the date/time of an erroneous PI Integration Engine XML message is after now minus PIIEMessagesStatTimeSpan minutes, the message will be counted, otherwise, it is no longer retrieved.

Reference Data
Configures

PI_IEMessagesStat

Default Value

60

Unit

Minutes

PIReportOKMessages

Configure if SAP PI checks display Ok messages

Description

Defines if or if not Ok check messages are displayed for the SAP PI checks

ProfileParsDuplOk

Configure duplicate entries in profiles considered Ok

Description

List of SAP or database profile parameters allowed to occur multiple times in a file. Parameters listed here will no longer be considered as duplicate entries in the Profiles PROFILES check.

Reference Data
Configures

PROFILES

Default Value
Unit

String

QRFCInQueueExclude

Exclude inbound queues from QRFC checks

Description

If defined, the checks QRFC_IN and QRFC_IN_ERRQ will ignore all queues defined in QRFCInQueueExclude.

Separate multiple queues by white space (wildcard * is allowed)

You may also restrict queues based on the client if you use the format queue1:client11,client12,…​ queue2:client21,client22,…​

Reference Data
Configures

QRFC_IN and QRFC_IN_ERRQ

Default Value
Unit

String

QRFCInQueueHangCrit

Define critical threshold for hanging inbound QRFC queues

Description

If there are QRFCInQueueHangCrit or more hanging queues, the check status is set to Critical.

Reference Data
Configures

QRFC_IN_ERRQ

Default Value

10

Unit

Number

QRFCInQueueHangWarn

Define warning threshold for hanging inbound QRFC queues

Description

If there are QRFCInQueueHangWarn or more hanging queues, but still less than QRFCInQueueHangCrit the check status is set to Warning.

Reference Data
Configures

QRFC_IN_ERRQ

Default Value

1

Unit

Number

QRFCInRecQueuedCrit

Define critical threshold for inbound QRFC queue length

Description

If there are queues with more than QRFCInRecQueuedCrit records, the check status is set to Critical.

Reference Data
Configures

QRFC_IN

Default Value

30

Unit

Number

QRFCInRecQueuedWarn

Define warning threshold for inbound QRFC queue length

Description

If there are queues with more than QRFCInRecQueuedWarn records, there is no queue with more than QRFCInRecQueuedCrit records, the check status is set to Warning.

Reference Data
Configures

QRFC_IN

Default Value

15

Unit

Number

QRFCOutQueueExclude

Exclude outbound queues from QRFC checks

Description

If defined, the checks QRFC_OUT and QRFC_OUT_ERRQ will ignore all queues defined in QRFCOutQueueExclude. Separate multiple queues by white space (wildcard * is allowed)

You may also restrict queues based on the client if you use the format queue1:client11,client12,…​ queue2:client21,client22,…​

Reference Data
Configures

QRFC_OUT and QRFC_OUT_ERRQ

Default Value
Unit

String

QRFCOutQueueHangCrit

Define critical threshold for hanging outbound QRFC queues

Description

If there are QRFCOutQueueHangCrit or more hanging queues, the check status is set to Critical.

Reference Data
Configures

QRFC_OUT_ERRQ

Default Value

10

Unit

Number

QRFCOutQueueHangWarn

Define warning threshold for hanging outbound QRFC queues

Description

If there are QRFCOutQueueHangWarn or more hanging queues, but still less than QRFCOutQueueHangCrit the check status is set to Warning.

Reference Data
Configures

QRFC_OUT_ERRQ

Default Value

1

Unit

Number

QRFCOutRecQueuedCrit

Define critical threshold for outbound QRFC queue length

Description

If there are queues with more than QRFCOutRecQueuedCrit records, the check status is set to Critical.

Reference Data
Configures

QRFC_OUT

Default Value

30

Unit

Number

QRFCOutRecQueuedWarn

Define warning threshold for outbound QRFC queue length

Description

If there are queues with more than QRFCOutRecQueuedWarn records, there is no queue with more than QRFCOutRecQueuedCrit records, the check status is set to Warning.

Reference Data
Configures

QRFC_OUT

Default Value

15

Unit

Number

RelevantDailyCheckDetails

Configure Daily Check contributing check details (for SAP Systems)

Description

Defines a list of Daily Check details that are considered relevant for the Daily Check status, i.e. the status of which contribute to the overall status. By default the parameter is not defined, i.e. all Daily Check details contribute.

If you define an empty list no Daily Check detail will contribute. In this case, the status of the Daily Check will be Unknown always.

Reference Data
Configures

Daily Checks

Default Value
Unit

List of Checks

RFCConnectorWPMaxUsed

Control Avantra Agent work process usage

Description

In order to assure that the Avantra Agent does not allocate too many work processes, it checks the amount of work processes being used by the SAP System RFC user before running new RFC calls.

If more than RFCConnectorWPMaxUsed work processes are already used, the Avantra Agent stops with an error message, like Too many [3] dialog work processes in use by Avantra RFC user [AVANTRA_RFC]

Reference Data
Configures

RFCConnect

Default Value

3

RunDailyCheckOnWE

Define if Daily Checks are executed during the weekend (for SAP Systems)

Description

If set, Daily Checks will run on Saturday and Sunday as well.

Reference Data
Configures

Daily Checks

Default Value

0

Unit

Boolean

ShortDumpAgeWarn

Define warning threshold for short dumps Daily Check

Description

If there are short dumps older than ShortDumpAgeWarn days, the check status of the SHORTDUMPS check is set to Warning.

Reference Data
Configures

SHORTDUMPS

Default Value

7

Unit

Days

ShortDumpCountCrit

Define critical threshold for the short dumps RealTime Monitoring check

Description

If the number of short dumps exceeds ShortDumpCountCrit during ShortDumpTimeSpan minutes, the check status is set to Critical.

Reference Data
Configures

ShortDumpStat

Default Value

10

Unit

Number

ShortDumpCountWarn

Define warning threshold for the short dumps RealTime Monitoring check

Description

If the number of short dumps exceeds ShortDumpCountWarn during the last ShortDumpTimeSpan minutes, but does not exceed ShortDumpCountCrit, the check status is set to Warning.

Reference Data
Configures

ShortDumpStat

Default Value

5

Unit

Number

ShortDumpDailyCountCrit

Define critical threshold for the short dumps Daily Check

Description

If the number of short dumps reported within Daily Checks exceeds this value the check status is set to Critical.

Reference Data
Configures

SHORTDUMPS

Default Value

20

Unit

Number

ShortDumpDailyCountWarn

Define warning threshold for the short dumps Daily Check

Description

If the number of short dumps reported within Daily Checks exceeds ShortDumpDailyCountWarn but does not exceed ShortDumpDailyCountCrit the check status is set to Warning.

Reference Data
Configures

SHORTDUMPS

Default Value

1

Unit

Number

ShortDumpExclude

Exclude certain dumps from short dumps RealTime Monitoring and Daily Checks

Description

Defines short dump Error IDs (as displayed in SAP transaction ST22) to be excluded from monitoring. Separate multiple entries by spaces. Wildcard \* is allowed.

Reference Data
Configures

SHORTDUMPS and ShortDumpStat

Default Value
Unit

String

ShortDumpTimeSpan

Configure watch period for short dumps RealTime Monitoring check

Description

See the description of parameters ShortDumpCountCrit and ShortDumpCountWarn.

Reference Data
Configures

SHORTDUMPS

Default Value

60

Unit

Minutes

ShortDumpCountMaxSelect

Configure maximal number of short dumps to include in RealTime Monitoring check and Daily Checks

Description

The number of short dumps returned SHORTDUMPS and ShortDumpStat check are limited to this value.

Reference Data
Configures

SHORTDUMPS ShortDumpStat

Default Value

1000

Unit

Number

SLTIucJobs

Description

This parameter configures the jobs to be included in the SLT_IUCJobs check. Use commas to define multiple jobs, wildcards * are allowed.

Reference Data
Configures

SLT_IUCJobs

Default Value

empty

Unit

N/A

SLTIucJobsMinutesCrit

Description

If there were no SLT jobs finished within the time period specified by this parameter, the check result is set to CRITICAL.

Reference Data
Configures

SLT_IUCJobs

Default Value

60

Unit

Minute

SLTIucJobsMinutesWarn

Description

If there were no SLT jobs finished within the time period specified by this parameter, the check result is set to WARNING.

Reference Data
Configures

SLT_IUCJobs

Default Value

15

Unit

Minute

SLTSrcTrgtConfigName

Description

This parameter filters SLT configuration names considered for the SLT_SrcTrgt check, which must be separated by commas.

Reference Data
Configures

SLT_SrcTrgt

Default Value

empty

Unit

N/A

SLTSrcTrgtMtId

Description

This parameter filters SLT MTIDs (3-digit numbers) considered for the SLT_SrcTrgt check, which must be separated by commas.

Reference Data
Configures

SLT_SrcTrgt

Default Value

empty

Unit

N/A

SLTSrcTrgtCrit

Description

With this parameter, you can set a CRITICAL threshold for the difference between the source and target line numbers. If the difference is greater than or equal to the set parameter value, the evaluation result will be CRITICAL.

Reference Data
Configures

SLT_SrcTrgt

Default Value

100

Unit

N/A

SLTSrcTrgtWarn

Description

With this parameter, you can set a WARNING threshold for the difference between the source and target line numbers. If the difference is greater than or equal to this parameter value, but less than the value of the SLTSrcTrgtCrit parameter, the evaluation result will be WARNING.

Reference Data
Configures

SLT_SrcTrgt

Default Value

10

Unit

N/A

SLTStatusMtId

Description

This parameter configures the SLT status IDs (3-digit numbers) to be included. Use commas to define multiple IDs, wildcards * are allowed.

Reference Data
Configures

SLT_Status

Default Value

empty

Unit

N/A

SLTUnprocRecordsClient

Description

Set this parameter to filter SLT configurations considered during the SLT_Status check. The listed configuration names must be separated by a comma. If the value is empty, all configurations are retrieved.

Reference Data
Configures

SLT_Status

Default Value

empty

Unit

N/A

SLTUnprocRecsConfigName

Description

Set this parameter to filter SLT configurations considered during the SLT_UnprocRecs check. The listed configuration names must be separated by a comma. If the value is empty, all configurations are retrieved.

Reference Data
Configures

SLT_UnprocRecs

Default Value

empty

Unit

N/A

SLTUnprocRecsLimit

Description

With this parameter, you can define different WARNING and CRITICAL thresholds for the number of unprocessed records in different logging tables. Wildcards * are supported. Use the provided editor to set this monitoring parameter.

Reference Data
Configures

SLT_UnprocRecs

Default Value

*,1,100,1000 (i.e. *: table, 100: warning level, 1000: critical level)

Unit

N/A

SLTUnprocRecsMtId

Description

Set this parameter to filter SLT configuration IDs considered during the SLT_UnprocRecs check. The listed SLT configuration IDs (3-digit numbers) must be separated by a comma. When empty, all available configurations are retrieved.

Reference Data
Configures

SLT_UnprocRecs

Default Value

empty

Unit

N/A

SLTUnprocRecsCrit

Description

With this parameter, you can set the CRITICAL threshold. If the number of unprocessed records is greater than or equal to the specified parameter value, then the check result will be CRITICAL.

Reference Data
Configures

SLT_UnprocRecs

Default Value

100

Unit

N/A

SLTUnprocRecsWarn

Description

With this parameter, you can set the WARNING threshold. If the number of unprocessed records is greater than or equal to the specified parameter value, but less than SLT_UnprocRecsCrit, then the check result will be WARNING.

Reference Data
Configures

SLT_UnprocRecs

Default Value

10

Unit

N/A

SNCLevelOfProtection

Configure the SNC quality of protection level setting

Description

This setting is used as parameter JCO_CLIENT_SNC_QOP for the SAP JCo connection and configures the SNC quality of protection level setting. The default value is 3, i.e. Privacy protection.

Possible values are:

1

Authentication only

2

Integrity protection

3

Privacy protection (default)

8

Use the value from snc/data_protection/use on the application server

9

Use the value from snc/data_protection/max on the application server

Reference Data
Configures

RFCConnect

Default Value

3

Unit

Number

SNCLibraryPath

Configure the path and file name of the SAP Cryptographic Library to use for SNC encryption of the ABAP SAP Instance connection check

Description

This parameter defines the path and file name of the SAP Cryptographic Library to use for SNC encryption of ABAP RFC connection, i.e. the RFCConnect check. The file must be found by the Avantra Agent locally on the Server file system and must be accessible, of course. The SAP Cryptographic Library is used by all clients with SNC communication e.g. SAP GUI, so you can find out more details on this file by checking your existing configuration.

You can override this parameter on the SAP Instance level.
Example 6. Crypto Library
Windows

<Install_folder>\sapcrypto.dll

Unix

<Install_folder>/sapcrypto.lib

This parameter is required when you want to use SNC for the Avantra Agent RFC connection.
Reference Data
Configures

RFCConnect

Unit

String

SNCMode

Configure whether to use SNC encryption for the ABAP SAP Instance connection check

Description

Enabling this parameter will use SNC for the RFCConnect check. Before you enable this parameter, you need to make sure to completely configure the SNC settings, i.e. you need to configure the required SNC parameters according to your SNC setup, these are: SNCLibraryPath and SNCPartnerName. Also, setting SNCMyName is recommended.

Reference Data
Configures

RFCConnect

Default Value

Disable

Unit

Boolean

SNCMyName

Configure the name of the SNC certificate owner used in SNC encryption for the ABAP SAP Instance connection check

Description

This is a specific string containing the user name and some additional product information. The normal format is: <name type>:<external name>.

Example 7. SNCMyName

p:CN=miller, OU=ADMIN, O=SAP, C=DE, p/secude:CN=miller, OU=ADMIN

Reference Data
Configures

RFCConnect

Unit

String

SNCPartnerName

Configure the SNC name of the authorization partner used in SNC encryption for the ABAP SAP Instance connection check

Description

Specifies the AS ABAP’s SNC name the Avantra Agent connects to. You can find the application server’s SNC name in the profile parameter snc/identity/as.

Example 8. SNCPartnerName

p:CN=ABC, O=MyCompany, C=US

This parameter is required when you want to use SNC for the Avantra Agentʼs RFC connection.
Reference Data
Configures

RFCConnect

Unit

String

SNCSecuDir

Configure the SECUDIR environment variable

Description

Defines the value for the SECUDIR environment variable that is used by the RFC connection over SNC.

You can override this parameter on the SAP Instance level.
Reference Data
Configures

RFCConnect

Unit

String

SNCSingleSignOn

Configure the SSO behavior of SNC

Description

Do not use unless instructed by the Avantra Support.

Reference Data
Configures

RFCConnect

Unit

String

SpoolNOkCountCrit

Configure critical threshold for RealTime Monitoring spool check

Description

If the number of unprocessed or erroneous output requests (older than SpoolNOkTimeOffset minutes) during the last SpoolNOkTimeSpan minutes exceeds this value, the check status is set to Critical.

Reference Data
Configures

SPOOLSTAT

Default Value

10

Unit

Number

SpoolNOkCountWarn

Configure warning threshold for RealTime Monitoring spool check

Description

If the number of unprocessed or erroneous output requests (older than SpoolNOkTimeOffset minutes) during the last SpoolNOkTimeSpan minutes exceeds this value but does not exceed SpoolNOkCountCrit, the check status is set to Warning.

Reference Data
Configures

SPOOLSTAT

Default Value

5

Unit

Number

SpoolNOkDailyCountCrit

Configure critical threshold for Daily Check spool check

Description

If the number of unprocessed or erroneous output requests (older than SpoolNOkTimeOffset minutes) within Daily-Checks exceeds this value the check status is set to Critical.

Reference Data
Configures

SPOOL

Default Value

20

Unit

Number

SpoolNOkDailyCountWarn

Configure warning threshold for Daily Check spool check

Description

If the number of unprocessed or erroneous output requests (older than SpoolNOkTimeOffset minutes) within Daily-Checks minutes exceeds this value but does not exceed SpoolNOkDailyCountCrit, the check status is set to Warning.

Reference Data
Configures

SPOOL

Default Value

1

Unit

Number

SpoolNOkTimeOffset

Configure a time offset for spool checks

Description

See the description of parameters SpoolNOkCountCrit, SpoolNOkCountWarn, SpoolNOkDailyCountCrit and SpoolNOkDailyCountWarn.

Reference Data
Configures

SPOOLSTAT

Default Value

5

Unit

Minutes

SpoolNOkTimeSpan

Configure the watch period for the RealTime Monitoring spool check

Description

See the description of parameters SpoolNOkCountCritand SpoolNOkCountWarn.

Reference Data
Configures

SPOOLSTAT

Default Value

60

Unit

Minutes

SpoolNumRangeUsageCrit

Define a critical threshold for the spool number range usage ratio

Description

If the percentage of used spool requests exceeds the SpoolNumRangeUsageCrit threshold the check status is set to Critical.

Reference Data
Configures

SPOOLSTAT

Default Value

90

Unit

%

SpoolNumRangeUsageEnable

Enable RealTime Monitoring spool check to verify number range usage ratio

Description

Defines if or if not the SPOOLSTAT check verifies the number range usage ratio.

Reference Data
Configures

SPOOLSTAT

Default Value

1

Unit

Boolean

SpoolNumRangeUsageWarn

Define a warning threshold for the spool number range usage ratio

Description

If the percentage of used spool requests exceeds the SpoolNumRangeUsageWarn threshold but not the SpoolNumRangeUsageCrit threshold the check status is set to Warning.

Reference Data
Configures

SPOOLSTAT

Default Value

80

Unit

%

SpoolOutAccessMethodExclude

Exclude output requests to output devices using certain access methods from spool checks

Description

Defines access methods excluded from monitoring. Output requests which use a device with an access method specified in this list will not contribute to the check status. This is especially useful if you want to exclude all output requests which go to front end printers. You would then set the parameter to F. Separate multiple entries by spaces (wildcard * is allowed).

Reference Data
Configures

SPOOL and SPOOLSTAT

Default Value
Unit

String

SpoolOutDevExclude

Exclude output requests to certain output devices from spool checks

Description

Defines output devices excluded from monitoring. Output requests which go to a device specified in this list will not contribute to the check status. Separate multiple entries by spaces (wildcard \* is allowed).

Use the printers short names.
Reference Data
Configures

SPOOL and SPOOLSTAT

Default Value
Unit

String

SpoolOutDevTypeExclude

Exclude output requests to output devices using a certain output device type from spool checks

Description

Defines output devices types excluded from monitoring. Output requests which go to an output device with a device type specified in this list will not contribute to the check status. For example, you might want to use this parameter to exclude all output requests which go output devices with device type SAPWIN. Separate multiple entries by spaces (wildcard \* is allowed).

Reference Data
Configures

SPOOL and SPOOLSTAT

Default Value
Unit

String

SpoolReqAgeWarn

Define warning threshold for the age of spool requests

Description

If there are spool requests older than SpoolReqAgeWarn days, the check status is set to Warning.

Reference Data
Configures

SPOOL

Default Value

60

Unit

Days

SpoolReqIgnoreFutureDelDate

Ignore spool requests with a deletion date in the future.

Description

You can ignore spool requests which have a deletion date in the future. If the deletion date of the spool request is after the current date plus the number of days defined by SpoolReqIgnoreFutureDelDate, then the spool request is ignored and not reported in the check. The default value of 0 days ignores the deletion date. In other words, all spool requests with a deletion date also very far in the future are reported.

Reference Data
Configures

SPOOL

Default Value

0

Unit

Days

SSLCertificatesValidityCrit

Define Critical threshold for the SSLCertificatesValidity check

Description

If there are one or more certificates found, which expire in SSLCertificatesValidityCrit days or less, the check status is set to Critical.

Reference Data
Configures

SSLCertificatesValidity

Default Value

10

Unit

Days

SSLCertificatesValidityIgnore

Define expiration period for the SSLCertificatesValidity check

Description

Expired certificates no longer contribute to the status of SSLCertificatesValidity if they are expired for SSLCertificatesValidityIgnore days or more.

Reference Data
Configures

SSLCertificatesValidity

Default Value

10

Unit

Days

SSLCertificatesValidityWarn

Define Warning threshold for the SSLCertificatesValidity check

Description

If there are one or more certificates found, which expires in SSLCertificatesValidityWarn days or less, but do not expire in SSLCertificatesValidityCrit days or less, the check status is set to Warning.

Reference Data
Configures

SSLCertificatesValidity

Default Value

30

Unit

Days

SXMBMessagesClientList

Configure a list of clients to be either excluded or included in SXMB_Messages and SXMB_MessagesStat checks

Description

Works together with SXMBMessagesClientMode, either to specify clients to be excluded (SXMBMessagesClientMode is in mode Blacklist) or limited to only clients listed (SXMBMessagesClientMode is in mode Whitelist). Please be aware that if you change parameter SXMBMessagesClientMode, you may also change this parameter to another list, since the default value 000 066 is intended to work in Blacklist mode.

Reference Data
Configures

SXMB_Messages and SXMB_MessagesStat

Default Value

000 066

Unit

String, i.e. list of three-digit clients separated by space, comma, or semicolon

SXMBMessagesClientMode

Configure to use either Blacklist or Whitelist mode to exclude clients from being checked by PI Integration Engine XML messages checks

Description

PI Integration Engine XML messages checks are designed to retrieve data of all clients found in an SAP system, no matter which client is used for RFC by the Avantra Agent. To exclude clients from being checked, you may use SXMBMessagesClientList in either Blacklist or Whitelist mode. The default value is Blacklist, i.e. all clients will be checked except client 000 and 066. If you want to, for instance, only check on specific clients, you may change this mode to Whitelist and specify the clients to be checked using parameter SXMBMessagesClientList.

Reference Data
Configures

SXMB_Messages and SXMB_MessagesStat

Default Value

Blacklist

Unit

Enum, either Blacklist or Whitelist

SXMBMessagesNumCrit

Configure Critical threshold for SXMB_Messages check

Description

If the number of erroneous PI Integration Engine XML messages since the last Daily Check start is equal to or above this value the check status is set to Critical.

Reference Data
Configures

SXMB_Messages

Default Value

20

Unit

Number

SXMBMessagesNumWarn

Configure Warning threshold for SXMB_Messages check

Description

If the number of erroneous PI Integration Engine XML messages since the last Daily Check start is equal to or above SXMBMessagesNumWarn but below SXMBMessagesNumCrit the check status is set to Warning.

Reference Data
Configures

SXMB_Messages

Default Value

1

Unit

Number

SXMBMessagesStatNumCrit

Configure Critical threshold for SXMB_MessagesStat check

Description

If the number of erroneous PI Integration Engine XML messages in last SXMBMessagesStatTimeSpan minutes is equal to or above this value, the check status is set to Critical. Please note that the threshold is applied to each client individually, see SXMBMessagesClientMode and SXMBMessagesClientList parameters.

Reference Data
Configures

SXMB_MessagesStat

Default Value

5

Unit

Number

SXMBMessagesStatNumWarn

Configure Warning threshold for SXMB_MessagesStat check

Description

If the number of erroneous PI Integration Engine XML messages in last SXMBMessagesStatTimeSpan minutes is equal to or above SXMBMessagesStatNumWarn but below SXMBMessagesStatNumCrit, the check status is set to Warning. Please note that the threshold is applied to each client individually, see SXMBMessagesClientMode and SXMBMessagesClientList parameters.

Reference Data
Configures

SXMB_MessagesStat

Default Value

1

Unit

Number

SXMBMessagesStatTimeSpan

Configure time in minutes to look back in time from now for erroneous PI Integration Engine XMLmessages

Description

If the date/time of an erroneous PI Integration Engine XML message is after now minus SXMBMessagesStatTimeSpan minutes, the message will be counted, otherwise, it is no longer retrieved.

Reference Data
Configures

SXMB_MessagesStat

Default Value

60

Unit

Minutes

SysAliveIncompleteTimeCrit

Configure sensitivity of the SystemAlive check

Description

Defines how long a Warning SystemAlive check waits before turning to Critical if required SAP Instances are missing or no SAP Instance is available for a certain SAP System.

Reference Data
Configures

SystemAlive

Default Value

10

Unit

Minutes

TimeOutSAPControl

Define timeout for SAPControl actions

Description

SAPControl is used for several operations during monitoring, like remote detection of instances for agentless SAP system monitoring, certain checks, etc. This monitoring parameter allows you to configure the connect and read timeout for those SAPControl operations.

Reference Data
Configures

{SAP Agentless Detection, WebDispatcher monitoring, ERS monitoring, _DispatcherQueue }

Default Value

30

Unit

Seconds

TMSImportReturnCodeCrit

Configure the transport request return code which should be reported as Critical status

Description

Same as TMSImportStatReturnCodeCrit except that it configures Daily Check TMS_Imports instead of TMS_ImportStat. See also TMS_ImportStat for examples of TMSImportReturnCodeCrit usage.

Reference Data
Configures

TMS_Imports

Default Value

8

Unit

Enum, either 4, 8, or off

TMSImportReturnCodeWarn

Configure the transport request return code which should be reported as Warning status

Description

Same as TMSImportStatReturnCodeWarn except that it configures Daily Check TMS_Imports instead of TMS_ImportStat. See section TMS_ImportStat for examples of TMSImportReturnCodeWarn usage.

Reference Data
Configures

TMS_Imports

Default Value

4

Unit

Enum, either 4, 8, or off

TMSImportStatReturnCodeCrit

Configure the transport request return code which should be reported as Critical status

Description

If a transport request with return code equal to or above TMSImportStatReturnCodeCrit is found, TMS_ImportStat check status will be Critical. You can turn off Critical status completely when you set the value to off. See section TMS_ImportStat for examples of TMSImportStatReturnCodeCrit usage.

Reference Data
Configures

TMS_ImportStat

Default Value

8

Unit

Enum, either 4, 8, or off

TMSImportStatReturnCodeWarn

Configure the transport request return code which should be reported as Warning status

Description

If a transport request with return code equal to or above TMSImportStatReturnCodeWarn is found, and no transport request with return code equal to or above TMSImportStatReturnCodeCrit is found, TMS_ImportStat check status will be Warning. You can turn off Warning status completely when you set the value to off. See section TMS_ImportStat for examples of TMSImportStatReturnCodeWarn usage.

Reference Data
Configures

TMS_ImportStat

Default Value

4

Unit

Enum, either 4, 8, or off

TMSImportStatTimeSpan

Configure time in minutes to look back in time from now for transport requests with import return code above 0

Description

If the date/time of a transport request import is after now minus TMSImportStatTimeSpan minutes, the record will be counted, otherwise, it is no longer retrieved.

Reference Data
Configures

TMS_ImportStat

Default Value

60

Unit

Minutes

TRFCAgeWarn

Define warning threshold for the age of tRFC records

Description

If there are tRFC records older than TRFCAgeWarn days, the check result of TRFC_IN or TRFC_OUT is set to Warning.

Reference Data
Configures

TRFC_IN and TRFC_OUT

Default Value

1

Unit

Days

TRFCOutCountCrit

Define critical threshold for failed tRFC out records

Description

If the number of tRFC records with status CPICERR, SYSFAIL or SYSLOAD (older than TRFCOutTimeOffset minutes) during the last TRFCOutTimeSpan minutes exceeds this value the check status is set to Critical.

Reference Data
Configures

TRFCOutStat

Default Value

20

Unit

Number

TRFCOutCountWarn

Define warning threshold for failed tRFC out records

Description

If the number of tRFC records with status CPICERR, SYSFAIL or SYSLOAD (older than TRFCOutTimeOffset minutes) during the last TRFCOutTimeSpan minutes exceeds this value but does not exceed TRFCOutCountCrit the check status is set to Warning.

Reference Data
Configures

TRFCOutStat

Default Value

5

Unit

Number

TRFCOutTimeOffset

Configure time offset for tRFC out check

Description

See the description of parameters TRFCOutCountCrit and TRFCOutCountWarn

Reference Data
Configures

TRFCOutStat

Default Value

5

Unit

Minutes

TRFCOutTimeSpan

Define watch period for tRFC out check

Description

See the description of parameters TRFCOutCountCrit and TRFCOutCountWarn

Reference Data
Configures

TRFCOutStat

Default Value

60

Unit

Minutes

TRFCOutExcludeFunction

Exclude TRFC functions for TRFCOutStat

Description

This parameter is used to exclude certain functions from the TRFCOutStat check. The list of functions may be separated by blanks or a comma. Wildcards * and ? are supported.

Reference Data
Configures

TRFCOutStat

Unit

String

TRFCOutExcludeUser

Exclude TRFC users for TRFCOutStat

Description

This parameter is used to exclude certain users from the TRFCOutStat check. The list of functions may be separated by blanks or a comma. Wildcards * and ? are supported.

Reference Data
Configures

TRFCOutStat

Unit

String

UpdateErrCountCrit

Define critical threshold for update errors

Description

If the number of update errors exceeds UpdateErrCountCrit during the lastUpdateRecErrTimeSpan minutes, the check status is set to Critical.

Reference Data
Configures

UPDATERECERR

Default Value

6

Unit

Number

UpdateErrCountWarn

Define warning threshold for update errors

Description

If the number of update errors exceeds UpdateErrCountWarn during the lastUpdateRecErrTimeSpan minutes, but does not exceed UpdateErrCountCrit, the check status is set to Warning.

Reference Data
Configures

UPDATERECERR

Default Value

3

Unit

Number

UpdateQueueAgeCrit

Define critical threshold for the age of update records

Description

If there are UpdateQueueCountCrit or more update records older than UpdateQueueAgeCrit seconds, the check status is set to Critical

Reference Data
Configures

UPDATEQUEUE

Default Value

300

Unit

Seconds

UpdateQueueAgeWarn

Define warning threshold for the age of update records

Description

If there are UpdateQueueCountWarn or more update records older than UpdateQueueAgeWarn seconds, but the number of update records older than UpdateQueueAgeCrit seconds is below UpdateQueueCountCrit the check status is set to Warning

Reference Data
Configures

UPDATEQUEUE

Default Value

60

Unit

Seconds

UpdateQueueCountCrit

Define a critical threshold for the number of "old" update records

Description

See the description of parameter UpdateQueueAgeCrit

Reference Data
Configures

UPDATEQUEUE

Default Value

5

Unit

Number

UpdateQueueCountWarn

Define a warning threshold for the number of "old" update records

Description

See the description of parameter UpdateQueueAgeWarn

Reference Data
Configures

UPDATEQUEUE

Default Value

1

Unit

Number

UpdateRecErrTimeSpan

Define a watch period for the check for failed update records

Description

See the description of parameters UpdateErrCountCrit and UpdateErrCountWarn

Reference Data
Configures

UPDATERECERR

Default Value

60

Unit

Minutes

UseEnvironment

Override environment settings of the user sap<sid>

Description

Use only if instructed by Avantra support

Reference Data
Configures
Default Value
Unit

ENVVAR1 value ; ENVVAR2=value ; …​ Notes: Environment variable names are handled case insensitive. You may use any number of spaces between = and ;.

UserPWDAuditExclude

Exclude certain users from the user audit check

Description

Tells USER_PWD_AUDIT to exclude the listed users from the check result evaluation. If one of the users on this list has a well-known password, it is listed in the check message but does not contribute to the check status. Anyway, USER_PWD_AUDIT checks if the users on this list are locked.

Reference Data
Configures

USER_PWD_AUDIT

Default Value

SAPCPIC EARLYWATCH

Unit

String

UserPWDAuditFailedLogonSeverity

Control the check severity reported for users locked due to unsuccessful login attempts

Description

{UserPWDAuditFailedLogonSeverity} controls how users locked due to unsuccessful login attempts will be checked. If this parameter is set to _Critical a user locked due to unsuccessful login attempts will be reported as {Critical}. If UserPWDAuditFailedLogonSeverity is set to _OK (not recommended), a user locked due to unsuccessful login attempts will not contribute to the check result.

Reference Data
Configures

USER_PWD_AUDIT

Default Value

Warning

Unit

Enum, either Critical, Warning, or OK (not recommended)

XALVariantActive

Configure CCMS integration

Description

Defines whether the CCMS properties variant defined by XALVariantName will be activated automatically. If this parameter is set to 0, the Avantra properties variant is not activated automatically, so the settings may be written to an inactive variant and are not used by CCMS. If the parameter is set to 1, which is the default, XALVariantName is automatically activated and will stay active because any manual changes to the active variant using SAP transaction RZ21 will be overwritten periodically.

Reference Data
Configures

CCMS Custom Checks

Default Value

1

Unit

Boolean

XALVariantName

Configure CCMS integration

Description

Defines the name of the CCMS properties variant when settings are written to CCMS using Avantra. Use SAP transaction RZ21 to get an overview of properties variants. If you change XALVariantName you need to make sure that the variant already exists and the owner of the variant is set to SYSLINK. The default variant name SYSLINK is automatically created if it does not exist.

Reference Data
Configures

CCMS Custom Checks

Default Value

SYSLINK

Unit

String

StartStopDependentWINService

Used in Automation for Windows operating systems

Description

This parameter is only applicable if your SAP database runs on a Windows operating system as a Windows service. Avantra Automation can start and stop those windows services, but Avantra does not know if dependent Windows services should be started or stopped as well. If you want to start and stop those dependent Windows services as well, then activate this with this parameter.

Reference Data
Default Value

not set

Unit

Boolean

WaitingTimeStartMoniOn

Used in Automation for start system operations

Description

After Avantra starts a system (e.g SAP System, database, or server), Avantra sets the monitoring switch to on. Avantra already has some built-in logic to detect whether the system is up and running, but sometimes a system responds that it is running, but in fact it is not yet ready for production ussage. The time until the system is ready highly depends on the system internals and is unknown to Avantra. With this parameter, you can define how long Avantra should wait after starting the system until the monitoring switch is turned on.

Reference Data
Default Value

60

Unit

Seconds

WaitingTimeMoniOffStop

Used in Automation for stop system operations

Description

Avantra turns the monitoring switch off before stopping a system. Use this parameter to define how long Avantra should wait after turning the monitoring switch off until Avantra stops the system.

Reference Data
Default Value

0

Unit

Seconds