全部产品
Search
文档中心

Simple Log Service:update_logstore

更新时间:Jul 06, 2025

Memperbarui informasi dasar tentang logstore.

Catatan penggunaan

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

Sintaks perintah

aliyunlog log update_logstore --project_name=<value> --logstore_name=<value> [--ttl=<value>] [--enable_tracking=<value>] [--shard_count=<value>] [--append_meta=<value>] [--auto_split=<value>] [--max_split_shard=<value>] [--preserve_storage=<value>] [--encrypt_conf=<value>] [--hot_ttl=<value>] [--mode=<value>] [--telemetry_type=<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 menggambarkan parameter yang diperlukan untuk perintah ini serta parameter spesifik perintah ini.

Parameter

Tipe

Diperlukan

Contoh

Deskripsi

--project_name

String

Ya

aliyun-test-project

Nama proyek. Proyek dalam Layanan Log Sederhana digunakan untuk mengisolasi sumber daya pengguna yang berbeda dan mengontrol akses ke sumber daya tertentu. Lihat Kelola 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 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 Akses Jarang (IA), yang ditentukan oleh parameter infrequent_access_ttl

  • Periode retensi data untuk tier penyimpanan Arsip

Penting

Jika Anda mengubah periode retensi, Layanan Log Sederhana akan menghapus semua data yang kedaluwarsa dalam waktu 1 jam. Volume data yang ditampilkan untuk Rincian Penggunaan di halaman utama konsol Layanan Log Sederhana diperbarui pada hari berikutnya. Misalnya, jika Anda mengubah periode retensi dari lima hari menjadi satu hari, Layanan Log Sederhana akan menghapus data log dari empat hari sebelumnya dalam waktu 1 jam.

--shard_count

Integer

Tidak

2

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

Penting

Anda tidak dapat mengubah jumlah shard dengan menjalankan perintah update_logstore. Untuk mengubah jumlah shard, Anda dapat memanggil operasi SplitShard dan MergeShard.

--enable_tracking

Boolean

Tidak

true

Menentukan apakah akan mengaktifkan fitur pelacakan web. Nilai valid:

  • true

  • false

--append_meta

Boolean

Tidak

false

Menentukan apakah akan mencatat alamat IP publik. Nilai valid:

  • true

  • false

--auto_split

Boolean

Tidak

true

Menentukan apakah akan mengaktifkan sharding otomatis. Nilai valid:

  • true

  • false

--max_split_shard

Integer

Tidak

64

Jumlah maksimum shard ke mana shard yang ada dapat dibagi secara otomatis. Nilai valid: 1 hingga 256. Jika Anda menetapkan --autoSplit 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

--hot_ttl

Integer

Tidak

7

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. Layanan Log Sederhana menyediakan dua tipe logstore: Logstore Standar dan Logstore Query. Nilai valid:

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

  • query: Logstore Query. Tipe logstore ini mendukung kueri berperforma tinggi. Biaya lalu lintas indeks Logstore Query sekitar setengah dari Logstore Standar. Logstore Query tidak mendukung pernyataan SELECT. Logstore Query cocok untuk skenario di mana jumlah data besar, periode retensi log panjang, atau analisis log tidak diperlukan. Jika log disimpan selama minggu atau bulan, periode retensi log dianggap panjang. Untuk informasi lebih lanjut, lihat Lampiran: perbandingan logstore berdasarkan tipe.

--infrequent_access_ttl

Integer

Tidak

30

Periode retensi data untuk tier penyimpanan IA. Unit: hari. Data di tier penyimpanan IA harus disimpan setidaknya 30 hari sebelum data dapat dipindahkan ke tier penyimpanan Arsip. Untuk informasi lebih lanjut, lihat Konfigurasikan penyimpanan bertingkat cerdas.

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

Contoh perintah

  • Perintah

    Gunakan akun default untuk memperbarui informasi tentang logstore-a.

    aliyunlog log update_logstore --project_name="aliyun-test-project" --logstore_name="logstore-a" --ttl=30 --enable_tracking=true 
  • 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

Referensi