日志服务投递到 CLS（日志主题跨账号跨地域投递）

说明：
此功能需要白名单权限使用，如有需要，可 提交工单 与我们联系。
操作场景
日志服务支持将一个日志主题的数据投递到另一个日志主题，包括同账号同地域、同账号跨地域、跨账号同地域、跨账号跨地域。该能力适用于以下使用场景：
日志统一管控：不同业务团队分布在各地，运维团队通过跨地域/跨账号投递，将日志汇总至指定地域进行集中监控与分析。
集中归档存储：不同地域产生的日志统一汇聚到一个日志主题。
合规数据汇总：满足数据跨 AZ、跨域汇总的合规诉求。
前提条件
已登录 日志服务控制台。
已完成 创建日志集和日志主题，源日志主题和目标日志主题已存在。
跨账号投递场景：目标账号需要已完成 CAM 角色授权，详情请参见 其他主账号 的相关描述。
注意：
投递到 CLS 日志主题为增量投递，任务创建后仅投递新产生的数据。
操作步骤
1. 登录 日志服务控制台，在左侧导航栏中，选择投递消费 > 投递到 CLS，进入任务管理页面。
2. 单击新建。
﻿
3. 配置投递任务。
﻿
具体配置项说明如下：
配置项
说明
投递任务名称
任务的名称。
服务日志
该任务运行的服务日志，记录任务的运行状态，默认开启（该功能免费）。
源日志主题
需要投递的源日志主题，支持多选，最多选择50个主题。
目标账号
当前主账号：投递到当前主账号的日志主题。
﻿其他主账号
：投递 CLS 日志到其他主账号的日志主题，例如将 A 账号的 CLS 日志投递至 B 账号的日志主题，需要 B 账号在 CAM（访问管理）侧配置访问 角色，配置完成之后，由 A 账号将角色 ARN 和外部 ID 填写到 CLS 控制台，方可进行跨账号投递。配置角色的步骤如下：
1. 新建角色。账号 B 登录 CAM 角色管理页面。
1.1 在策略页面，创建访问策略，选择按策略语法创建，名称填写例如：cls_shipper，策略语法参考如下：
说明：
示例中的授权按照最小权限的原则，resource 配置为仅可以投递至目标地域的主题，请您按照实际情况进行最小权限授权。
﻿
{
    "version": "2.0",
    "statement": [
        {
            "effect": "allow",
            "action": [
                "cam:GetRole",
                "cam:GetPolicy",
                "cam:ListAttachedRolePolicies"
            ],
            "resource": [
                "*"
            ]
        },
        {
            "effect": "allow",
            "action": [
                "cls:UploadLog",
                "cls:DescribeTopics"
            ],
            "resource": [
                "qcs::cls:{地域}:uin/{账号UIN}:topic/{日志主题ID}"
            ]
        }
    ]
}
﻿
1.2 新建角色，选择腾讯云账户角色载体，云账号类型选择其他主账号，然后输入 A 账号的 ID，例如100012345678，勾选开启校验并配置外部 ID，例如 Hello123。
1.3 配置角色的访问策略，选择第一步配置好的访问策略 cls_shipper（示例）。
1.4 保存该角色，例如：uinA_writeCLS_to_CLS。
2. 为角色配置载体。在 CAM 角色列表中找到 uinA_writeCLS_to_CLS（示例），单击该角色，选中下方的角色载体 > 管理载体 > 添加产品服务 > 选中日志服务，然后单击更新。
可以看到当前角色的载体是两个：一个是 A 账号，另一个是 cls.cloud.tencent.com（CLS 日志服务）。
3. A 账号登录 CLS，填入角色 ARN 和外部 ID。
以下两项信息需 B 账号来提供：
B 账号在 CAM 角色列表中找到角色 uinA_writeCLS_to_CLS（示例），单击可查看该角色的 RoleArn，例如 qcs::cam::uin/100001112345:roleName/uinA_writeCLS_to_CLS。
在角色载体中可看到外部 ID，例如 Hello123。
注意：
填写角色 ARN、外部 ID 时，注意不要输入多余的空格，否则会导致权限校验失败。
目标地域
目标日志主题所在地域。
目标日志集
目标日志主题所属日志集，支持选择已有或新建。
目标日志主题
目标日志主题，支持选择已有或新建。
4. 完成配置后单击提交。
使用限制
限制项
限制值
单账号最大投递任务数
50个。
单任务最大源日志主题数
50个。
投递延迟（实时投递）
≤500ms。
数据环路场景
不支持数据投递环路（如日志主题 A→日志主题 B→日志主题 A），配置时系统会自动检测并限制该行为。
注意：
投递到目标日志主题的数据格式以源日志主题原始格式为准。索引配置以目标日志主题的索引为准，出现字段冲突时按目标日志主题格式写入。

