# 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.

#### Overdue Alert for Snapshot Deletion

Use this alert to monitor snapshots that are not pruned within the default threshold.

User Permissions | Associated Entities | Criteria | Description
--- | --- | --- | ---
Administrative Management | CommCells | Snapshot deletion overdue threshold | The alert is sent when snapshots are not pruned within the default threshold: 48 hours for On-Prem arrays and 24 hours for Cloud arrays.

#### 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.

#### 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

#### 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.

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

#### 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.

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.

#### 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.

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.

#### Server 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 server group name.

User Permissions | Associated Entities | Criteria | Description
Administrative Management | CommCells | Server Group | The client computer groups to monitor. The client computer groups must have a limit set.

#### CommCell Scheduler Status

Use this alert to monitor when the scheduler is disabled for the number of hours defined in the alert.

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.

#### CommServ Anomaly Digest

Use this alert to monitor the creation of anomaly on the CommServe computer.

User Permissions | Associated Entities | Criteria | Description
Administrative Management | CommCells | Anomalous events Anomalous jobs SLA Server 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.

#### No Data Aging In The Past X Days

Use this alert to monitor the periodic running of the data aging job.

User permissions | Associated entities | Criteria | Description
--- | --- | --- | ---
Administrative Management | CommCell | An unsuccessful or uninitiated data aging job. | 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.

#### 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.

User Permissions | Associated Entities | Criteria | Description
Administrative Management | CommCells | Days | The number of days since the data aging was disabled.
Server 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.

#### DDB Disk Space Low

Use this alert to monitor when a deduplication database reaches free space thresholds.

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).

#### 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.

#### 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.

#### 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.

#### 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.

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.

#### 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.

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.

#### Backup Gateway Offline

Use this alert to send notification about backup gateway node that are offline.

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.

#### 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.

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.

#### 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

#### 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.

#### 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.

#### 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.

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.

#### 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.

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.

#### 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.

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.

#### 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.

#### 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.

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.
  Server Groups Filter | The server 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.

#### Unsuccessful Backup Job for Database Agents

Use this alert to monitor database agent data protection jobs that have failed, have succeeded with errors, or have been skipped.

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
Server Groups Filter | The server group to monitor for data protection jobs in the following statuses: failed succeeded with errors skipped

#### 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.

#### 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.

#### 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.

#### 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.

×

Loading...