Set alert events using CloudMonitor - Data Transmission Service

Data Transmission Service (DTS) is integrated with CloudMonitor. You can use the event subscription feature of CloudMonitor to configure custom alert notifications for important events. This lets you be promptly notified of event occurrences and progress, which helps you quickly analyze and troubleshoot issues during business exceptions.

Background information

CloudMonitor is a service that monitors Internet applications and Alibaba Cloud resources. You can configure CloudMonitor to notify you of system anomalies. Then, you can automate the anomaly handling process based on alert notifications. CloudMonitor supports the following alert notification methods:

Sends alert notifications to you by using emails, text messages, or DingTalk chatbots.
Push events to Simple Message Queue (formerly MNS), Function Compute, Simple Log Service, or the specified callback URL. This allows you to automate the anomaly handling process based on your business requirements.

Prerequisites

ApsaraDB Fault or Maintenance Notifications is enabled and a contact is specified in the Message Center console. We recommend that you specify an O&M engineer as the contact.
Create alert contacts and alert contact groups. Then, add the alert contacts to the alert contact groups. For more information, see Create an alert contact or an alert contact group.

Create a subscription policy

Log on to the CloudMonitor console.
In the navigation pane on the left, choose Event Center > Event Subscription.
Note
If the Event Subscription page is not displayed, see Set alert rules for DTS tasks in the CloudMonitor console.
On the Subscription Policy tab, click Create Subscription Policy.
On the Create Subscription Policy page, set the parameters for the subscription policy.
- If you set Subscription Type to System Event, set Product to Data Transmission in the Subscription Scope section.
  Note
  For information about the system events that DTS supports, see System events.
- If you set Subscription Type to Threshold Event, search for Data Transmission Service in the Product Classification section and select an option as needed.
Configure other parameters as needed. For more information, see Subscription policy parameters.
After you complete the configuration, click Submit.
To view, modify, or delete subscribed CloudMonitor events, see Manage event subscriptions (Recommended).

Debug an event subscription

Log on to the CloudMonitor console.
In the navigation pane on the left, choose Event Center > Event Subscription.
Note
If the Event Subscription page is not displayed, see Set alert rules for DTS tasks in the CloudMonitor console.
On the Event Subscription page, click the Debug Event Subscription tab.
In the Create Event Debugging panel, configure the debug event.
1. Set Product to Data Transmission.
2. Select a Name as needed.
  Note
  Name is the NameDesc parameter of the system event.
  You cannot debug the Task Relocation Due To Underlying Hardware Upgrade series or the Instance Task Latency events.
  The system automatically generates the debug content in JSON format.
3. Modify the debug content as needed.
  For an example of how to modify the content, see Event content examples.
Click OK.
The Operation successful message appears. CloudMonitor automatically sends a test alert notification to the alert contacts based on the notification methods specified in the subscription policy.

Event content examples

Synchronization, migration, and tracking tasks

Parameter description

Parameter	Description	Example value
product	The cloud product to which the system event belongs (Product).	`DTS`
resourceId	The affected resource. Note The value starts with `acs:dts:` and can contain information such as the instance region, Alibaba Cloud account ID, and instance ID.	`acs:dts:cn-hangzhou:135218574272**:instance/dtsb1gx8vo2265**`
level	The level of the system event (Level). CRITICAL: critical. INFO: informational.	`INFO`
instanceName	The name of the affected instance. Format: `<Task ID>/<Instance Name>`.	`f1es8k10220****/testsync`
regionId	The region of the instance.	`cn-hangzhou`
name	The name of the system event (Name).	`sync_job_restore`
content	The content of the system event.	`testcontent`
msg	The content of the system event.	`testcontent`
status	The status of the system event (Status). failed: The task is abnormal. restore: The task has recovered.	`restore`

Examples

