Monitoring Amazon DataSync events by using Amazon EventBridge
Amazon EventBridge events describe changes in DataSync resources. You can set up rules to match these events and route them to one or more target functions or streams. Events are emitted on a best-effort basis.
DataSync transfer events
The following EventBridge events are available for DataSync transfers.
| Agent state changes | |
|---|---|
| Event | Description |
| Online | The agent is configured properly and is available to use. This status is the normal running status for an agent. |
| Offline | The agent's VM is turned off or the agent is in an unhealthy state and has been out of contact with the service for 5 minutes or longer. When the issue that caused the unhealthy state is resolved, the agent returns to ONLINE status. |
| Location state changes | |
| Event | Description |
| Adding | DataSync is adding a location. |
| Available | The location is created and is available to use. |
| Task state changes | |
| Event | Description |
| Available | The task was created and is ready to start. |
| Running | The task is in progress and functioning properly. |
| Unavailable | The task isn't configured properly and can't be used. You may see this when an agent associated with the task goes offline. |
| Queued | Another task is running and using the same agent. DataSync runs tasks in series (first in, first out). |
| Task execution state changes | |
| Event | Description |
| Queueing | DataSync is waiting for another task that's using the same agent to finish. |
| Launching | DataSync is initializing the task execution. |
| Preparing | DataSync is determining which files need to be transferred. |
| Transferring | DataSync is performing the actual transfer of your data. |
| Verifying | DataSync performs a full data and metadata integrity verification to ensure that the data in your destination is an exact copy of your source. |
| Success | The transfer is successful. |
| Error | The transfer failed. |
DataSync Discovery events
The following EventBridge events are available for DataSync Discovery.
| Storage system state changes | |
|---|---|
| Event | Description |
| Storage System Connectivity Status Change | The connection between your DataSync agent and on-premises storage system changed. For details, see your CloudWatch logs. |
| Discovery job state changes | |
| Event | Description |
| Discovery Job State Change | The status of your discovery job changed. For more information, see discovery job statuses. |
| Discovery Job Expiration Soon | Your discovery job expires soon. This includes any information the discovery job collected about your on-premises storage system. Before the job expires, you can export collected data by using the DescribeStorageSystemResources and DescribeStorageSystemResourceMetrics operations. |