调用CLI命令创建Logstore

更新时间:
复制 MD 格式

调用CLI命令在指定Project下创建一个Logstore。

注意事项

在使用CLI命令之前,您需要注意以下事项:

  • 已开通日志服务。

  • 已安装日志服务CLI安装与配置

  • 已创建日志服务Project。

命令格式

aliyun sls create-log-store --project=<value> --logstore-name=<value> --ttl=<value> --shard-count=<value> [--auto-split=<value>] [--max-split-shard=<value>] [--mode=<value>] [--hot-ttl=<value>] [--append-meta=<value>] [--enable-tracking=<value>] [--encrypt-conf=<value>]

命令参数

该命令的必选和特有参数描述如下。

参数名称

数值类型

是否必选

示例值

描述

--project

String

aliyun-test-project

Project名称:项目(Project)是日志服务的资源管理单元,是进行多用户隔离与访问控制的主要边界。更多信息,请参见管理Project。

--logstore-name

String

aliyun-test-logstore

Logstore名称在Project中全局唯一,且创建后不可修改。其命名规则如下:。仅支持小写字母、数字、连字符(-)和下划线(_)。。必须以小写字母开头,以小写字母和数字结尾。。名称长度为3~63个字符。

--ttl

Integer

30

数据保存时间,单位为天。取值范围:1~3650,如果配置为3650,表示永久保存。当设置的保存期限到达时,日志将被删除。

--shard-count

Integer

2

分区(Shard)数量。取值范围为1~10。更多信息,请参见Shard范围。

--auto-split

Boolean

true

是否自动分裂Shard功能。取值:。true(默认值):自动分裂Shard。。false:不自动分裂Shard。

--max-split-shard

Integer

64

自动分裂Shard时的最大分裂数。取值范围为1~256。当--auto-split参数为true时必须设置。

--mode

String

standard

日志服务提供Standard(标准型)和Query(查询型)两种类型的Logstore。。standard(默认值):支持日志服务一站式数据分析功能,适用于实时监控、交互式分析以及构建完整的可观测性系统等场景。。query:支持高性能查询,索引流量费用约为Standard的一半,但不支持SELECT语句,适用于数据量大、存储周期长(周、月级别以上)或无日志分析的场景。更多信息,请参见Logstore类型对比。

--hot-ttl

Integer

60

数据在Logstore热存储层中的存储时间,单位为天。最小为7,最大不能超过--ttl的值,取值为-1代表保存时间--ttl内全是热存储。当数据的存储时间超过您所配置的热存储层数据保存时间后,数据将转为低频存储。关于热存储、低频存储、归档存储的概念和转换流程,请参见管理智能存储分层。

--append-meta

Boolean

false

是否开启记录外网IP地址功能。取值:。true:开启记录外网IP地址。。false(默认值):不开启记录外网IP地址。

--enable-tracking

Boolean

false

是否开启WebTracking功能。取值:。true:开启WebTracking。。false(默认值):不开启WebTracking。

--encrypt-conf

String

加密配置数据结构。更多信息,请参见EncryptConf。

关于该命令的全局参数,请参见全局参数。

命令示例

创建Logstore

  • 命令示例

创建aliyun-test-logstore。

aliyun sls create-log-store --project="aliyun-test-project" --logstore-name="aliyun-test-logstore" --ttl=30 --shard-count=2
  • 返回示例

命令执行成功后,无响应消息。您可以执行如下命令查询Logstore详细信息。

aliyun sls get-log-store --project="aliyun-test-project" --logstore="aliyun-test-logstore"

get-log-store 请求返回结果如下:

{
  "appendMeta": false,
  "archiveSeconds": 0,
  "autoSplit": true,
  "createTime": 1719280391,
  "enable_tracking": false,
  "lastModifyTime": 1719282255,
  "logstoreName": "demo-logstore",
  "maxSplitShard": 64,
  "mode": "standard",
  "productType": "",
  "resourceQuota": {
    "storage": {
      "preserved": -1,
      "used": 0
    }
  },
  "shardCount": 5,
  "telemetryType": "",
  "ttl": 30
}

相关文档

  • 在调用API接口过程中,若服务端返回结果中包含错误信息,则表示调用API接口失败。您可以参考API错误码对照表查找对应的解决方法。更多信息,请参见PutLogs

  • 阿里云OpenAPI开发者门户提供调试、SDK、示例和配套文档。通过OpenAPI,您无需手动封装请求和签名操作,就可以快速对日志服务API进行调试。更多信息,请参见OpenAPI开发者门户

API参考

创建LogStore