Custom Rules

The following sections list the alert types available under the Custom Rules category along with important details such as:

User permissions needed to use the alert
CommCell entities that can be associated with the alert
Criteria that trigger the alert
Available alert tokens

You can create new alert types for the Custom Rules category. For information see Creating an Alert Rule. Alert types for the Custom Rules category are also available in the Commvault Store. For information, see Installing Alert Rules from the Commvault Store.

Activities Disabled at CommCell Alert

Use this alert to monitor when activities, such as scheduling, backup, and auxiliary copy, are disabled at the CommCell level.

User Permissions	Associated Entities	Criteria	Description
Administrative Management	CommCell	Disabled activity at CommCell level	The alert is sent when one or more activities are disabled at the CommCell level.

Auxiliary Copy Job Failed Continuously for N Attempts

Use this alert to monitor the success of auxiliary copy jobs for a storage policy.

User Permissions	Associated Entities	Criteria	Description
Administrative Management	CommCells	Number of failed jobs (n)	The alert is sent when more than a specific number of consecutive auxiliary copy jobs for a storage policy fail.

To see the tokens available for this alert, see Alerts and Notifications - Tokens.

Backup Exceeds X GB

Use this alert to monitor the size of the backup job running on a client.

User Permissions

Associated Entities

Criteria

Description

Administrative Management

CommCells

Threshold Size (GB)

The size of the backup job on a client exceeds the maximum defined size.

Filter

This alert checks all the currently running backup jobs that have exceeded the defined limit. The following filters can be applied to run the alert on specific jobs:

Job ID
User
Backed Up Size
Subclient

To see the tokens available for this alert, see Alerts and Notifications - Tokens.

Backup Job Scan Phase Exceeds Threshold

Use this alert to monitor jobs that remain in the scan phase longer than the specified threshold. Install this alert rule from the Commvault Store. See Installing Alert Rules from the Commvault Store.

User Permissions

Associated Entities

Criteria

Description

Administrative Management

CommCells

Scan phase threshold (in Minutes)

The scan phase for the job exceeds the maximum defined time limit.

Filter

This alert checks all the currently running jobs that have exceeded the defined time limit. The following filters can be applied to run the alert on specific jobs:

Job ID
User Name
Subclient Name

To see the tokens available for this alert, see Alerts and Notifications - Tokens.

CA Certificate Expired

Use this alert to monitor when CommCell certificates will expire. The alert reports all CA certificates that will expire after the user-defined threshold. Install this alert rule from the Commvault Store. See Installing Alert Rules from the Commvault Store.

User Permissions	Associated Entities	Criteria	Description
Administrative Management	CommCells	Threshold days for certificate expiry	The threshold for the number of days from expiration. For example, enter 125 to trigger an alert for all CA certificates that expire within the next 125 days.

To see the tokens available for this alert, see Alerts and Notifications - Tokens.

Clients Not Backed Up by Days

Use this alert to monitor clients that are not backed up in a specified number of days. The alert reports the client name and the number of days since the client was backed up. Install this alert rule from the Commvault Store. See Installing Alert Rules from the Commvault Store.

User Permissions	Associated Entities	Criteria	Description
Administrative Management	CommCells	Days since last backup	The number of days since the last backup. The minimum value is 1.
		Include Incremental Backups	This option includes incremental backups in the search for the last backup.
		Include Differential Backups	This option includes differential backups in the search for the last backup.
		Filters	The option to limit the subclients that should be considered.

To see the tokens available for this alert, see Alerts and Notifications - Tokens.

Client Group License Usage Check

Use this alert to monitor client computer groups that exceed the limit on the amount of data they can back up. The alert reports the client group name. For information on setting limits on client computer groups, see Setting a Licensing Limit for Tenants.

User Permissions	Associated Entities	Criteria	Description
Administrative Management	CommCells	Client Group	The client computer groups to monitor. The client computer groups must have a limit set. For information on setting limits on client computer groups, see Setting a Licensing Limit for Tenants.

To see the tokens available for this alert, see Alerts and Notifications - Tokens.

CommCell Scheduler Status

Use this alert to monitor when the scheduler is disabled for the number of hours defined in the alert. Install this alert rule from the Commvault Store. See Installing Alert Rules from the Commvault Store.

User Permissions	Associated Entities	Criteria	Description
Administrative Management	CommCells	Alert when scheduler is disabled for (hrs)	The number of hours the scheduler is disabled. Note This alert rule does not generate an alert if the Enable after a Delay option is used when the Enable Scheduler check box is cleared.

To see the tokens available for this alert, see Alerts and Notifications - Tokens.

CommServ Anomaly Digest

Use this alert to monitor the creation of

User Permissions

Associated Entities

Criteria

Description

Administrative Management

CommCells

Anomalous events

Anomalous jobs

SLA

