create_logstore - Create a Logstore | Simple Log Service CLI - Simple Log Service

Crea un logstore en un proyecto específico.

Requisitos previos

Asegúrese de cumplir con a continuación:

Tener activado Simple Log Service. How do I get started with Simple Log Service?
Tener instalada y configurada la CLI de Simple Log Service. Install Simple Log Service CLI | Configure Simple Log Service CLI
Haber creado un proyecto en Simple Log Service. create_project

Sintaxis del comando

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

Ejemplos

Crear un logstore con la configuración predeterminada

Cree un logstore llamado logstore-a en el proyecto aliyun-test-project:

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

Si la operación es exitosa, no se genera ninguna salida. Compruebe el resultado:

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

Crear un logstore con una cuenta específica

Cree un logstore llamado logstore-b mediante la cuenta test:

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

Compruebe el resultado:

aliyunlog log get_logstore \
  --project_name="aliyun-test-project" \
  --logstore_name="logstore-b" \
  --client-name="test" \
  --format-output=json

Respuesta de ejemplo:

{
  "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
}

Parámetros

En esta sección se describen únicamente los parámetros específicos del comando. Los parámetros globales (--access-id, --access-key, --sts-token, --region-endpoint, --client-name, --jmes-filter, --format-output, --decode-output, --profile) se explican en Global parameters.

Parámetros obligatorios

Parámetro	Tipo	Descripción	Ejemplo
`--project_name`	String	Nombre del proyecto. Consulte Manage a project.	`aliyun-test-project`
`--logstore_name`	String	Nombre del logstore. No se puede modificar después de crearlo. Consulte las Reglas de nomenclatura.	`logstore-a`

Parámetros opcionales

Parámetro	Tipo	Predeterminado	Descripción	Ejemplo
`--ttl`	Integer	30	Periodo de retención de datos en días (de 1 a 3650). Establezca este valor en `3650` para habilitar el almacenamiento permanente. Los datos caducados se eliminan automáticamente. La retención total equivale a la suma de los periodos de almacenamiento hot, IA y Archive.	`30`
`--shard_count`	Integer	--	Cantidad de shards (de 1 a 10). MD5 value range.	`2`
`--enable_tracking`	Boolean	`false`	Habilita el seguimiento web.	`true`
`--append_meta`	Boolean	`false`	Registra las direcciones IP públicas.	`false`
`--auto_split`	Boolean	`true`	Habilita la división automática de shards.	`true`
`--max_split_shard`	Integer	64	Número máximo de shards para la división automática. Valores válidos: de 1 a 256. Este parámetro es obligatorio cuando `--auto_split` es `true`.	`64`
`--preserve_storage`	Boolean	`false`	Habilita el almacenamiento permanente. Si se establece en `true`, se ignora el parámetro `--ttl` y los datos se almacenan de forma permanente.	`true`
`--encrypt_conf`	String	`None`	Configuración de cifrado. Estructura de datos: EncryptConf.	`None`
`--telemetry_type`	String	`None`	Tipo de datos de observability. Valores válidos: `None` (registros), `Metrics` (métricas). Importante No se puede modificar después de crear el logstore.	`None`
`--hot_ttl`	Integer	--	Periodo de retención en almacenamiento hot, expresado en días. Mínimo: 7. Máximo: no puede superar el valor de `--ttl`. Establezca este valor en `-1` para conservar todos los datos en almacenamiento hot. Una vez transcurrido este periodo, los datos se trasladan al almacenamiento IA. Consulte las Reglas de niveles de almacenamiento.	`60`
`--mode`	String	`standard`	Tipo de logstore. Valores válidos: `standard` (logstore estándar), `query` (logstore de consultas). Importante No se puede modificar después de crear el logstore. Para más información, consulte Elección del tipo de logstore.	`standard`

Reglas de nomenclatura

El parámetro --logstore_name debe cumplir con los siguientes requisitos:

Tener entre 3 y 63 caracteres de longitud.
Contener únicamente letras minúsculas, dígitos, guiones (-) y guiones bajos (_).
Comenzar con una letra minúscula.
Terminar con una letra minúscula o un dígito.
Ser único a nivel global.
No se puede modificar después de crear el logstore.

Elección del tipo de logstore

El parámetro --mode define el tipo de logstore:

Función	Logstore estándar (`standard`)	Logstore de consultas (`query`)
Análisis de registros (instrucciones SELECT)	Compatible	No compatible
Dashboard	Compatible	No compatible
Costo de tráfico de índices	Tarifa estándar	Aproximadamente la mitad de la tarifa estándar
Escenario recomendado	Monitoreo en tiempo real, análisis interactivo y observability completa	Ingesta de grandes volúmenes de datos con retención prolongada y cargas de trabajo exclusivas de búsqueda

Logstore comparison by type.

Reglas de niveles de almacenamiento

El parámetro --hot_ttl controla cuánto tiempo permanecen los datos en el almacenamiento hot antes de trasladarse a niveles de menor costo. Retención mínima por nivel:

Transición	Retención mínima
De almacenamiento hot a almacenamiento Infrequent Access (IA)	7 días en almacenamiento hot
De almacenamiento IA a almacenamiento Archive	30 días en almacenamiento IA
De almacenamiento hot a almacenamiento Archive (directa)	30 días en almacenamiento hot

Las políticas de transición se detallan en Configure intelligent tiered storage.

Referencias

CreateLogStore: operación de API correspondiente.
Error codes: referencia de errores de API.
Manage logstores by using Log Service SDK for Java y Use Simple Log Service SDK for Python to manage logstores: alternativas mediante SDK.
Centro de SDK de Simple Log Service: todos los SDK disponibles.