tencent cloud

Feedback

Push to Tencent Cloud CLS

Last updated: 2024-06-28 14:21:49
    EdgeOne Real-time Log Push supports sending logs to Tencent Cloud CLS. You can configure it through the console or API. For more information about CLS, see CLS Product Documentation.

    Prerequisites

    1. Log in to the Tencent Cloud CLS Console and activate CLS.
    2. If you wish to use a Sub-user account for CLS-related operations, refer to the CLS Permission Management Guide to grant permissions to the sub-account. Ensure the sub-account has read and write permissions for CLS log sets and log topics.
    Note:
    You need to authorize EdgeOne to access your log sets and log topics through the service role TEO_QCSLinkedRoleInRealTimeLogCLS. EdgeOne will use the service role to query log sets and log topics, modify index configurations, and push logs.

    Operation step

    1. Access the EdgeOne console, locate the left-hand menu, and select the Site List. Within this listing, click on the Site requiring configuration to enter its detailed page.
    2. On the Site Details Page, click Log Service > Real-time Logs.
    3. On the Real-time Logs page, click Create shipping task.
    4. On Select the log source Page, fill in the Task name, select the Log type Service area, the Domain name/Layer 4 Proxy Instance for which the logs need to be pushed, and click Next.
    5. On the Define delivery content page:
    (Required) Check the log fields to be pushed from the Predefined field list;
    (Optional) Add a Custom Log Field, supporting the extraction of specified field names from the Request Header, Response Header, and Cookie Header;
    (Optional) Configure the Push Log Filter Criteria, the default is to push full logs;
    (Optional) In advanced configuration, set the sampling ratio. By default, sampling is not enabled, and 100% of logs are pushed to the destination.
    (Optional) In advanced configuration, set the log output format. The default format is JSON Lines.
    Note:
    When pushing to CLS, only the JSON format can be selected. Prefix, suffix, separators, etc., are not applied.
    6. On the Select a destination address page, choose CLS, click Next.
    7. On the Destination Information Page, select the target log set's region, log set, and log topic.
    8. Click Ship, confirm the related cost alert in the popup, and click Confirm Creation.
    9. In the pop-up window, choose the index configuration method. It is recommended to click One-Click Index Configuration. EdgeOne will create a key-value index for the previously selected log topic. You can also choose to configure the index yourself in the CLS Console. Note that if you do not enable the key-value index, you will not be able to search logs.
    Note:
    When the log volume is too large, and either the CLS log topic automatic splitting feature is turned off or the partition value has reached its limit, CLS will restrict the log push request frequency, which may result in log data loss. To avoid such issues, please refer to CLS Log Topic for related configuration.
    
    
    Contact Us

    Contact our sales team or business advisors to help your business.

    Technical Support

    Open a ticket if you're looking for further assistance. Our Ticket is 7x24 avaliable.

    7x24 Phone Support