Client Group

Storage Policy

This alert notifies the user about:

The client computer that may miss the SLA. The email alert contains the list of client computers, agent type of the client computer, name of the subclient, and reason for missing the SLA.
Runtime anomaly in jobs, when the runtime of the jobs is more than the system threshold.
Anomaly in events, when the frequency or occurrence of the events does not match the system threshold.

To see the tokens available for this alert, see Alerts and Notifications - Tokens.

No Data Aging In The Past X Days

Use this alert to monitor the periodic running of the data aging job. Install this alert from the Commvault Store. See Alerts and Notifications - Installing Alert Rules from Commvault Store.

User permissions	Associated entities	Criteria	Description
Administrative Management	CommCell	An unsuccessful or uninitiated data aging job. For information about data aging, see Data Aging - Overview.	The alert is sent when the data aging job is not initiated or fails to run. The number of days since the previous successful data aging job is displayed in the alert.

User permissions

Associated entities

Criteria

Description

Administrative Management

CommCell

An unsuccessful or uninitiated data aging job.

For information about data aging, see Data Aging - Overview.

The alert is sent when the data aging job is not initiated or fails to run.

The number of days since the previous successful data aging job is displayed in the alert.

Data Verification Failure Detected

Use this alert to monitor Data verification jobs. The alert reports the Library and Mount Path name (for disk and cloud libraries) and the associated Client, Agent, BackupSet and Subclient name associated with the chunk in which the error is encountered.

User Permissions	Associated Entities	Criteria	Description
Administrative Management	CommCells	Error in Data Verification job.	This alert is sent when a failure is detected by the Data Verification job.

To see the tokens available for this alert, see Alerts and Notifications - Tokens.

Data Aging is disabled for n days

Use this alert to monitor the client computers or the client computer groups for which data aging was disabled for a specified number of days. The alert reports the client computer name, the client computer group name and the number of days since the data aging was disabled. This alert is disabled by default. To enable the alert, see Managing Predefined Alerts.

User Permissions	Associated Entities	Criteria	Description
Administrative Management	CommCells	Days	The number of days since the data aging was disabled.
		Client Groups	The client computer groups to monitor for disabling of the data aging activity.
		Clients	The client computers to monitor for disabling of the data aging activity.
		Filters	The option to limit the client computers or the client computer groups that should be considered.

To see the tokens available for this alert, see Alerts and Notifications - Tokens.

DDB Disk Space Low

Use this alert to monitor when a deduplication database reaches free space thresholds. The alert reports the available free space, the free space warning threshold, and the minimum free space required. Install this alert rule from the Commvault Store. See Installing Alert Rules from the Commvault Store.

User Permissions	Associated Entities	Criteria	Description
Administrative Management	CommCells	MediaAgents	The deduplication databases on the selected MediaAgents are monitored for low disk space based on the free space thresholds set on the storage policy copy: Minimum Free Space (MB) and Free Space Warning (MB). For information on the free space thresholds, see Deduplication - DDB Information.

To see the tokens available for this alert, see Alerts and Notifications - Tokens.

HyperScale Hardware Monitoring Alert

Use this alert to monitor hardware and network failures on HyperScale nodes.

User Permissions	Associated Entities	Criteria	Description
Administrative Management	CommCells	MediaAgents	The alert is sent when hardware or network related failures are detected in the HyperScale nodes.

To see the tokens available for this alert, see Alerts and Notifications - Tokens.

Index Backup Status

Use this alert to monitor indexes that are not backed up within 30 days. The IndexBackup subclient on the MediaAgent is monitored.

User Permissions	Associated Entities	Criteria	Description
Administrative Management	CommCells	Filter	Set the backupstatus filter equal to 0.

To see the tokens available for this alert, see Alerts and Notifications - Tokens.

Index State

Use this alert to monitor whether errors occur during index backup operations.

User Permissions	Associated Entities	Criteria	Description
Administrative Management	CommCells	Filter	Set the errorstatus filter equal to 1.

To see the tokens available for this alert, see Alerts and Notifications - Tokens.

Job Run Time Anomaly

Use this alert to monitor the run time of backup jobs for a client computer group and send alert when the run time exceeds the system threshold runtime calculated based on the historical data of successful backup jobs collected using machine learning. The alert reports the job IDs and the reasons the jobs are taking more time to run. This alert helps the backup administrators to detect any anomaly in job execution.

Install this alert rule from the Commvault Store. See Installing Alert Rules from the Commvault Store.

User Capabilities	Associated Entities	Criteria	Description
Administrative Management	CommCells	Client Computer Group	You can select the client computer groups for which the system can monitor the run time. The system calculates the threshold run time for a client computer group based on the historical data of successful backup jobs collected using machine learning. For example, if the system calculated run time for a client computer group is 15 minutes, the system triggers an alert if the run time for a backup job exceeds 15 minutes.

