Skip to main content

# SAP BusinessObjects - Monitoring Parameters

Here you will find detailed information about monitoring parameters for SAP BusinessObjects monitored objects.

Monitoring parameters are the mechanism for you to configure how your systems are monitored. They are how you set configuration of how the agent runs, how checks are executed, thresholds for checks (when does a check go critical or warning) and much more. All Monitoring Parameters have a carefully chosen default value. As soon as you add a new system, Avantra uses these defaults. You may change these defaults by defining a parameter and by modifying its values. Monitoring Parameters can be defined for a single system, or for collections of systems using Monitoring Parameter Sets. You can also define your own Custom Monitoring Parameters for use within Custom Checks and automations.

## BoJobsSelectRange​

This monitoring parameter can be used to specify a range of days back from the current moment that is applied to select jobs. That is, the default value is 1 day, so all jobs that have been executed within the last 24 hours are selected by default.

### Reference Data​

Configures Checks | BO_Jobs
Default Value | 1
Unit | Days

## BoJobStatTimeSpan​

This monitoring parameter can be used to specify a time range back from the current moment that is applied to select jobs. That is, the default value is 60 minutes, so all jobs that have been executed within the last 60 minutes are selected by default.

### Reference Data​

Configures Checks | BO_JobStat
Default Value | 60
Unit | Minutes

## BoLogExprCrit​

This expression is used to process log entries from the SAP BusinessObjects log files. If an entry matches this expression, the BO_Logs check will become Critical.

### Reference Data​

Configures Checks | BO_Logs
Default Value | `InList('%%Log%%'; 'Fatal')`
Unit | Expression

## BoLogExprWarn​

This expression is used to process log entries from the SAP BusinessObjects log files. If an entry matches this expression, the BO_Logs check will become Warning.

### Reference Data​

Configures Checks | BO_Logs
Default Value | `InList('%%Severity%%'; 'E';'W')`
Unit | Expression

## BoLogGroups​

This parameter allows you to define a list of name patterns to narrow the list of log files that need to be examined by the BO_Logs check. Wildcards (`*`, `?`) are allowed. Different patterns must be separated by commas.

### Reference Data​

Configures Checks | BO_Logs
Default Value |
Unit | String

## BoLogGroupsExclude​

This monitoring parameter is used to define a list of log names that BO_Logs should exclude from analysis. Wildcards (*, ?) are allowed, and different patterns must be separated by commas.

NOTE: This monitoring parameter is just alongside BoLogGroups to define the set of logs to monitor.

### Reference Data​

Configures Checks | BO_Logs
Default Value | empty
Unit | String

## BoLogsTimeSpan​

This parameter can be used to define a time window in which BO_Logs examines the log entries back from the current moment. As an example, the default value is 60 minutes, so only log entries that have been written in the past 60 minutes are examined.

A side effect of this parameter is that it defines the time span a certain log entry is visible for BO_Logs. When an entry causes the check to become Critical, the check will remain Critical as long as the status is considered in the evaluation, i.e. during the time span.

The parameter is active for all examined log files.

### Reference Data​

Configures Checks | BO_Logs
Default Value | 60
Unit | Minutes

## BoProcessesOrphans​

This parameter lets you select if orphaned processes (parent process id = -1) are considered for calculating the check result.

### Reference Data​

Configures Checks | BO_Processes
Default Value | `include`
Unit | Enum

## BoServersExclude​

This parameter allows you to define a denylist of server names / patterns to be excluded from the evaluation by the BO_Servers check. Wildcards may be used (`*`, `?`), patterns must be separated by commas.

### Reference Data​

Configures Checks | BO_Servers
Default Value |
Unit | String

## BoServersInclude​

This parameter allows you to define a allowlist of server names / patterns to be considered by BO_Servers. Wildcards may be used (`*`, `?`), patterns must be separated by commas.

### Reference Data​

Configures Checks | BO_Servers
Default Value |
Unit | String

## BoServersStoppedStatus​

This parameter allows to define the status if any server is enabled but stopped.

### Reference Data​

Configures Checks | BO_Servers
Default Value | Critical
Unit | Enum

## BoSystemRootDirectory​

This parameter force overwrites the automatically detected system root of a SAP BusinessObjects installation. For example, on Unix installations, this should point to the `../<sid>/sap_bobj` folder.

### Reference Data​

Configures Checks | BO_CMSConnect, BO_Alive
Default Value |
Unit | String