All Products
Search
Document Center

IoT Platform:Message playback

Last Updated:Oct 16, 2024

The Message Playback feature enables the resending of device communication messages that have been recorded and stored by the IoT Platform, facilitating the simulation of actual device operations. It supports the replay of historical data sent by devices to the IoT Platform as well as data dispatched from the IoT Platform to devices, which is essential for product development, testing, and message resending following anomalies. This topic outlines the message types that are compatible with Message Playback and the steps to execute a playback task.

Supported message types for playback

  • Messages from Devices to the IoT Platform

    • AMQP server-side subscription consumer group: Replay messages from devices as routed by the specified consumer group.

    • Data forwarding (new version): Replay device messages as per the specified message forwarding resolver.

  • Messages from the IoT Platform to Devices

    Replay messages sent either by the business server via the IoT Platform or directly by the IoT Platform to all devices or a specific device under the chosen product.

Limits

  • The Message Playback feature is exclusive to Enterprise Edition instances.

  • IoT Platform messages with Quality of Service (QoS) 0 are retained for 1 day, and QoS 1 messages for 7 days. Playback requires data within this retention period.

  • For AMQP server-side subscription consumer group message playback, the client associated with the consumer group must be online.

  • For data forwarding message playback, the corresponding data forwarding rule or message forwarding resolver must be active.

  • Message replay consumes the enterprise edition instance's message upstream and downstream TPS or message forward TPS resources based on the volume of device messages. However, the consumption by message replay will not exceed 50% of the available message upstream and downstream TPS or message forward TPS resources.

Create a message playback task

  1. Log on to the IoT Platform console.

  2. On the Instance Overview page, select the desired environment, locate the relevant instance, and click on the instance ID or its remark name.

  3. In the left navigation bar, click Monitoring > > Simple Log Service.

  4. Select a product and click the Message Playback tab.

  5. Click Create Playback Task.

  6. Follow the on-screen instructions to select the Playback Period and Message Type For Playback.

  7. Click Confirm.

    The initial Status of the message playback task is Creating. Once created, the task Status will change to Not Started.

Start a message playback task

To initiate message playback, you must start the task.

  1. In the task list, following the creation of a message playback task, click the Operation column for the task in question and select Start.

  2. Click Confirm.

    Upon successful start of the message playback task, the task status will update to Started. Once the message playback is complete, the status will change to Completed.

View replayed messages

After the message playback task status updates to Completed, you can review the replayed messages of the corresponding type on the IoT Platform Logs tab. For more information, see IoT Platform logs.

Other operations

  • For tasks that have been initiated but not yet completed, you can pause the message playback by clicking Operation in the task's row and selecting Stop, followed by Confirm.

  • To delete a message playback task that has been stopped or completed, click Operation in the task's row and select Delete, then Confirm.