全部產品
Search

搜尋本產品

    Simple Log Service：create_logstore

    文件中心

    Simple Log Service：create_logstore

    更新時間：Feb 25, 2025

    調用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）是Log Service的資源嵌入式管理單元，是進行多使用者隔離與存取控制的主要邊界。更多資訊，請參見管理Project。

    --logstore_name

    String

    是

    logstore-a

    Logstore名稱在Project中全域唯一，且建立後不可修改。

    其命名規則如下：

    • 僅支援小寫字母、數字、連字號（-）和底線（_）。

    • 必須以小寫字母開頭，以小寫字母和數字結尾。

    • 名稱長度為3~63個字元。

    --ttl

    Integer

    否

    30

    資料儲存時間，單位為天。取值範圍：1~3650，如果配置為3650，表示永久儲存。當設定的儲存期限到達時，日誌將被刪除。

    資料儲存時間（ttl）是以下三部分時間的總和：

    • 熱儲存資料儲存時間（hot_ttl）

    • 低頻儲存資料儲存時間（infrequent_access_ttl）

    • Archive Storage資料儲存時間

    --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內全是熱儲存。

    當資料的儲存時間超過您所配置的熱儲存層資料儲存時間後，資料將轉為低頻儲存。關於熱儲存、低頻儲存、Archive Storage的概念和轉換流程，請參見管理智能儲存分層。

    • 熱儲存資料至少需要儲存7天才能轉換為低頻儲存，低頻儲存至少需要儲存30天才能轉換為Archive Storage。

    • 熱儲存資料至少需要儲存30天才能轉換為Archive Storage。

    --mode

    String

    否

    standard

    Simple Log Service提供Standard（標準型）和Query（查詢型）兩種類型的Logstore。

    • standard（預設值）：支援Log Service一站式資料分析功能，適用於即時監控、互動式分析以及構建完整的可觀測性系統等情境。

    • 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
}

    相關文檔