全部产品
Search
文档中心

Simple Log Service:create_logstore

更新时间:Jul 06, 2025

Membuat logstore.

Catatan penggunaan

Sebelum menjalankan perintah CLI Layanan Log ini, pastikan kondisi berikut telah terpenuhi:

Sintaks perintah

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

Parameter perintah

Tabel berikut menjelaskan parameter yang diperlukan untuk perintah ini serta parameter spesifik lainnya.

Parameter

Tipe

Diperlukan

Contoh

Deskripsi

--project_name

String

Ya

aliyun-test-project

Nama proyek. Proyek dalam Simple Log Service digunakan untuk mengisolasi sumber daya pengguna yang berbeda dan mengontrol akses ke sumber daya tertentu. Lihat Mengelola proyek.

--logstore_name

String

Ya

logstore-a

Nama logstore. Nama tersebut harus unik secara global. Anda tidak dapat mengubah nama setelah proyek dibuat.

Nama tersebut harus memenuhi persyaratan berikut:

  • Dapat berisi huruf kecil, angka, tanda hubung (-), dan garis bawah (_).

  • Harus dimulai dengan huruf kecil dan diakhiri dengan huruf kecil atau angka.

  • Harus memiliki panjang 3 hingga 63 karakter.

--ttl

Integer

Tidak

30

Periode retensi data. Unit: hari. Nilai valid: 1 hingga 3650. Jika Anda menetapkan parameter ini ke 3650, data akan disimpan secara permanen. Jika periode retensi yang ditentukan berakhir, data log akan dihapus.

Periode retensi data yang ditentukan oleh parameter ttl adalah jumlah dari nilai waktu berikut:

  • Periode retensi data untuk tier penyimpanan panas, yang ditentukan oleh parameter hot_ttl

  • Periode retensi data untuk tier penyimpanan Infrequent Access (IA), yang ditentukan oleh parameter infrequent_access_ttl

  • Periode retensi data untuk tier penyimpanan Arsip

--shard_count

Integer

Tidak

2

Jumlah shard. Nilai valid: 1 hingga 10. Untuk informasi lebih lanjut, lihat Rentang nilai MD5.

--enable_tracking

Boolean

Tidak

true

Menentukan apakah akan mengaktifkan fitur pelacakan web. Nilai valid:

  • true

  • false (default)

--append_meta

Boolean

Tidak

false

Menentukan apakah akan mencatat alamat IP publik. Nilai valid:

  • true

  • false (default)

--auto_split

Boolean

Tidak

true

Menentukan apakah akan mengaktifkan sharding otomatis. Nilai valid:

  • true (default)

  • false

--max_split_shard

Integer

Tidak

64

Jumlah maksimum shard tempat shard yang ada dapat dibagi secara otomatis. Nilai valid: 1 hingga 256. Jika Anda menetapkan --auto_split ke true, Anda harus menentukan parameter ini.

--encrypt_conf

String

Tidak

None

Struktur data konfigurasi enkripsi.

Untuk informasi lebih lanjut, lihat EncryptConf.

--telemetry_type

String

Tidak

None

Tipe data yang dapat diamati. Nilai valid:

  • None (default): logs

  • Metrics: metrics

Penting

Parameter ini tidak dapat diubah setelah dibuat.

--hot_ttl

Integer

Tidak

60

Periode retensi data untuk tier penyimpanan panas. Unit: hari. Nilai minimum adalah 7, dan nilai maksimum tidak boleh melebihi parameter ttl. Jika Anda menetapkan parameter ini ke -1, semua data disimpan di tier penyimpanan panas.

Setelah periode retensi data yang ditentukan untuk tier penyimpanan panas berakhir, data dipindahkan ke tier penyimpanan IA. Untuk informasi lebih lanjut tentang tier penyimpanan dan pergerakan data antar tier penyimpanan, lihat Konfigurasikan penyimpanan bertingkat cerdas.

  • Data di tier penyimpanan panas harus disimpan setidaknya tujuh hari sebelum data dapat dipindahkan ke tier penyimpanan IA. Data di tier penyimpanan IA harus disimpan setidaknya 30 hari sebelum data dapat dipindahkan ke tier penyimpanan Arsip.

  • Data di tier penyimpanan panas harus disimpan setidaknya 30 hari sebelum data dapat dipindahkan ke tier penyimpanan Arsip.

--mode

String

Tidak

standard

Tipe logstore. Simple Log Service menyediakan logstore Standard dan logstore Query. Nilai valid:

  • standard (default): Logstore standar. Tipe logstore ini mendukung fitur analisis log dan cocok untuk skenario seperti pemantauan real-time dan analisis interaktif. Anda dapat menggunakan tipe logstore ini untuk membangun sistem observabilitas yang komprehensif.

  • query: Query logstore. Tipe logstore ini mendukung operasi kueri berperforma tinggi. Biaya lalu lintas indeks Query logstore sekitar setengah dari Standard logstore. Query logstore tidak mendukung pernyataan SELECT. Query logstore cocok untuk skenario di mana jumlah data besar, periode retensi data panjang, atau analisis log tidak diperlukan. Periode retensi data mingguan atau bulanan dianggap panjang.

Untuk informasi lebih lanjut, lihat Lampiran: perbandingan logstore berdasarkan tipe.

Untuk informasi lebih lanjut tentang parameter global dari perintah ini, lihat Parameter Global.

Contoh perintah

  • Gunakan akun default untuk membuat logstore bernama logstore-a.

    • Perintah

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

      Jika perintah berhasil dijalankan, tidak ada respons yang dikembalikan. Anda dapat menjalankan perintah berikut untuk menanyakan detail logstore.

      aliyunlog log get_logstore --project_name="aliyun-test-project" --logstore_name="logstore-a" --format-output=json
  • Gunakan akun bernama test untuk membuat logstore bernama logstore-b.

    • Perintah

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

      Jika perintah berhasil dijalankan, tidak ada respons yang dikembalikan. Anda dapat menjalankan perintah berikut untuk menanyakan detail logstore:

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

      Contoh respons:

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

Referensi