To see the tokens available for this alert, see Alerts and Notifications - Tokens.

License Usage Alert

Use this alert to monitor when the percentage of permanent licenses consumed exceeds the specified threshold. The alert reports the permanent licenses that are issued and the permanent licenses that are consumed. Install this alert rule from the Commvault Store. See Installing Alert Rules from the Commvault Store.

User Permissions	Associated Entities	Criteria	Description
Administrative Management	CommCells	Threshold %	The threshold for the percentage of permanent licenses consumed. For example, enter 90 to trigger an alert if more than 90% of permanent licenses are consumed.

To see the tokens available for this alert, see Alerts and Notifications - Tokens.

Backup Gateway Offline

Use this alert to send notification about backup gateway node that are offline. Install this alert rule from the Commvault Store. See Installing Alert Rules from the Commvault Store.

Note

The MediaAgent that are disabled and marked offline for maintenance will not receive notifications.

User Permissions	Associated Entities	Criteria	Description
Administrative Management	CommCells	Offline threshold time (in minutes)	The threshold for the number of minutes backup gateway nodes that are offline.

To see the tokens available for this alert, see Alerts and Notifications - Tokens.

Non dedupe copy created recently

Use this alert to monitor the creation of storage policy copies without deduplication. The software sends the alert individually for each storage policy copy. Install this alert rule from the Commvault Store. See Installing Alert Rules from the Commvault Store.

User Permissions	Associated Entities	Criteria	Description
Administrative Management	CommCells	MediaAgents	The software monitors the creation of storage policy copies without deduplication and sends an alert when a copy without deduplication is created. For more information, see Optimize Storage Space Using Deduplication.

To see the tokens available for this alert, see Alerts and Notifications - Tokens.

No Media in Standalone Tape Drive

Use this alert to monitor whether any media has been loaded for the selected tape drive.

User Permissions

Associated Entities

Criteria

Description

Administrative Management

CommCells

Filter

The following filters can be applied to the jobs being monitored:

Drive Name
Library Name
MediaAgent Name

To see the tokens available for this alert, see Alerts and Notifications - Tokens.

Notify decommissioned Virtual Machines

Use this alert to receive a notification about offline virtual machines that will be deleted after thirty days.

Note

It is recommended to run pending auxiliary copy jobs for the decommissioned virtual machines.

User Permissions	Associated Entities	Criteria	Description
Administrative Management	Client computer	Decommissioned virtual machine	Notifications are sent to the MSP administrator with a list of offline virtual machines that are going to be deleted from the CommServe server after thirty days.

To see the tokens available for this alert, see Alerts and Notifications - Tokens.

Notify deconfigured Virtual Machines

Use this alert to receive a notification about virtual machines with backup data that are deleted from Virtual Server Agents.

Note

It is recommended to run pending auxiliary copy jobs for the deconfigured virtual machines.

User Permissions	Associated Entities	Criteria	Description
Administrative Management	Client computer	Deconfigured virtual machine	Notifications are sent to the MSP administrator about virtual machines with backup data that are deleted from Virtual Server Agents.

To see the tokens available for this alert, see Alerts and Notifications - Tokens.

Number of Jobs in Queued State Exceeds Threshold

Use this alert to monitor when the number of jobs in a queued state exceeds the specified threshold. The alert reports the number of jobs in the queue and the reasons the jobs are in the queue. Install this alert rule from the Commvault Store. See Installing Alert Rules from the Commvault Store.

User Permissions	Associated Entities	Criteria	Description
Administrative Management	CommCells	Threshold X	The threshold for the number of jobs in a queued state. For example, enter 10 to trigger an alert if more than 10 jobs are in a queued state.

To see the tokens available for this alert, see Alerts and Notifications - Tokens.

Restore or Admin Job Running for More than the Threshold Time

Use this alert to monitor when the running time for restore jobs or administrative jobs exceeds the specified threshold. The alert reports the job IDs and the reasons the jobs are delayed. Install this alert rule from the Commvault Store. See Installing Alert Rules from the Commvault Store.

User Permissions	Associated Entities	Criteria	Description
Administrative Management	CommCells	Threshold X	The threshold for the number of minutes restore jobs or administrative jobs should run. For example, enter 15 to trigger an alert if restore jobs or administrative jobs run for longer than 15 minutes.

To see the tokens available for this alert, see Alerts and Notifications - Tokens.

ScaleOutDiskHealthRule

Use this alert to monitor the health of drive(s) attached to an HyperScale storage pool and generate the alert when a drive failure is detected. Drive failures due to IO test failures, S.M.A.R.T Health issues, issue with unmount of a storage pool, issue with reduction in the size of a storage pool from its original size, and/or offline gluster daemons of bricks are detected. Install this alert rule from the Commvault Store. See Installing Alert Rules from the Commvault Store.

