Help Center/ Log Tank Service/ User Guide/ Log Transfer/ Transferring Logs to DIS
Updated on 2025-07-28 GMT+08:00
View PDF
Share

Transferring Logs to DIS

DIS provides both log storage and big data analysis. It can perform offline analysis, and transmit a large number of log files to the cloud for backup, query, and machine learning. You can also use it for data recovery and fault analysis on data losses or exceptions. During transfer, a large number of small text files can be merged into large files to accelerate data processing. Select DIS to transfer logs based on your service scenario.
  • You are advised to transfer logs to DMS.
  • This function is available only in regions CN North-Beijing4, CN North-Beijing1, CN East-Shanghai2, CN South-Guangzhou, CN-Hong Kong, and AP-Singapore. To use it in other regions, you need to submit a service ticket to DIS. For details, see Submitting a Service Ticket.

Prerequisites

  • Logs have been ingested to LTS. For details, see Log Ingestion.
  • DIS has been enabled. For details, see Creating a DIS Stream.
  • You will be billed for the storage you use in DIS. For details, see Product Pricing Details.
  • You are advised to transfer logs to DMS.
  • Currently, this function is available only in regions CN North-Beijing4, CN North-Beijing1, CN East-Shanghai2, CN South-Guangzhou, CN-Hong Kong, and AP-Singapore. To use it in other regions, you need to submit a service ticket to DIS. For details, see Submitting a Service Ticket.

Transferring Logs to DIS

  1. Log in to the LTS console and choose Log Transfer in the navigation pane.
  2. Click Configure Log Transfer in the upper right corner.
  3. On the displayed page, configure the log transfer parameters.

    Table 1 Transfer parameters

    Parameter

    Description

    Example Value

    Source Account
    • Current: Logs of the current account will be transferred.
    • Other: Logs of the delegator account will be transferred. Ensure that the delegator has created an agency for log transfer delegation. For details, see Creating an Agency. Note down the names of the created agency and the delegator account.

    Current

    Agency Name

    This parameter is required when Log Source Account is set to Other. Enter the name of the IAM agency created by the delegator.

    -

    Delegator Account Name

    This parameter is required when Log Source Account is set to Other. Enter the account name of the delegator.

    -

    Enable Transfer

    Whether log transfer is enabled.

    Enabled

    Transfer Destination

    Select a cloud service to which logs are transferred.

    DIS

    Log Group Name

    Select a log group.

    -

    Enterprise Project Name

    Select an enterprise project.

    • This parameter is displayed only when the enterprise project function is enabled for the current account.
    • If the enterprise project function is enabled for the current account:
      • All enterprise projects under the current account are displayed in the drop-down list when Log Source Account is set to Current.
      • default is displayed when Log Source Account is set to Other and the enterprise project function is not enabled for the delegator account.
      • All enterprise projects under the delegator account are displayed when Log Source Account is set to Other and the enterprise project function is enabled for the delegator account.

    -

    Log Stream Name

    Select a log stream. Log streams that have been configured with DIS transfer settings cannot be configured again.

    -

    DIS Stream Name

    Select a DIS stream. If no streams are available, click View DIS Streams to access the DIS console and create a stream.

    -

    Format

    The storage format of logs. The value can be Raw log format or JSON.

    • Example of the raw log format:
      (Logs displayed on the LTS console are in the raw format.) 
      Sep 30 07:30:01 ecs-bd70 CRON[3459]: (root) CMD (/opt/oss/servicemgr/ICAgent/bin/manual/mstart.sh > /dev/null 2>&1)
    • Example of the JSON format: 
      {"host_name":"ecs-bd70","ip":"192.168.0.54","line_no":249,"message":"Sep 30 14:40:01 ecs-bd70 CRON[4363]: (root) CMD (/opt/oss/servicemgr/ICAgent/bin/manual/mstart.sh > /dev/null 2>&1)\n","path":"/var/log/syslog","time":1569825602303}

    JSON

    Transfer Interval

    Logs are transferred to the DIS stream in real time.

    Real time

    Filter by Tag Fields

    During transfer, logs will be filtered by tag fields collected by ICAgent.

    • Disabled: Logs will not be filtered by tag fields.
    • Enabled: The default tag fields include those for hosts (hostIP, hostId, hostName, pathFile, and collectTime) and for Kubernetes (clusterName, clusterId, nameSpace, podName, containerName, and appName). Optional public tag fields are regionName, logStreamName, logGroupName, and projectId. When Filter by Tag Fields is enabled, Format must be JSON.
    • Transfer Tag: After this function is enabled, log stream tags are also transferred.

    Enabled

  4. Click OK. When the log transfer status changes to Normal, the transfer task has been created.
  5. Click the DIS stream name in the Transfer Destination column to access the DIS console and view transferred log files.

    Transferred logs can be downloaded from DIS to your local PC for viewing.

    Deleting a transfer task will stop log transfer, and the deleted task cannot be restored. Exercise caution when performing this operation.

    • After a transfer task is deleted, the logs that have been transferred remain in DIS.
    • To delete the transfer task, log in to the DIS console, choose Stream Management, and select the DIS instance to go to the instance details page. Delete the upload permission under Permissions.

Helpful Links

  • If you have any questions when configuring log transfer, see Log Transfer in the FAQ.
  • You can create, query, and delete log transfer tasks by calling APIs. For details, see Log Transfer.
Parent topic: Log Transfer