调用create_logstore命令创建Logstore_日志服务(SLS)-阿里云帮助中心

调用CLI命令创建Logstore。

注意事项

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

已开通日志服务。具体操作，请参见如何开始使用日志服务？。
已安装日志服务CLI，并完成配置。具体操作，请参见安装CLI和配置CLI。
已创建日志服务Project。具体操作，请参见create_project。

命令格式

aliyunlog log create_logstore --project_name=<value> --logstore_name=<value> [--ttl=<value>] [--shard_count=<value>] [--enable_tracking=<value>] [--append_meta=<value>] [--auto_split=<value>] [--max_split_shard=<value>] [--preserve_storage=<value>] [--encrypt_conf=<value>] [--telemetry_type=<value>] [--hot_ttl=<value>] [--mode=<value>] [--access-id=<value>] [--access-key=<value>] [--sts-token=<value>] [--region-endpoint=<value>] [--client-name=<value>] [--jmes-filter=<value>] [--format-output=<value>] [--decode-output=<value>] [--profile=<value>]

命令参数

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

参数名称	数值类型	是否必选	示例值	描述
--project_name	String	是	aliyun-test-project	Project名称。
--logstore_name	String	是	logstore-a	Logstore名称。其命名规则如下：同一个Project下，不可重复。只能包含小写字母、数字、短划线（-）和下划线（_）。必须以小写字母或者数字开头和结尾。长度为3~63字符。
--ttl	Integer	否	30	数据的保存时间，单位为天。取值范围为1~3650。如果配置为3650，表示永久保存。
--shard_count	Integer	否	2	Shard个数。取值范围为1~10。
--enable_tracking	Boolean	否	true	是否开启WebTracking功能。默认值为false。 true：开启WebTracking。 false：不开启WebTracking。
--append_meta	Boolean	否	false	是否开启记录外网IP地址功能。默认值为false。 true：开启记录外网IP地址。 false：不开启记录外网IP地址。
--auto_split	Boolean	否	true	是否自动分裂Shard功能。默认值为false，表示不自动分裂Shard。 true：自动分裂Shard。 false：不自动分裂Shard。
--max_split_shard	Integer	否	64	自动分裂Shard时的最大分裂数。取值范围为1~256。当--auto_split参数为true时必须设置。
--encrypt_conf	String	否	无	加密配置数据结构。更多信息，请参见EncryptConf。
--telemetry_type	String	否	None	可观测数据类型。取值包括： None：日志数据。默认为日志数据。 Metrics：时序数据。
--hot_ttl	Integer	否	60	数据在Logstore热存储层中的存储时间，最少为7天。单位：天，取值范围：7~3000。当数据的存储时间超过您所配置的热存储层数据保存时间后，数据将转为低频存储。更多信息，请参见开启智能存储分层。
--mode	String	否	standard	日志服务提供标准型（Standard）和查询型（Query）两种类型的Logstore。 standard：支持日志服务一站式数据分析功能，适用于实时监控、交互式分析以及构建完整的可观测性系统等场景。 query：支持高性能查询，索引流量费用约为Standard的一半，但不支持SQL分析，适用于数据量大、存储周期长（周、月级别以上）、无日志分析的场景。

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

命令示例

使用默认账号创建logstore-a。

命令示例

aliyunlog log create_logstore --project_name="aliyun-test-project" --logstore_name="logstore-a"

返回示例

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

aliyunlog log get_logstore --project_name="aliyun-test-project" --logstore_name="logstore-a" --format-output=json

使用指定账号test，创建一个名为logstore-b的Logstore。

命令示例

aliyunlog log create_logstore --project_name="aliyun-test-project" --logstore_name="logstore-b" --client-name="test"

返回示例

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

aliyunlog log get_logstore --project_name="aliyun-test-project" --logstore_name="logstore-b"  --client-name="test" --format-output=json

返回结果如下：

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

注意事项

命令格式

命令参数

命令示例

相关文档