Name	Content example
Synchronization Task Abnormal	`{ "product": "DTS", "resourceId": "acs:dts:cn-hangzhou:135216572282**:instance/dtsb1gx8vo2265", "level": "CRITICAL", "instanceName": "f1es8k10220**/testsync", "regionId": "cn-hangzhou", "name": "sync_job_abnormal", "content": "testcontent", "status": "failed" }`
Synchronization Task Recovered	`{ "product": "DTS", "resourceId": "acs:dts:cn-hangzhou:135216572282**:instance/dtsb1gx8vo2265", "level": "INFO", "instanceName": "f1es8k10220**/testsync", "regionId": "cn-hangzhou", "name": "sync_job_restore", "content": "testcontent", "status": "restore" }`
Migration Task Abnormal	`{ "product": "DTS", "resourceId": "acs:dts:cn-hangzhou:135216572282**:instance/dtsb1ah8a7x259", "level": "CRITICAL", "instanceName": "q2rb8x0022p**/testmigrate", "regionId": "cn-hangzhou", "name": "migration_job_abnormal", "content": "testcontent", "status": "failed" }`
Migration Task Recovered	`{ "product": "DTS", "resourceId": "acs:dts:cn-hangzhou:135216572282**:instance/dtsb1ah8a7x259", "level": "INFO", "instanceName": "q2rb8x0022p**/testmigrate", "regionId": "cn-hangzhou", "name": "migration_job_restore", "content": "testcontent", "status": "restore" }`
Tracking Task Abnormal	`{ "product": "DTS", "resourceId": "acs:dts:cn-hangzhou:135216572282**:instance/dtsktuw8d7n252", "level": "CRITICAL", "instanceName": "qgkm8okq25q**/testsubscribe", "regionId": "cn-hangzhou", "name": "subscribe_job_abnormal", "content": "testcontent", "status": "failed" }`
Tracking Task Recovered	`{ "product": "DTS", "resourceId": "acs:dts:cn-hangzhou:135216572282**:instance/dtsktuw8d7n252", "level": "INFO", "instanceName": "qgkm8okq25q**/testsubscribe", "regionId": "cn-hangzhou", "name": "subscribe_job_restore", "content": { "msg": "testcontent" }, "status": "restore" }`

Instance tasks

Parameter description

