Simple Log Service:update_logstore

Parameter

Type

Required

Example

Description

--project_name

String

Yes

aliyun-test-project

The name of the project. The project in Simple Log Service is used to isolate the resources of different users and control access to specific resources. For more information, see Manage a project.

--logstore_name

String

Yes

logstore-a

--ttl

Integer

No

30

The data retention period. Unit: days. Valid values: 1 to 3650. If you set this parameter to 3650, data is permanently stored. If the specified retention period elapses, log data is deleted.

The data retention period specified by the ttl parameter is the sum of the following time values:

• The data retention period for the hot storage tier, which is specified by the hot_ttl parameter

• The data retention period for the Infrequent Access (IA) storage tier, which is specified by the infrequent_access_ttl parameter

• The data retention period for the Archive storage tier

--shard_count

Integer

No

2

The number of shards. Valid values: 1 to 10. For more information, see MD5 value range.

--enable_tracking

Boolean

No

true

Specifies whether to enable the web tracking feature. Valid values:

• true

• false

--append_meta

Boolean

No

false

Specifies whether to record public IP addresses. Valid values:

• true

• false

--auto_split

Boolean

No

true

Specifies whether to enable automatic sharding. Valid values:

• true

• false

--max_split_shard

Integer

No

64

The maximum number of shards into which existing shards can be automatically split. Valid values: 1 to 256. If you set --autoSplit to true, you must specify this parameter.

--encrypt_conf

String

No

None

The data structure of the encryption configuration.

For more information, see EncryptConf.

--telemetry_type

String

No

None

The type of the observable data. Valid values:

• None (default): logs

• Metrics: metrics

--hot_ttl

Integer

No

7

The data retention period for the hot storage tier. Unit: days. The minimum value is 7, and the maximum value cannot exceed the ttl parameter. If you set this parameter to -1, all data is stored in the hot storage tier.

After the data retention period that is specified for the hot storage tier elapses, the data is moved to the IA storage tier. For more information about the storage tiers and movements of data between storage tiers, see Configure intelligent tiered storage.

• Data in the hot storage tier must be stored for at least seven days before the data can be moved to the IA storage tier. Data in the IA storage tier must be stored for at least 30 days before the data can be moved to the Archive storage tier.

• Data in the hot storage tier must be stored for at least 30 days before the data can be moved to the Archive storage tier.

--mode

String

No

standard

The type of the logstore. Simple Log Service provides two types of logstores: Standard logstores and Query logstores. Valid values:

• standard: Standard logstore. This type of logstore supports the log analysis feature and is suitable for scenarios such as real-time monitoring and interactive analysis. You can also use this type of logstore to build a comprehensive observability system.

• query: Query logstore. This type of logstore supports high-performance queries. The index traffic fee of a Query logstore is approximately half that of a Standard logstore. Query logstores do not support SELECT statements. Query logstores are suitable for scenarios in which the amount of data is large, the log retention period is long, or log analysis is not required. If logs are stored for weeks or months, the log retention period is considered long. For more information, see Appendix: logstore comparison by type.

--infrequent_access_ttl

Integer

No

30

The data retention period for the IA storage tier. Unit: days. Data in the IA storage tier must be stored for at least 30 days before the data can be moved to the Archive storage tier. For more information, see Configure intelligent tiered storage.