配置项	说明
投递任务名称	任务的名称。
服务日志	该任务运行的服务日志，记录任务的运行状态，默认开启（该功能免费）。
源日志主题	需要投递的源日志主题，支持多选，最多选择50个主题。
目标账号	当前主账号：投递到当前主账号的日志主题。其他主账号：投递 CLS 日志到其他主账号的日志主题，例如将 A 账号的 CLS 日志投递至 B 账号的日志主题，需要 B 账号在 CAM（访问管理）侧配置访问角色，配置完成之后，由 A 账号将角色 ARN 和外部 ID 填写到 CLS 控制台，方可进行跨账号投递。配置角色的步骤如下： 1. 新建角色。账号 B 登录 CAM 角色管理页面。 1.1 在策略页面，创建访问策略，选择按策略语法创建，名称填写例如：cls_shipper，策略语法参考如下：说明：示例中的授权按照最小权限的原则，resource 配置为仅可以投递至目标地域的主题，请您按照实际情况进行最小权限授权。 { "version": "2.0", "statement": [ { "effect": "allow", "action": [ "cam:GetRole", "cam:GetPolicy", "cam:ListAttachedRolePolicies" ], "resource": [ "" ] }, { "effect": "allow", "action": [ "cls:UploadLog", "cls:DescribeTopics" ], "resource": [ "qcs::cls:{地域}:uin/{账号UIN}:topic/{日志主题ID}" ] } ] } 1.2 新建角色，选择腾讯云账户角色载体，云账号类型选择其他主账号，然后输入 A 账号的 ID，例如100012345678，勾选开启校验并配置外部 ID，例如 Hello123。 1.3 配置角色的访问策略，选择第一步配置好的访问策略 cls_shipper（示例）。 1.4 保存该角色，例如：uinA_writeCLS_to_CLS。 2. 为角色配置载体。在 CAM 角色列表中找到 uinA_writeCLS_to_CLS（示例），单击该角色，选中下方的角色载体 > 管理载体* > 添加产品服务 > 选中日志服务，然后单击更新。可以看到当前角色的载体是两个：一个是 A 账号，另一个是 cls.cloud.tencent.com（CLS 日志服务）。 3. A 账号登录 CLS，填入角色 ARN 和外部 ID。以下两项信息需 B 账号来提供： B 账号在 CAM 角色列表中找到角色 uinA_writeCLS_to_CLS（示例），单击可查看该角色的 RoleArn，例如 qcs::cam::uin/100001112345:roleName/uinA_writeCLS_to_CLS。在角色载体中可看到外部 ID，例如 Hello123。注意：填写角色 ARN、外部 ID 时，注意不要输入多余的空格，否则会导致权限校验失败。
目标地域	目标日志主题所在地域。
目标日志集	目标日志主题所属日志集，支持选择已有或新建。
目标日志主题	目标日志主题，支持选择已有或新建。

限制项	限制值
单账号最大投递任务数	50个。
单任务最大源日志主题数	50个。
投递延迟（实时投递）	≤500ms。
数据环路场景	不支持数据投递环路（如日志主题 A→日志主题 B→日志主题 A），配置时系统会自动检测并限制该行为。

投递到 CLS（日志主题跨账号跨地域投递）

本页目录：

操作场景

前提条件

操作步骤

使用限制