Parameter	Description	Example value
product	The cloud product to which the system event belongs (Product).	`DTS`
resourceId	The affected resource. Note The value starts with `acs:dts:` and can contain information such as the instance region, Alibaba Cloud account ID, and instance ID.	`acs:dts:cn-hangzhou:135218574272**:instance/dtsb1gx8vo2265**`
level	The level of the system event (Level). Note The level for instance task exceptions is always WARN (warning).	`WARN`
instanceName	The name of the affected instance. Format: `<Task ID>/<Instance Name>`.	`f1es8k10220****/testsync`
regionId	The region of the instance.	`cn-hangzhou`
name	The name of the system event (Name).	`Instance:JobStatus.Abnormal:Executing`
content	The content of the system event.	`testcontent`
eventId	The ID of the system event.	`37d28e238b151a0d44dfdf1f2153****`
publishTime	The time when the system event was published. The time is in UTC.	`2025-08-26T14:40:05+08:00`
reason	The reason why the system event was triggered.	`testreason`
product	The cloud product to which the event belongs.	`dts`
instanceComment	The ID of the affected instance.	`dtsb1gx8vo2265****`
instanceId	The ID of the affected instance.	`dtsb1gx8vo2265****`
extra	The extra information about the content of the system event.	`testextra`
eventTime	The start time of the system event. The time is in UTC.	`2025-08-26T14:38:17+08:00`
cloudEvent	The information about the CloudMonitor event.	`****`
data	The data overview of the system event.	`****`
gmtModified	The update time. The time is in UTC.	`2025-08-26T06:39:56Z`
eventCategory	The categorization of the event (EventType). Note The categorization for instance task exceptions is always Exception.	`Exception`
gmtCreated	The time when the event was created. The time is in UTC.	`2025-08-26T06:39:37Z`
detailReason	The detailed reason why the event was triggered.	`****`
uid	The Alibaba Cloud account ID.	`135216572282****`
cmsProduct	The cloud product to which the event belongs.	`DTS`
instanceId	The ID of the affected instance.	`dtsb1gx8vo2265****`
eventLevel	The level of the event (Level). Note The level for instance task exceptions is always WARN (warning).	`WARN`
handleStatus	The processing status of the event.	`None`
startTime	The start time of the event. The time is in UTC.	`2025-08-26T06:38:17Z`
detailImpact	The pagination parameter.	`-`
eventId	The ID of the event.	`e-0mqwjyhomzrb32****`
product	The cloud product to which the event belongs.	`dts`
dbType	The cloud product to which the event belongs.	`dts`
hasLifeCycle	Indicates whether the event has a lifecycle. 0: no lifecycle. 1: has a lifecycle.	`0`
eventType	The type of the event.	`JobStatus`
eventReason	The source of the event.	`JobStatus.Abnormal`
eventImpact	The impact of the event.	`Abnormal`
mainEventId	The ID of the main event.	`e-0mqwjyhomzrb3i****`
eventCode	The code of the event, which is the value of Name.	`Instance:JobStatus.Abnormal:Executing`
isClosed	Indicates whether the event is closed. 0: closed. 1: open.	`1`
regionId	The region of the instance.	`cn-hangzhou`
sourceType	The type of the source data.	`DBaaS`
eventStatus	The status of the system event (Status). Executing: The task is abnormal. Executed: The task has recovered.	`Executed`
endTime	The end time of the event.	`2025-08-26T06:38:17Z`
eventDetail	The details of the event. The details include the task type (dts_task_type), task ID (dts_job_id), task status (job_state), error code (err_code), and detailed information about the task exception (err_msg_detail and message).	`****`
resourceType	The resource type. Instance: instance resource. Host: host resource. User: user resource.	`Instance`
subject	The affected resource. Note The value starts with `acs:dts:` and can contain information such as the instance region, Alibaba Cloud account ID, and instance ID.	`acs:dts:cn-hangzhou:135218574272**:instance/dtsb1gx8vo2265**`
specversion	The CloudEvents protocol version.	`1.0`
time	The time when the event was created. The time is in UTC.	`2025-08-26T06:39:37Z`
source	The source of the event.	`acs:dts:dts`
id	The ID of the event.	`e-0mqwjyhomzrb32****`
region	The region of the instance.	`cn-hangzhou`
type	The type of the event.	`Instance:JobStatus.Abnormal`
region	The region of the instance.	`cn-hangzhou`
instanceType	The resource type. Instance: instance resource. Host: host resource. User: user resource.	`Instance`
eventType	The categorization of the event.	`Exception`
status	The status of the system event (Status). Executing: The task is abnormal. Executed: The task has recovered.	`Executed`

Examples

Name

Content example

Instance Task Exception Recovered

{
    "product": "DTS",
    "resourceId": "dts:cn-hangzhou:135216572282****:instance/dtsb1gx8vo2265****",
    "level": "WARN",
    "instanceName": "f1es8k10220****/testsync",
    "regionId": "cn-hangzhou",
    "name": "Instance:JobStatus.Abnormal:Executed",
    "content": {
        "eventId": "b9b***3ae",
        "publishTime": "2025-08-26T04:59:37+08:00",
        "reason": "testreason",
        "product": "dts",
        "instanceComment": "dts***65u",
        "instanceId": "dts***65u",
        "extra": {
            "eventTime": "2025-08-26T04:21:37+08:00",
            "cloudEvent": {
                "data": {
                    "gmtModified": "202***32Z",
                    "eventCategory": "Ex***on",
                    "gmtCreated": "202***32Z",
                    "detailReason": "***",
                    "uid": "113***735",
                    "cmsProduct": "***",
                    "instanceId": "dts***65u",
                    "eventLevel": "WA***",
                    "handleStatus": "No***",
                    "startTime": "2025-08-25T20:21:37Z",
                    "detailImpact": "***",
                    "eventId": "e-0***iue",
                    "product": "***",
                    "dbType": "***",
                    "hasLifeCycle": 123456,
                    "eventType": "Jo***us",
                    "eventReason": "Job***mal",
                    "eventImpact": "Ab***al",
                    "mainEventId": "e-0***gd8",
                    "eventCode": "Ins***ted",
                    "isClosed": 123456,
                    "regionId": "cn***ng",
                    "sourceType": "DB***",
                    "eventStatus": "Ex***ed",
                    "endTime": "2025-08-25T20:21:37Z",
                    "eventDetail": "****",
                    "resourceType": "In***ce"
                },
                "subject": "acs***nce/dts***65u",
                "specversion": "***",
                "time": "2025-08-25T20:59:32Z",
                "source": "acs***dts",
                "id": "e-0***iue",
                "region": "cn***ng",
                "type": "Ins***mal"
            },
            "region": "cn-hangzhou"
        },
        "instanceType": "In***ce",
        "eventType": "Ex***on"
    },
    "status": "Executed"
}

