Anomaly configuration file and settings

The anomaly detection configuration file provides the default settings that you can update and retain. The file contains a number of settings, such as disabling or enabling detection services, excluding a specific client or a policy during anomaly detection and so on.

The anomaly detection configuration file is based on the anomaly_config.conf.template.

Once the NetBackup master server or media server is upgraded or installed, the anomaly detection configuration file template is available at the following location:

On Windows: Install_Path\NetBackup\var\global\anomaly_detection

On UNIX: /usr/openv/var/global/anomaly_detection

Create a new file at the location same as the template, copy the contents of the template to the new file, and name the new file as anomaly_config.conf.

Caution:

Do not rename or copy the existing template file. Create a new file.

Anomaly configuration file settings

The following default configuration settings are provided in the anomaly_config.conf file that you can update.

Table: Default configuration settings for anomaly detection

Configuration setting	Options and their values
[ANOMALY_DETECTION_FUNCTIONALITY]	DISABLE_ENTIRE_DETECTION=0 (default) Set the option to 1 to disable anomaly detection by turning off all services that are required for anomaly detection, alerting, or data gathering. The DISABLE_DETECTION_SERVICE and DISABLE_ALERT_SERVICE options are ignored. Set the option to 0 to start one or more anomaly detection services.
	DISABLE_DETECTION_SERVICE=1 (default) Set the option to 1 to stop the detection service. Set the option to 0 to start the detection service.
	DISABLE_ALERT_SERVICE=1 (default) Set the option to 1 to stop the alert service. Set the option to 0 to start the alert service.
[ANOMALY_DETECTION_SENSITIVITY]	SENSITIVITY_PERCENTAGE=0 (default) Specifies the sensitivity of the anomaly detection mechanism. Positive percentage value reduces the number of anomaly alerts. The system is less sensitive to the deviations from the usual data. Negative percentage value increases the number of anomaly alerts. The system is more sensitive to the deviations from the usual data.
[DATABASE_SETTINGS]	PURGE_DATA_INTERVAL_IN_MONTHS=12 (default) Use this option to clean up the database after the specified number of months. The maximum number of months that you can set is 12.
[DATA_GATHER_SETTINGS]	LIVE_DATA_GATHER_FREQUENCY_IN_MIN=15 (default) Use this option to specify the frequency with which the data should be gathered for anomaly detection.

The following table lists the advanced configuration settings that are not available in the default configuration file. You have to manually create the sections and keys with appropriate values in the anomaly_config.conf file:

Table: Advanced configuration settings for anomaly detection


[EXCLUDE_CLIENTS]	CLIENT_NAME=client1 Use this option to disable anomaly detection for a given client. To specify multiple clients, use comma-separated format. For example: CLIENT_NAME=client1,client2,client3
[EXCLUDE_CLIENT_POLICY]	**Client_name_1=policy_1 Use this option to disable anomaly detection for a given backup policy that is associated with a given client. You can specify multiple clients and multiple policies that are associated with the respective clients. For example: client_name_1=policy_1,policy_2 client_name_2=policy_1,policy_2 client_name_3=policy_1,policy_2**
[DISABLE_FEATURE_PER_POLICY_TYPE]	Use this option to specify a policy type and a feature (or a NetBackup component or operation) for which you do not want to detect anomalies. For the list of NetBackup policy types, refer to the 'Policy type (policy attribute)' topic from the NetBackup Administrator's Guide Volume I. Features for which you can detect anomalies: IMAGE_SIZE (Backup image size) NUM_FILES (Number of backup files) DEDUP_RATE (Deduplication ratio) KB_TRANSFERRED (Data transferred) JOB_TIME (Job completion time) The machine learning (ML) model training for the specified policy and feature does not take place and anomalies are not detected for the specified policy and feature. For example: Oracle=NUM_FILES,TOTAL_TIME Disable ML model training for Oracle policy type and for number of files that are backed up. Backup anomalies specific to Oracle policy type are not detected. If there are any anomalies in case of number of files that are backed up or deduplication ratio, that are also not detected.
[DISABLE_POLICY_TYPE]	Use this option to specify the policy type for which you do not want to detect backup anomalies. For example: POLICY_TYPE=Oracle,Standard

Anomaly configuration file and settings

Feedback

Feedback