释放生成式AI的无限潜能

100 万免费令牌

降价88%

开始激活
首页日志服务开发参考日志服务CLI使用CLILogstore管理create_logstore
输入文档关键字查找

create_logstore

更新时间：2025-02-24 06:58
产品详情
社区

调用CLI命令创建Logstore。

注意事项

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

命令格式

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名称：项目（Project）是日志服务的资源管理单元，是进行多用户隔离与访问控制的主要边界。更多信息，请参见管理Project。

--logstore_name

String

是

logstore-a

Logstore名称在Project中全局唯一，且创建后不可修改。

其命名规则如下：

  • 仅支持小写字母、数字、连字符（-）和下划线（_）。

  • 必须以小写字母开头，以小写字母和数字结尾。

  • 名称长度为3~63个字符。

--ttl

Integer

否

30

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

数据保存时间（ttl）是以下三部分时间的总和：

  • 热存储数据保存时间（hot_ttl）

  • 低频存储数据保存时间（infrequent_access_ttl）

  • 归档存储数据保存时间

--shard_count

Integer

否

2

分区（Shard）数量。取值范围为1~10。更多信息，请参见Shard范围。

--enable_tracking

Boolean

否

true

是否开启WebTracking功能。

  • true：开启WebTracking。

  • false（默认值）：不开启WebTracking。

--append_meta

Boolean

否

false

是否开启记录外网IP地址功能。

  • true：开启记录外网IP地址。

  • false（默认值）：不开启记录外网IP地址。

--auto_split

Boolean

否

true

是否自动分裂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，最大不能超过ttl的值，取值为-1代表保存时间ttl内全是热存储。

当数据的存储时间超过您所配置的热存储层数据保存时间后，数据将转为低频存储。关于热存储、低频存储、归档存储的概念和转换流程，请参见管理智能存储分层。

  • 热存储数据至少需要保存7天才能转换为低频存储，低频存储至少需要保存30天才能转换为归档存储。

  • 热存储数据至少需要保存30天才能转换为归档存储。

--mode

String

否

standard

日志服务提供Standard（标准型）和Query（查询型）两种类型的Logstore。

  • standard（默认值）：支持日志服务一站式数据分析功能，适用于实时监控、交互式分析以及构建完整的可观测性系统等场景。

  • query：支持高性能查询，索引流量费用约为Standard的一半，但不支持SELECT语句，适用于数据量大、存储周期长（周、月级别以上）或无日志分析的场景。

更多信息，请参见Logstore类型对比。

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

命令示例

  • 使用默认账号创建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
}

相关文档

上一篇：copy_logstore下一篇：delete_logstore
  • 本页导读 （1）
  • 注意事项
  • 命令格式
  • 命令参数
  • 命令示例
  • 相关文档
文档反馈
phone 联系我们

立即和Alibaba Cloud在线服务人员进行交谈，获取您想了解的产品信息以及最新折扣。

alicare alicarealicarealicare