日志服务创建模板

操作场景
您可使用配置模板，批量地对日志主题创建配置。例如批量地创建日志主题投递到 COS 的任务，您可事先创建好模板并设置好投递 COS 的属性，然后将模板应用到多个日志主题，快速创建出多个具有相同属性的投递 COS 任务。
前提条件
1. 开通日志服务，创建日志集与日志主题，并成功采集到日志数据。
2. 子账号/协作者需要主账号授权，授权步骤参见 基于 CAM 管理权限，授权策略参考： 
{"statement": [ { 
"action": [
"cls:DescribeTopics", 
"cls:DescribeLogsets",
"cls:GetConfigurationTemplateApplyLog",
"cls:ApplyConfigurationTemplate",
"cls:CreateConfigurationTemplate",
"cls:DeleteConfigurationTemplate",
"cls:ModifyConfigurationTemplate",
"cls:DescribeConfigurationTemplates", 
"cos:GetService",
"cam:ListAttachedRolePolicies" ], 
"effect":"allow", 
"resource": [ "*" ] 
} ],
"version": "2.0" }
3. 已授权给腾讯云 CLS 服务角色 QcloudAccessForCLSRoleInTemplate 访问策略，用作 CLS 模板 Template 扮演用户来完成一系列操作，该后台任务会按照用户的配置为用户创建投递任务、索引、采集配置等操作。
操作步骤
1. 登录 日志服务控制台。
2. 在左侧导航栏中，单击配置模板。
3. 单击创建模板，当前模板仅可配置投递 COS。
﻿
配置项说明
配置项
﻿
解释说明
规则
是否必填
模板名称
﻿
配置模板的名称
-
必填
模板描述
﻿
对模板的描述
-
非必填
投递COS
配置
投递任务名称
投递任务名称默认${TopicName}-${TaskCreateTime}拼接而成，${TopicName}指的是日志主题名称，
${TaskCreateTime}指的是投递 COS 任务的创建时间，
您可输入自定义后缀
投递任务名称总长度255字符，其中${TopicName}最长200字符，超出200将被截断。
-
﻿
投递历史数据
不开启：仅投递实时数据
开启：投递历史数据，您可选择投递日志的时间范围。后台会自动和模板应用的日志主题的生命周期做交集。举例如下：
模板中投递时间范围为5月1日-∞，日志主题A存储时长为30天，对 A 主题而言：
如果5月15日被应用模板，投递 COS 任务的日志时间范围为5月1日-∞；
如果6月1日被应用模板，投递 COS 任务的日志时间范围为5月2日-∞
注意：
模板提交以后，投递日志时间范围不支持修改。
﻿
时间选择
必填
﻿
COS 存储桶
应用模板时选择
-
-
﻿
COS 路径
默认为：${TopicName}-${TaskCreateTime}/%Y/%m/%d/%H/
${TopicName}指的是日志主题名称，${TaskCreateTime}指的是投递任务创建时间，/%Y/%m/%d/%H//年/月/日/小时/。
您可以在默认 COS 路径上添加自定义字符，或者删除默认路径，使用您自定义的路径。
非/开头，路径总长度255字符，其中其中${TopicName}最长200字符，超出200将被截断。
可选
﻿
压缩
格式
支持 Snappy\\lzop\\gzip
gzip\\snappy\\lzop
必填
﻿
投递文件大小
需要投递的原始日志文件的大小，和投递间隔时间配合使用，哪个条件先触发，就按照哪个规则去压缩文件，然后投递到 COS
例如配置256M，15分钟，如果文件大小在5分钟就到了256MB，那么文件大小这个条件先触发投递任务
5 - 256，单位：MB
必填
﻿
投递间隔时间
指定间隔多长时间，触发一次投递，和投递文件大小配合使用，哪个条件先触发，就按照哪个规则去压缩文件，然后投递到 COS
例如配置256MB，15分钟，如果文件大小在15分钟时仅为200MB，间隔时间这个条件先触发投递任务
300 - 900，单位：s
必填
﻿
投递
格式
详细请参见 转义选项的说明﻿
注意：
当您选择不转义时，JSON 的第一层节点中包含有数值时，投递后会自动转为 int、float;
﻿
-
必填
﻿
投递字段
是否投递 CLS 元数据字段、__TAG__字段
-
必填
4. 单击确定，保存模板。模板需要应用至日志主题方可生效。参见 应用模板。

配置项			解释说明	规则	是否必填
模板名称			配置模板的名称	-	必填
模板描述			对模板的描述	-	非必填
投递COS 配置	投递任务名称	投递任务名称默认${TopicName}-${TaskCreateTime}拼接而成，${TopicName}指的是日志主题名称， ${TaskCreateTime}指的是投递 COS 任务的创建时间，您可输入自定义后缀	投递任务名称总长度255字符，其中${TopicName}最长200字符，超出200将被截断。	-
		投递历史数据	不开启：仅投递实时数据开启：投递历史数据，您可选择投递日志的时间范围。后台会自动和模板应用的日志主题的生命周期做交集。举例如下：模板中投递时间范围为5月1日-∞，日志主题A存储时长为30天，对 A 主题而言：如果5月15日被应用模板，投递 COS 任务的日志时间范围为5月1日-∞；如果6月1日被应用模板，投递 COS 任务的日志时间范围为5月2日-∞ 注意：模板提交以后，投递日志时间范围不支持修改。	时间选择	必填
		COS 存储桶	应用模板时选择	-	-
		COS 路径	默认为：${TopicName}-${TaskCreateTime}/%Y/%m/%d/%H/ ${TopicName}指的是日志主题名称，${TaskCreateTime}指的是投递任务创建时间，/%Y/%m/%d/%H//年/月/日/小时/。您可以在默认 COS 路径上添加自定义字符，或者删除默认路径，使用您自定义的路径。	非/开头，路径总长度255字符，其中其中${TopicName}最长200字符，超出200将被截断。	可选
		压缩格式	支持 Snappy\\lzop\\gzip	gzip\\snappy\\lzop	必填
		投递文件大小	需要投递的原始日志文件的大小，和投递间隔时间配合使用，哪个条件先触发，就按照哪个规则去压缩文件，然后投递到 COS 例如配置256M，15分钟，如果文件大小在5分钟就到了256MB，那么文件大小这个条件先触发投递任务	5 - 256，单位：MB	必填
		投递间隔时间	指定间隔多长时间，触发一次投递，和投递文件大小配合使用，哪个条件先触发，就按照哪个规则去压缩文件，然后投递到 COS 例如配置256MB，15分钟，如果文件大小在15分钟时仅为200MB，间隔时间这个条件先触发投递任务	300 - 900，单位：s	必填
		投递格式	详细请参见转义选项的说明注意：当您选择不转义时，JSON 的第一层节点中包含有数值时，投递后会自动转为 int、float;	-	必填
		投递字段	是否投递 CLS 元数据字段、__TAG__字段	-	必填

创建模板

本页目录：

操作场景

前提条件

操作步骤