ALIYUN::SLS::Logstore类型用于在日志项目下创建日志库。
语法
{
"Type": "ALIYUN::SLS::Logstore",
"Properties": {
"ProjectName": String,
"ShardCount": Integer,
"AutoSplit": Boolean,
"MaxSplitShard": Integer,
"LogstoreName": String,
"AppendMeta": Boolean,
"TTL": Integer,
"EnableTracking": Boolean,
"PreserveStorage": Boolean,
"EncryptConf": Map
}
}
属性
属性名称 | 类型 | 必须 | 允许更新 | 描述 | 约束 |
---|---|---|---|---|---|
ProjectName | String | 是 | 否 | 要创建的日志库所属日志项目的名称。 | 长度为3~36个字符。 支持小写英文字母、数字、短划线(-)、下划线(_)。必须以小写英文字母或数字开头和结尾。 |
ShardCount | Integer | 否 | 是 | 分区个数。 | 取值范围:1~100。 默认值:2。 单位:个。 |
MaxSplitShard | Integer | 否 | 是 | 自动分裂时,分裂出最大的分区个数。 | 取值范围:1~64。 当autoSplit为true时,必须指定MaxSplitShard。 |
LogstoreName | String | 是 | 否 | 日志库的名称。 | 在一个日志项目中,日志库的名称必须具有唯一性。
|
AutoSplit | Boolean | 否 | 是 | 是否自动分裂分区。 | 取值:
|
TTL | Integer | 否 | 是 | 数据的保存时间。 | 取值范围:1~3600。 默认值:30。 单位:天。 |
EnableTracking | Boolean | 否 | 是 | 是否开启WebTracking采集信息。 | 支持采集各种浏览器以及iOS或Android App的信息。 取值:
|
PreserveStorage | Boolean | 否 | 是 | 是否永久保存日志。 | 取值:
|
AppendMeta | Boolean | 否 | 是 | 接收日志后,是否自动添加客户端外网IP和日志到达时间。 | 取值:
|
EncryptConf | Map | 否 | 否 | 数据加密配置。 | 更多信息,请参见EncryptConf语法和EncryptConf属性。 |
EncryptConf语法
"EncryptConf": {
"Enable": Boolean,
"EncryptType": String,
"UserCmkInfo": Map
}
EncryptConf属性
属性名称 | 类型 | 必须 | 允许更新 | 描述 | 约束 |
---|---|---|---|---|---|
Enable | Boolean | 是 | 否 | 是否启用数据加密。 | 取值:
|
EncryptType | String | 是 | 否 | 加密算法。 | 取值:
说明 关于数据加密的更多信息,请参见
数据加密。
|
UserCmkInfo | Map | 否 | 否 | 如果指定了UserCmkInfo,则使用自带密钥(BYOK)加密或解密数据。否则,将使用日志服务的服务密钥。 | 更多信息,请参见UserCmkInfo语法和UserCmkInfo属性。 |
UserCmkInfo语法
"UserCmkInfo": {
"CmkKeyId": String,
"Arn": String,
"RegionId": String
}
UserCmkInfo属性
属性名称 | 类型 | 必须 | 允许更新 | 描述 | 约束 |
---|---|---|---|---|---|
CmkKeyId | String | 是 | 否 | BYOK密钥所属的CMK的ID。 | 无 |
Arn | String | 是 | 否 | CMK所在区域的ID。 | 无 |
RegionId | String | 是 | 否 | RAM角色的ARN。 | 关于如何获取RAM角色的ARN的更多信息,请参见将日志服务数据投递到OSS。 |
返回值
Fn::GetAtt
LogstoreName:日志库名称。
示例
JSON
格式{ "ROSTemplateFormatVersion": "2015-09-01", "Description": "Test SLS Logstore", "Parameters": { }, "Resources": { "SlsLogStore": { "Type": "ALIYUN::SLS::Logstore", "Properties": { "LogstoreName": "mytest", "PreserveStorage": true, "ProjectName": "TestProject", "AppendMeta": true, "MaxSplitShard": 64, "AutoSplit": true, "EnableTracking": false, "ShardCount": 2 } } }, "Outputs": { } }
更多示例,请参见创建日志项目、创建日志库、创建索引、配置Logtail参数、创建日志服务ECS机器组、将日志配置应用于机器组、创建日志配置、将查询结果保存为快速查询和创建告警的组合示例:JSON示例和YAML示例。