Create a task

Prerequisites

Procedure

1. In the navigation pane on the left, choose Remote Log Access > Task List to open the Task List page.

2. Click Create Task to open the Create Task page.

3. On the Create Task page, select a pull mode: Pull by device or Pull by condition.

4. Configure the following parameters.

   Option	Description
   Pull mode	Specifies the pull method for tasks. [Value range] Pull by device: Targeted retrieval. Sends instructions to known devices that have been online before. This is used to troubleshoot issues on specific existing devices. Pull by condition: Pre-sets filter rules and listens for device online events. This captures logs in real time from devices (including new ones) that meet the conditions. Note This feature is only supported by the new software development kit (SDK). For iOS, you must integrate the new version of AlicloudApmAll (2.1.8 or later). The new Remote Log Access is provided as a subspec and must be explicitly imported as needed. For Android, only alicloud-apm SDK versions 2.6.0 or later are supported.
   Task name	Sets the name of the task. [Default value] Task_{Current time (YYYYMMDDhhmmss)} [Value range] Up to 64 characters [Character type] Uppercase and lowercase English letters, Chinese characters, numbers, and special characters
   Online period	Retrieves devices from which logs can be pulled within the specified time.

5. In the Pull devices section, configure the devices from which to pull logs based on the selected pull mode.

   1. Pull by device mode:

      Pull by # ID.

      Option	Description
      Device ID/Name	Enter a keyword to perform a fuzzy match for the ID or name of the device. This filters for devices that meet the criteria.
      Application version/ OS version/Region/ Brand/Model/ Last online time	Sets the filter conditions for pulling devices. Logs are pulled only from devices that meet the conditions. [Instructions] Select one or more options from the drop-down list. If you do not select any, All is used by default. If you set multiple filter conditions, they are combined with a logical AND. For example, if you select Brand A and Region B, the system filters for devices of Brand A that are in Region B. If you select multiple options for a single filter condition, they are combined with a logical OR. For example, if you select Brand A and Brand B, the system filters for devices of Brand A or Brand B.
      Confirm selected devices	Confirms the selected devices.
      Log file time	Pulls the last N days of local logs from the device. The default is 3.

      Click Batch Pull.

      Option	Description
      Application version/Region/ Brand/Model	Sets the filter conditions for pulling devices. Logs are pulled only from devices that meet the conditions. [Instructions] Select one or more options from the drop-down list. If you do not select any, All is used by default. If you set multiple filter conditions, they are combined with a logical AND. For example, if you select Brand A and Region B, the system filters for devices of Brand A that are in Region B. If you select multiple options for a single filter condition, they are combined with a logical OR. For example, if you select Brand A and Brand B, the system filters for devices of Brand A or Brand B.
      Pull Count	The system randomly selects a specified number of devices from the N devices that meet the conditions. The maximum is 100 devices per pull.
      Log file time	Pulls the last N days of local logs from the device. The default is 3.

   2. Pull by condition mode:

      Option	Description
      Application version/Region/ Brand/Model	Sets the filter conditions for pulling devices. Logs are pulled only from devices that meet the conditions. [Instructions] Select one or more options from the drop-down list. If you do not select any, All is used by default. If you set multiple filter conditions, they are combined with a logical AND. For example, if you select Brand A and Region B, the system filters for devices of Brand A that are in Region B. If you select multiple options for a single filter condition, they are combined with a logical OR. For example, if you select Brand A and Brand B, the system filters for devices of Brand A or Brand B.
      Maximum number of pulls	When the number of successful device pulls reaches this limit, the task stops automatically.
      Log Retention Period	Pulls the last N days of local logs from the device. The default is 3.

6. (Optional) To receive notifications when the pull task starts and ends, configure the contact information for notification recipients in the Notification settings section.

   Option	Description
   Notification for first successful pull	Sets whether to send a notification to the specified contacts after the logs from the first device are pulled successfully. Important If this option is enabled, you must set a Notification channel and a Contact group to receive notifications.
   Notification for task completion	Sets whether to send a notification to the specified contacts after the pull task is complete. Important If this option is enabled, you must set a Notification channel and a Contact group to receive notifications.
   Contact group	Sets the contact information, including name, phone number, email address, and Webhook URL.
   Text message	Sets notifications to be received by text message.
   Email	Sets notifications to be received by email.
   Webhook	Sets notifications to be received by Webhook.

7. Click Submit Task to create the task.