全部產品
Search
文件中心

Simple Log Service:create_logstore

更新時間:Oct 25, 2024

調用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名稱。

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

Log Service提供標準型(Standard)和查詢型(Query)兩種類型的Logstore。

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

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

相關文檔

  • 在調用API介面過程中,若服務端返回結果中包含錯誤資訊,則表示調用API介面失敗。您可以參考API錯誤碼對照表尋找對應的解決方案。更多資訊,請參見API錯誤處理對照表

  • 阿里雲OpenAPI開發人員門戶提供調試、SDK、樣本和配套文檔。通過OpenAPI,您無需手動封裝請求和簽名操作,就可以快速對Log ServiceAPI進行調試。更多資訊,請參見OpenAPI開發人員門戶

  • 關於該API介面的詳細資料,請參見CreateLogStore

  • Log Service提供基於Java SDK和Python SDK的管理Logstore範例程式碼。更多資訊,請參見使用Java SDK管理日誌庫Logstore使用Python SDK管理日誌庫Logstore