(DI-2002) Configuration of Properties

Owned by SNP
Jan 28, 2020
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

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 to use KILL WP for long-running Collector BG jobs
Allows to use the OS level function "KILL Work-Process" to terminate 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 execution of Collector BG jobs 
Sets BG job priority class for execution of Collector BG jobs. There are three priority classes used: 'C'-lowest priority, 'B'-medium priority, 'A'-highest priority. 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 execution of Collector BG jobs
Sets the user ID which is used for 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 Collector BG job is used. In the case that the user ID is not valid, the system displays the following error message "Can not start 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. Insights is able to detect these failures and display them by marking the particular line with a red icon in the 'Collector jobs' tab in Insights Monitor. Also the 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. Retention date for all collected data is calculated based on retention time (in days) which you set in Collector BG jobs' definition. This cleanup job is scheduled and executed only once per day (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 which has it's 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 which fulfills the retention period. 
Starting time of clean up
Specifies the starting time of the BG job to cleanup 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 Datavard Storage Management
This setup allows to store monitoring results in a different (external) transparent storage with the help of Datavard Storage Management (DVD 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
Insights 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 which 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 Insights 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, error message is written to log).
E-mail address used for sender of notification
E-mail address which is used as a sender in notification emails. Default value is do_not_reply@datavard.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 
User has an opportunity to suppress the calculation of 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 user in 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 parameter is set to 'Y', the pop-up is displayed and the Insights 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 Insights cockpit or when a user resets the user settings. It is not necessary that this username really exists on 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 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 additionally 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 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 then 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.