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:日志库名称。
ProjectName:日志项目的名称。
示例
YAML
格式
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: {}
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机器组、将日志配置应用于机器组、创建日志配置、将查询结果保存为快速查询和创建告警的组合示例:YAML示例。