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:
|
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:
|
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:
|
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. |
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 Platform and Hardware Monitoring Alert
Use this alert to monitor hardware components, such as data drives, power supply, Fan, NIC (network interfaces) and the HyperScale nodes. The alert rule is also used to monitor the HyperScale platform health, such as Commvault Distributed Services (CDS) services, Ransomware protection, system mount point and data drive consumption, and commit log partition consumption.
User Permissions |
Associated Entities |
Criteria |
Description |
Administrative Management |
CommCells |
MediaAgents |
Alert rule to monitor platform/hardware issues on Hyperscale Reference Architecture and Hyperscale appliance 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:
|
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 File System (CVFS) services in the HyperScale cluster nodes. CVFS 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. |
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:
|
Client Groups Filter |
The client group to monitor for data protection jobs in the following statuses:
|
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. |
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. |
Notify Offline Backup Nodes
Use this alert to monitor offline backup nodes such as client computer and client computer group.
User Permissions |
Associated Entities |
Criteria |
Description |
---|---|---|---|
Administrative Management |
Client computer and client computer group |
Client services are stopped or unreachable. |
The Commvault software monitors the backup nodes and sends an alert to MSP and tenant administrators when a backup node is offline. |
To see the tokens available for this alert, see Alerts and Notifications - Tokens.