Instance Task Exception Started

{
    "product": "DTS",
    "resourceId": "dts:cn-hangzhou:135216572282****:instance/dtsb1gx8vo2265****",
    "level": "WARN",
    "instanceName": "f1es8k10220****/testsync",
    "regionId": "cn-hangzhou",
    "name": "Instance:JobStatus.Abnormal:Executing",
    "content": {
        "eventId": "f88***4b3",
        "publishTime": "2025-08-26T05:03:38+08:00",
        "reason": "testreason",
        "product": "***",
        "instanceComment": "dts***b9n",
        "instanceId": "dts***b9n",
        "extra": {
            "eventTime": "2025-08-26T05:02:13+08:00",
            "cloudEvent": {
                "data": {
                    "gmtModified": "202***25Z",
                    "eventCategory": "Ex***on",
                    "gmtCreated": "202***25Z",
                    "detailReason": "***",
                    "uid": "125***870",
                    "cmsProduct": "***",
                    "instanceId": "dts***b9n",
                    "eventLevel": "WA***",
                    "handleStatus": "No***",
                    "startTime": "2025-08-25T21:02:13Z",
                    "detailImpact": "***",
                    "eventId": "e-0***ypw",
                    "product": "***",
                    "dbType": "***",
                    "hasLifeCycle": 123456,
                    "eventType": "Jo***us",
                    "eventReason": "Job***mal",
                    "eventImpact": "Ab***al",
                    "mainEventId": "e-0***cua",
                    "eventCode": "Ins***ing",
                    "isClosed": 123456,
                    "regionId": "cn-***hou",
                    "sourceType": "DB***",
                    "eventStatus": "Ex***ng",
                    "endTime": "2025-08-25T21:02:13Z",
                    "eventDetail": "****",
                    "resourceType": "In***ce"
                },
                "subject": "acs***nce/dts***b9n",
                "specversion": "***",
                "time": "2025-08-25T21:03:25Z",
                "source": "acs***dts",
                "id": "e-0***ypw",
                "region": "cn-***hou",
                "type": "Ins***mal"
            },
            "region": "cn-hangzhou"
        },
        "instanceType": "In***ce",
        "eventType": "Ex***on"
    },
    "status": "Executing"
}

Task relocation due to underlying hardware upgrade

Parameter description

Parameter	Description	Example value
product	The cloud product to which the system event belongs (Product).	`DTS`
userId	The Alibaba Cloud account ID.	`135216572282****`
level	The level of the system event (Level). CRITICAL: critical. INFO: informational.	`INFO`
resourceId	The affected resource. Note The value starts with `acs:dts:` and can contain information such as the instance region, Alibaba Cloud account ID, and instance ID.	`acs:dts:cn-hangzhou:135216572282**:instance/dtsmq5j38bn28n**`
instanceName	The name of the affected instance. Format: `<Instance ID>/<Instance Name>`.	`dtsmq5j38bn28n****/test`
dryRun	Indicates whether to perform only a preflight request. true: Sends a preflight request. false: Sends a normal request.	`false`
ver	The CloudEvents protocol version.	`1.0`
trace	The request ID.	`54ee8594-5ec4-408a-93ce-c8fbb433****`
name	The name of the system event (Name).	`Instance:SystemMaintenance.Shift:Executed`
regionId	The region of the instance.	`cn-hangzhou`
status	The status of the system event (Status). Scheduled: The task is scheduled. Executing: The task is in progress. Executed: The task is completed. Failed: The task failed. Canceled: The task is canceled. ToDealt: The task is pending customer action.	`Executed`
time	The time when the system event was generated.	`Aug 22, 2025 5:39:51 PM`
content	The content of the system event. Note The content can include information such as the task or instance name (jobName), the estimated running time of the system event (innerScheduleTime), the instance ID (instanceId), and the instance region (region).	`testcontent`

