(DI-2208) Configuration of Properties

Owned by SNP
Jul 29, 2022
6 min read

By selecting Configuration in the tree, it is possible to display system configuration properties and customize the behavior of some predefined properties.

Configuration property setup


Add System description into Alert notification subject
The user has the opportunity to add a system description into the Alert notification subject of the email. By default, the system description is not added to the email subject. 
Max. runtime for execution of Collector BG jobs in seconds
Determines the maximum runtime for the execution of Collector background (BG) jobs. If BG job runtime reaches this time limit, it is aborted. The default value is 600 seconds (10 minutes). 
Allows you to use KILL WP for long-running Collector BG jobs
Allows you to use the OS level function "KILL Work-Process" to terminate the Collector BG job, which cannot be aborted with the standard functionality. Works only, if the previous configuration parameter "Max. runtime for BG job agent..." is specified. Set this parameter to 'X' to turn it on. The value is by default empty.
Retention time for background jobs in days
Background jobs are periodically deleted to clean the TBTCO table. The property BG_JOB_RETENTION_TIME sets a time condition in days, based on which the system deletes background jobs back into the past. The default value is 7 days.
Priority class for the execution of Collector BG jobs 
Sets BG job priority class for the execution of Collector BG jobs. There are three priority classes used: 'C'-lowest priority, 'B'-medium priority, 'A'-highest priority. The default value is 'C'. If the value isn't specified, the priority is the same as by default value 'C'.
Server group for executing Collector BG jobs
Specifies the name of a server group on which BG jobs are executed. A server group must be created by the SAP transaction SM61. It determines a specific list of application servers on which BG jobs can run. The value is by default empty (no specific server group is used). 
Warning: If the server group is not set correctly (doesn't exist in SM61) then the execution of Collector jobs fails.
User ID used for the execution of Collector BG jobs
Sets the user ID which is used for the execution of Collector jobs. Each execution of Collector jobs and all actions of monitoring on the central system are performed under this user ID. If a user ID isn't defined (default value), then the ID of logon user who triggers the execution of the Collector BG job is used. In case the user ID is not valid, the system displays the following error message "Can not start a background job! Reason: <user ID> does not exist."
It is recommended to create a system-type user on the central monitoring system and set it up with limited authorizations which can be defined in the role /DVD/MON_ADMIN.
When the set user ID used for the execution of BG jobs is deleted, all affected jobs start failing. CrystalBridge® Monitoring can detect these failures and display them by marking the particular line with a red icon in the 'Collector jobs' tab in the Insights Monitor. Also, affected systems are marked with a red icon in the list of monitored systems. Please note: For the correct run of collector jobs, it is important that the user ID is not deleted or locked.
Name of the cleanup job
Specifies the name of the BG job which cleans up all transactional data according to retention dates. The retention date for all collected data is calculated based on retention time (in days) which you set in the Collector BG jobs' definition. This cleanup job is scheduled and executed only once per day (the starting time of this job depends on the next setting "Starting time of cleanup job"). Purpose of this cleanup job is to delete all transactional data that has its retention date older than the date of the cleanup job execution. The goal of this cleanup job is to have on the system only data that fulfills the retention period. 
Starting time of clean up
Specifies the starting time of the BG job to clean up all transactional data according to retention dates. When you change the starting time to a time that already passed that day, the cleanup job is rescheduled to the next day. The time must be set in the following way: <HH:MM:SS>. 
External storage ID in Storage Management
This setup allows you to store monitoring results in a different (external) transparent storage with the help of Storage Management (SM). You must define a Storage ID in DVD SM through the transaction /DVD/SM_SETUP. Monitoring results stored on external storage are protected against retention deletion. Only transparent storages are supported. For more information about DVD SM please contact our consultants. The value is by default empty (no external storage is used).
Maximum allowed percentage of used aRFC resources
CrystalBridge® Monitoring checks the system and server availability using asynchronous processes [aRFC] to prevent communication freezes. Each system has a limited number of dialog worker processes (75% is the system default value, check the transaction SARFC for details) which are used for aRFCs. This setting determines the maximum number of aRFC resources that can be used by Insights availability checks. If Insights requests aRFC resources, which have exceeded the configured limits, it waits until aRFC resources are available again. The waiting time is set in the following configuration parameter. If the waiting time is exceeded, the availability check is not performed and an error message is written to the log. This setting should be applied only in the case when the Insights central instance runs on a system with limited resources or on a system that uses aRFC by other transactions. The value is by default empty. 
Max. waiting time to check available aRFC resources 
Defines waiting time in seconds, to check if aRFC resources are available for the CrystalBridge® Monitoring availability check. This parameter works only in combination with the previous configuration parameter. The value is by default empty. (no waiting time, availability check, and Collector job are canceled when aRFC resources aren't available, an error message is written to the log).
E-mail address used for the sender of the notification
The E-mail address is used as a sender in notification emails. Default value is do_not_reply@snpgroup.com (same e-mail address is used if the value is not specified). 
Warning: If you enter an invalid e-mail address, no notification emails will be sent.
Suppress collector runtime statistics 
The user has the opportunity to suppress the calculation of the collector's runtime statistics. Each Collector job calculates the runtime of its current run and also an average runtime from previously calculated values. You might speed up the Collector job executions by suppressing the calculation of its runtime statistics. 
Displays popup for the user in the different time zone
Informs the user that there are time zone differences between the system and the user (default 'X' value). If the parameter isn't set, a pop-up won't appear. If the parameter is set to 'Y', the pop-up is displayed and the CrystalBridge® Monitoring Monitor is closed
Username for default variant replication
Defines a username whose variant is used as the default variant for other users during the first execution of CrystalBridge® Monitoring cockpit or when a user resets the user settings. It is not necessary that this username really exists in the system. The user variant can be copied through the transaction /DVD/MON_COPY_USRVAR from an existing user to a non-existing user and this non-existing username is used for the default variant replication.

In Dependent configuration each value of the properties mentioned above can be set for a specific System ID or a Profile or a combination of both. In the case there are present several rows with the same System ID or Profile, the Property value is loaded according to the following rules:

  1. Property values with a specified System ID and Profile (both fields are not empty) have the highest priority.
  2. Property values with only specified System ID (Profile field is empty) have a medium priority.
  3. Property values with specified Profile (System ID field is empty) have the lowest priority.  


Configuration property setup for specific SID / Profile


Example:

The configuration property AGENT_MAX_RUNTIME has the default value of 600 seconds (After this time limit the BG job will be aborted).
The first row sets the value for each collector job with the profile DEF_1MIN for each system except the NSD system (higher priority has the second row as it has the same profile and adds the specified System ID "NSD").
The second row overrides the value for the system NSD and the profile DEF_1MIN, it also overrides the property value of the first row for the profile DEF_1MIN.
The third row overrides the value for each collector job executed for the system NSD and any profile of the system except the profile DEF_1MIN, which is defined in the second row. The third row overrides as well the fourth row, as a property value with a specified System ID has higher priority than a property value with a specified Profile only.
The fourth row overrides the default value for each collector job with the profile DEF_5MIN and on every system except the NSD system, as the third row has a specified System ID and therefore has a higher priority.