The software displays an alert in the CommCell Console and sends an email alert.

User Permissions	Associated Entities	Criteria	Description
Administrative Management	CommCells	MediaAgents	Monitor the health of Hyperscale drives attached to a MediaAgent, and generate the alert when a drive failure is detected due to IO test failures, S.M.A.R.T Health issues, and/or offline gluster daemons for bricks.
Administrative Management	CommCells	MediaAgents	Monitor the presence of HyperScale storage pools attached to a MediaAgent, and generate an alert when a storage pool is unmounted on a MediaAgent.
Administrative Management	CommCells	MediaAgents	Monitor the size of Hyperscale storage pools attached to a MediaAgent, and generate an alert when the size of a storage pool is less than its actual size.
Administrative Management	CommCells	MediaAgents	Monitor the Commvault Distributed Storage (CDS) services in the HyperScale cluster nodes. CDS centric services monitored are hedvighpod, hedvighblock, hedvigpages, and hedvigfsc. If any of these services are not running, then the ScaleOutDiskHealthRule alert is generated.

To see the tokens available for this alert, see Alerts and Notifications - Tokens.

SLA Health Check

Use this alert to monitor the status of backup operations.

User Permissions	Associated Entities	Criteria	Description
Administrative Management	CommCells	slaPercent	The percentage of clients that have been recently backed up.
Administrative Management	CommCells	LastNDays	The number of days since the backup job.

To see the tokens available for this alert, see Alerts and Notifications - Tokens.

Transaction log backup delayed alert

Use this alert to monitor database agent incremental data protection jobs that are delayed more than the specified number of minutes. This alert tracks jobs that are in a waiting state for 1 to 60 minutes. Install this alert rule from the Commvault Store. See Installing Alert Rules from the Commvault Store.

Important: Before using the Transaction log backup delayed alert alert, set up a separate alert where:

Category is Job Management
Type is Data Protection

Alert Criterion is Delayed by 1 Hrs

User Permissions	Associated Entities	Criteria	Description
Administrative Management	CommCells	Client Filter	The client to monitor for delayed incremental data protection jobs.
		Client Groups Filter	The client group to monitor for delayed incremental data protection jobs.
		Threshold delay time (In minutes)	An incremental data protection job was in a waiting state for the minutes specified. For example, enter 10 to trigger an alert if the job is waiting more than 10 minutes.

To see the tokens available for this alert, see Alerts and Notifications - Tokens.

Unsuccessful Backup Job for Database Agents

Use this alert to monitor database agent data protection jobs that have failed, have succeeded with with errors, or have been skipped. Install this alert rule from the Commvault Store. See Installing Alert Rules from the Commvault Store.

Note: The Repeat notification every check box is not supported for this alert.

User Permissions

Associated Entities

Criteria

Description

Administrative Management

CommCells

Client Filter

The client to monitor for data protection jobs in the following statuses:

failed
succeeded with errors
skipped

Client Groups Filter

The client group to monitor for data protection jobs in the following statuses:

failed
succeeded with errors
skipped

To see the tokens available for this alert, see Alerts and Notifications - Tokens.

Monitor Long Running TempDB Process

Use this alert to monitor processes that are running for a long time on the temporary database.

User Permissions	Associated Entities	Criteria	Description
Administrative Management	None	Query Threshold (In Minutes)	The threshold for the number of minutes a query must run on the temporary database to trigger the alert.

To see the tokens available for this alert, see Alerts and Notifications - Tokens.

Backup Job in Pending State Exceeds Threshold

Use this alert to monitor backup jobs that remain in a pending state for a long period of time.

User Permissions	Associated Entities	Criteria	Description
Administrative Management	None	Jobs in pending state (Threshold in Minutes)	The threshold for number of minutes a job is in pending state to trigger the alert.
		Filter Group	Add filters to include only jobs that match the filter criteria, including the job ID, the destination client, and backup set.

To see the tokens available for this alert, see Alerts and Notifications - Tokens.

Restore Job in Pending State Exceeds Threshold

Use this alert to monitor restore jobs that remain in a pending state for a long time.

User Permissions	Associated Entities	Criteria	Description
Administrative Management	None	Jobs in Pending State (Threshold in Minutes)	The threshold for the number of minutes a job just be in pending state to trigger the alert.
Administrative Management	None	Filter Group	Add filters to include only jobs that match the filter criteria, including job ID, the destination client, and backup set.

To see the tokens available for this alert, see Alerts and Notifications - Tokens.

Notify Offline Clients

Use this alert to receive a notification about client computers and client computer groups that are offline.

User Permissions	Associated Entities	Criteria	Description
Administrative Management	Client computer and client computer group	Client services are stopped or unreachable.	A notification is sent with a list of offline client computers and client computer groups.