Examples

Name	Content example
Task Relocation Due To Underlying Hardware Upgrade (Scheduled)	`{ "product": "DTS", "userId": "135216572282**", "level": "CRITICAL", "resourceId": "acs:dts:cn-hangzhou:135216572282:instance/dtsmq5j38bn28n", "instanceName": "dtsmq5j38bn28n/testinstance", "dryRun": false, "ver": "1.0", "trace": "54ee8594-5ec4-408a-93ce-c8fbb433**", "name": "Instance:SystemMaintenance.Shift:Scheduled", "regionId": "cn-hangzhou", "status": "Scheduled", "time": "Aug 22, 2025 5:39:51 PM", "content": "testcontent" }`
Task Relocation Due To Underlying Hardware Upgrade (Executing)	`{ "product": "DTS", "userId": "135216572282**", "level": "INFO", "resourceId": "acs:dts:cn-hangzhou:135216572282:instance/dtsmq5j38bn28n", "instanceName": "dtsmq5j38bn28n/testinstance", "dryRun": false, "ver": "1.0", "trace": "55ee8594-5ec4-408a-93ce-c8fac56**", "name": "Instance:SystemMaintenance.Shift:Executing", "regionId": "cn-hangzhou", "status": "Executing", "time": "Aug 22, 2025 5:39:51 PM", "content": "testcontent" }`
Task Relocation Due To Underlying Hardware Upgrade (Completed)	`{ "product": "DTS", "userId": "135216572282**", "level": "INFO", "resourceId": "acs:dts:cn-hangzhou:135216572282:instance/dtsmq5j38bn28n", "instanceName": "dtsmq5j38bn28n/testinstance", "dryRun": false, "ver": "1.0", "trace": "56ee8594-5ec4-408a-93ce-c8fbac58**", "name": "Instance:SystemMaintenance.Shift:Executed", "regionId": "cn-hangzhou", "status": "Executed", "time": "Aug 22, 2025 5:39:51 PM", "content": "testcontent" }`
Task Relocation Due To Underlying Hardware Upgrade (Failed)	`{ "product": "DTS", "userId": "135216572282**", "level": "CRITICAL", "resourceId": "acs:dts:cn-hangzhou:135216572282:instance/dtsmq5j38bn28n", "instanceName": "dtsmq5j38bn28n/testinstance", "dryRun": false, "ver": "1.0", "trace": "57ee8594-5ec4-408a-93ce-c8fac59**", "name": "Instance:SystemMaintenance.Shift:Failed", "regionId": "cn-hangzhou", "status": "Failed", "time": "Aug 22, 2025 5:39:51 PM", "content": "testcontent" }`
Task Relocation Due To Underlying Hardware Upgrade (Canceled)	`{ "product": "DTS", "userId": "135216572282**", "level": "INFO", "resourceId": "acs:dts:cn-hangzhou:135216572282:instance/dtsmq5j38bn28n", "instanceName": "dtsmq5j38bn28n/testinstance", "dryRun": false, "ver": "1.0", "trace": "54ee8594-5ec4-408a-93ce-c8fbb433**", "name": "IInstance:SystemMaintenance.Shift:Canceled", "regionId": "cn-hangzhou", "status": "Canceled", "time": "Aug 22, 2025 5:39:51 PM", "content": "testcontent" }`
Task Relocation Due To Underlying Hardware Upgrade (Pending Customer Action)	`{ "product": "DTS", "userId": "135216572282**", "level": "CRITICAL", "resourceId": "acs:dts:cn-hangzhou:135216572282:instance/dtsmq5j38bn28n", "instanceName": "dtsmq5j38bn28n/testinstance", "dryRun": false, "ver": "1.0", "trace": "54ee8594-5ec4-408a-93ce-c8fbb433**", "name": "Instance:SystemMaintenance.Shift:ToDealt", "regionId": "cn-hangzhou", "status": "ToDealt", "time": "Aug 22, 2025 5:39:51 PM", "content": "testcontent" }`