# Monitoring Item Specification

This document describes the specific definitions and scope of "Event" and "Metric" monitoring items available when configuring monitoring rules.

## Event-Based Monitoring

| Event Name               | Target Objects                                                           | Scope Description                                                                                      |
| ------------------ | -------------------------------------------------------------- | ----------------------------------------------------------------------------------------- |
| Scheduled Task Instance Run Failure         | Includes: Periodically scheduled task instances, backfill task instances, and manual reruns of scheduled instances. Excludes: Manually run temporary instances, real-time sync task instances. | An alert event is generated when a scheduled task instance fails due to various reasons (code logic errors, timeout, system exceptions, etc.). If the scheduled task is configured with automatic retry on error, no alert events are generated during the automatic retry process; only one alert is generated upon final failure. |
| Scheduled Task Instance Completion Time       | Includes: Periodically scheduled task instances, manually rerun scheduled task instances, etc. Excludes: Manually run temporary instances, backfill task instances.     | An alert event is generated when the completion time of a scheduled task exceeds the expected time point (does not finish running by the specified time).                                                  |
| Scheduled Task Instance Scheduling Duration (Including Wait Time)  | Includes: Periodically scheduled task instances. Excludes: Manually run temporary instances, backfill task instances, manually rerun scheduled task instances, etc.     | An alert event is generated when the total duration from the planned time to the end time of a scheduled task instance exceeds the threshold. This includes the time the task instance waits for upstream tasks to complete.              |
| Scheduled Task Run Time Delay         | Includes: Periodically scheduled task instances. Excludes: Manually run temporary instances, backfill task instances, manually rerun scheduled task instances, etc.     | An alert event is generated when the actual start time of a scheduled task instance (when it enters running state) is delayed beyond the threshold compared to the planned time.                                         |
| Task Instance Execution Duration (Excluding Wait Time)   | All task instances. Includes periodically scheduled task instances, manually run temporary instances, backfill task instances, manually rerun scheduled task instances, etc.   | An alert event is generated when the pure execution time of the instance (excluding the time waiting for upstream completion) exceeds the threshold.                                                      |
| Dynamic Table Refresh Timeout            | Dynamic Tables                                             | An alert event is generated when a dynamic table refresh operation exceeds the set timeout period.                                                                  |
| Streaming SQL Task Execution Failure        | Streaming SQL (Continuous Job) tasks                                        | An alert event is generated when the running status of a streaming SQL task changes from "Running" to "Failed".                                                        |
| Quality Rule Validation Failure           | Quality Rules + Target Table: Select tables configured with quality rules. When a rule validation fails on that table, an alert history is generated.                    | An alert event is generated when the execution result of a data quality validation rule is "Failed".                                                                |
| Quality Rule Validation Timeout           | Quality Rules                                                           | An alert event is generated when the execution result of a data quality validation rule is "Timeout".                                                                |
| Multi-Table Real-Time Sync Task Run Failure       | Multi-table real-time sync tasks                                                       | An alert event is generated when the status of a multi-table real-time sync task changes from "Running" to "Failed".                                                         |
| Multi-Table Real-Time Sync Task Table Enters Blacklist      | Multi-table real-time sync tasks                                                       | An alert event is generated when a table in the task is added to the blacklist due to consecutive sync failures.                                                              |
| Multi-Table Real-Time Sync Task Single Table Full Data Sync Exception | Multi-table real-time sync tasks                                                       | An alert event is generated when an exception occurs during the full data synchronization of a single table in a multi-table real-time sync task.                                                         |
| Multi-Table Real-Time Sync Task Single Table Incremental Data Sync Exception | Multi-table real-time sync tasks                                                       | An alert event is generated when an exception occurs during the incremental data synchronization of a single table in a multi-table real-time sync task.                                                         |
| Full & Incremental Integrated Sync Single Table Full Data Sync Exception  | Full & incremental integrated sync tasks                                                      | An alert event is generated when an exception occurs during the full data synchronization of a single table in a full & incremental integrated sync task.                                                        |
| Full & Incremental Integrated Sync Single Table Incremental Data Sync Exception  | Full & incremental integrated sync tasks                                                      | An alert event is generated when an exception occurs during the incremental data synchronization of a single table in a full & incremental integrated sync task.                                                        |
| Full & Incremental Integrated Sync Task Run Failure      | Full & incremental integrated sync tasks                                                      | An alert event is generated when the status of a full & incremental integrated sync task changes from "Running" to "Failed".                                                        |
| Full & Incremental Integrated Sync Task Target Table Schema Change Failure | Full & incremental integrated sync tasks                                                      | An alert event is generated when automatic schema evolution of the target table encounters an error.                                                 |

## Metric-Based Monitoring

| Metric Name               | Target Objects        | Scope Description                                                         |
| ------------------ | ----------- | ------------------------------------------------------------ |
| Dynamic Table Refresh Failure            | Dynamic Tables         | Number of dynamic table refresh operation failures.                                                  |
| Full & Incremental Integrated Sync Task Delay        | Full & incremental integrated real-time sync tasks | Time delay of data synchronization.                                                    |
| Full & Incremental Integrated Sync Task Single Table Sync Failure    | Full & incremental integrated real-time sync tasks | Statistics on single table synchronization failure count.                                                   |
| Multi-Table Real-Time Sync Task Delay         | Multi-table real-time sync tasks    | Overall delay of multi-table real-time synchronization.                                                  |
| Multi-Table Real-Time Sync Task Job Failover | Multi-table real-time sync tasks    | Number of failover occurrences in multi-table sync tasks.                                               |
| Multi-Table Real-Time Sync Task Read Position Delay     | Multi-table real-time sync tasks    | Delay of data read position relative to the source.                                               |
| Multi-Table Real-Time Sync Task Source Database Read Delay  | Multi-table real-time sync tasks    | Difference between source database data generation rate and synchronization rate.                                           |
| Multi-Table Real-Time Sync Task Data Sync Status Exception   | Multi-table real-time sync tasks    | Monitoring of abnormal conditions in data synchronization status.                                                |
| Queued Jobs Count              | Single SQL Job     | Sampled every 5 seconds. Counts all SQL jobs whose status is "queued" at each sampling point.                               |
| Average Job Queue Time           | Single SQL Job     | Sampled every 5 seconds. Calculates the TP90 job queue time within each 5-second window.                                    |
| General-Purpose / Integration Vcluster Load      | VCluster        | At each sampling point, computes the ratio of compute resources currently processing tasks to the maximum compute resources supported by that vcluster size.                 |
| Analytics Vcluster Load          | VCluster        | At each sampling point, computes the ratio of current job concurrency to the vcluster's maximum supported concurrency (calculated as max replicas x max concurrency per replica). |

^
