すべてのプロダクト
Search
ドキュメントセンター

Simple Log Service:create_logstore

最終更新日:Sep 05, 2024

Logstoreを作成します。

使用上の注意

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

プロジェクトの名前。

-- logstore_name

String

課金されます

logstore-a

ログストアの名前 名前の条件は以下の通りです。

  • 名前はプロジェクト内で一意である必要があります。

  • 名前には、小文字、数字、ハイフン ( - )、アンダースコア ( _ ) のみ使用できます。

  • 名前の先頭と末尾は、小文字または数字である必要があります。

  • 名前の長さは 3 ~ 63 文字である必要があります。

-- ttl

Integer

課金されません

30

データ保持期間。 単位:日 有効な値: 1 ~ 3650 このパラメーターを3650に設定すると、データは永続的に保存されます。

-- shard_count

Integer

×

2

シャードの数。 有効な値: 1 ~ 10。

-- enable_tracking

ブール値

課金されません

true

webトラッキング機能を有効にするかどうかを指定します。 デフォルト値:false 有効な値:

  • true

  • false

-- append_meta

ブール値

課金されません

false

パブリックIPアドレスを記録するかどうかを指定します。 デフォルト値:false 有効な値:

  • true

  • false

-- auto_split

ブール値

課金されません

true

自動シャーディングを有効にするかどうかを指定します。 デフォルト値:false 有効な値:

  • true

  • false

-- max_split_shard

Integer

課金されません

64

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

-- encrypt_conf

String

なし

暗号化設定のデータ構造。

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

-- telemetry_type

String

なし

観測可能なデータの型。 有効な値:

  • なし (デフォルト): ログ

  • Metrics: metrics

-- hot_ttl

Integer

課金されません

60

Logstoreのホットストレージ層のデータの保持期間。 単位:日 有効な値: 7 ~ 3000

ホットデータの保持期間が -- hot_ttlで指定された期間を超えた場合、データは低頻度アクセス (IA) ストレージ層に保存されます。 詳細については、「インテリジェント階層ストレージの有効化」をご参照ください。

-- mode

String

課金されません

standard

Logstoreのタイプ。 Log Serviceには、標準ログストアとクエリログストアの2種類のログストアがあります。 有効な値:

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

  • query: Logstoreを照会します。 このタイプのLogstoreは、高性能なクエリをサポートします。 クエリログストアのインデックストラフィック料金は、標準ログストアの約半分です。 クエリLogstoreはSQL分析をサポートしていません。 クエリログストアは、データ量が多い、ログの保持期間が長い、またはログ分析が不要なシナリオに適しています。 ログが数週間または数か月保存される場合、ログの保持期間は長いと見なされます。

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

コマンドの例

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

    • コマンド

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

      コマンドが正常に実行された場合、応答は返されません。 次のコマンドを実行して、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"
    • Output

      コマンドが正常に実行された場合、応答は返されません。 次のコマンドを実行して、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を呼び出した後、Log Serviceによって返された応答にエラー情報が含まれている場合、呼び出しは失敗します。 API呼び出しが失敗したときに返されるエラーコードに基づいてエラーを処理できます。 詳細については、エラーコードをご参照ください。

  • Alibaba Cloud OpenAPI Explorerは、デバッグ機能、SDK、サンプル、および関連ドキュメントを提供します。 OpenAPI Explorerを使用して、リクエストを手動でカプセル化したり署名したりすることなく、Log Service API操作をデバッグできます。 詳細については、をご覧ください。 OpenAPIポータル

  • このコマンドに対応するAPI操作の詳細については、「CreateLogStore」をご参照ください。

  • Log Serviceは、Log Service SDK for JavaおよびLog Service SDK for Pythonを使用してLogstoreを管理するために使用されるサンプルコードを提供します。 詳細については、「Log Service SDK For Javaを使用したLogstoreの管理」および「Simple Log Service SDK for Pythonを使用したLogstoreの管理」をご参照ください。