すべてのプロダクト
Search

このプロダクト

    Simple Log Service:create_logstore

    ドキュメントセンター

    Simple Log Service:create_logstore

    最終更新日:Feb 27, 2025

    ログストアを作成します。

    使用方法

    この Log Service 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

    プロジェクトの名前。Simple Log Service のプロジェクトは、異なるユーザーのリソースを分離し、特定のリソースへのアクセスを制御するために使用されます。詳細については、「プロジェクトを管理する」をご参照ください。

    --logstore_name

    String

    はい

    logstore-a

    ログストアの名前。名前はグローバルに一意である必要があります。プロジェクトの作成後に名前を変更することはできません。

    名前は、以下の要件を満たしている必要があります。

    • 小文字、数字、ハイフン（-）、およびアンダースコア（_）を含めることができます。

    • 小文字で始まり、小文字または数字で終わる必要があります。

    • 長さは 3 ～ 63 文字である必要があります。

    --ttl

    Integer

    いいえ

    30

    データの保存期間。単位：日。有効値：1 ～ 3650。このパラメーターを 3650 に設定すると、データは永続的に保存されます。指定した保存期間が経過すると、ログデータは削除されます。

    ttl パラメーターで指定されたデータ保持期間は、次の時間の値の合計です。

    • hot_ttl パラメーターで指定されるホット ストレージ層のデータ保存期間

    • infrequent_access_ttl パラメーターで指定される、低頻度アクセス（IA）ストレージ層のデータ保存期間

    • アーカイブストレージ層のデータ保存期間

    --shard_count

    Integer

    いいえ

    2

    シャードの数。有効値：1 ～ 10。詳細については、「MD5 値の範囲」をご参照ください。

    --enable_tracking

    Boolean

    いいえ

    true

    Web トラッキング機能を有効にするかどうかを指定します。有効値：

    • true

    • false（デフォルト）

    --append_meta

    Boolean

    いいえ

    false

    パブリック IP アドレスを記録するかどうかを指定します。有効値：

    • true

    • false（デフォルト）

    --auto_split

    Boolean

    いいえ

    true

    自動シャーディングを有効にするかどうかを指定します。有効値：

    • true（デフォルト）

    • false

    --max_split_shard

    Integer

    いいえ

    64

    既存のシャードを自動的に分割できる最大のシャード数。有効値：1 ～ 256。--auto_split を true に設定する場合は、このパラメーターを指定する必要があります。

    --encrypt_conf

    String

    いいえ

    なし

    暗号化構成のデータ構造。

    詳細については、「EncryptConf」をご参照ください。

    --telemetry_type

    String

    いいえ

    なし

    可観測性データのタイプ。有効値：

    • なし（デフォルト）：ログ

    • Metrics：メトリック

    重要

    このパラメーターは、作成後に変更することはできません。

    --hot_ttl

    Integer

    いいえ

    60

    ホットストレージ層のデータ保存期間。単位：日。最小値は 7 で、最大値は ttl パラメーターを超えることはできません。このパラメーターを -1 に設定すると、すべてのデータがホットストレージ層に保存されます。

    ホットストレージ層に指定されたデータ保存期間が経過すると、データは IA ストレージ層に移動されます。ストレージ層とストレージ層間のデータの移動の詳細については、「インテリジェント階層型ストレージを構成する」をご参照ください。

    • ホットストレージ層のデータは、IA ストレージ層に移動する前に少なくとも 7 日間保存する必要があります。IA ストレージ層のデータは、アーカイブストレージ層に移動する前に少なくとも 30 日間保存する必要があります。

    • ホットストレージ層のデータは、アーカイブストレージ層に移動する前に少なくとも 30 日間保存する必要があります。

    --mode

    String

    いいえ

    standard

    ログストアのタイプ。Simple Log Service は、[標準] ログストアと [クエリ] ログストアを提供します。有効値：

    • standard（デフォルト）：標準ログストア。このタイプのログストアはログ分析機能をサポートしており、リアルタイムモニタリングやインタラクティブ分析などのシナリオに適しています。このタイプのログストアを使用して、包括的な可観測性システムを構築できます。

    • query：クエリログストア。このタイプのログストアは、高パフォーマンスのクエリ操作をサポートしています。クエリログストアのインデックストラフィック料金は、[標準] ログストアの約半分です。クエリログストアは SELECT 文をサポートしていません。クエリログストアは、データ量が大きく、データ保存期間が長く、ログ分析が不要なシナリオに適しています。数週間または数ヶ月のデータ保存期間は長いと見なされます。

    詳細については、「付録：タイプ別ログストアの比較」をご参照ください。

    このコマンドのグローバルパラメーターの詳細については、「グローバルパラメーター」をご参照ください。

    コマンド例

    • デフォルトアカウントを使用して、logstore-a という名前のログストアを作成します。

      • コマンド

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

      • 出力

        コマンドが正常に実行された場合、応答は返されません。次のコマンドを実行して、ログストアの詳細をクエリできます。

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

    • test という名前のアカウントを使用して、logstore-b という名前のログストアを作成します。

      • コマンド

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

      • 出力

        コマンドが正常に実行された場合、応答は返されません。次のコマンドを実行して、ログストアの詳細をクエリできます。

        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
}

    関連情報