All Products
Search

This Product

    Simple Log Service:Buat konfigurasi Logtail

    Document Center

    Simple Log Service:Buat konfigurasi Logtail

    Last Updated:Jul 06, 2025

    Gunakan API CreateConfig untuk membuat konfigurasi Logtail.

    Prasyarat

    Deskripsi Parameter

    def create_logtail_config(self, project_name, config_detail):

    Parameter Permintaan

    Parameter

    Tipe

    Diperlukan

    Deskripsi

    project_name

    string

    Ya

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

    config_detail

    LogtailConfig

    Ya

    Informasi tentang konfigurasi Logtail. Metode berikut didukung: LogtailConfigGenerator, SeperatorFileConfigDetail, SimpleFileConfigDetail, FullRegFileConfigDetail, JsonFileConfigDetail, ApsaraFileConfigDetail, dan SyslogConfigDetail.

    Contoh ini menggunakan metode SimpleFileConfigDetail untuk menghasilkan objek konfigurasi untuk pengumpulan log teks sederhana.

    Deskripsi parameter SimpleFileConfigDetail parameter

    Nama

    Tipe

    Diperlukan

    Deskripsi

    logstoreName

    string

    Ya

    Nama logstore. Logstore dalam Simple Log Service digunakan untuk mengumpulkan, menyimpan, dan menanyakan log. Lihat Kelola logstore.

    configName

    string

    Ya

    Nama konfigurasi Logtail harus unik di dalam sebuah proyek dan tidak dapat diubah setelah dibuat. Untuk informasi lebih lanjut, lihat Apa itu Logtail?

    Nama tersebut harus memenuhi persyaratan berikut:

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

    • Harus dimulai dan diakhiri dengan huruf kecil atau angka.

    • Harus memiliki panjang 2 hingga 128 karakter.

    logPath

    string

    Ya

    Jalur absolut file log.

    filePattern

    string

    Ya

    Nama file log. Karakter wildcard * didukung.

    localStorage

    bool

    Tidak

    Menentukan apakah akan mengaktifkan cache lokal.

    • True (default): Gunakan 1 GB cache lokal saat Logtail offline.

    • False: Jangan aktifkan cache lokal.

    enableRawLog

    bool

    Tidak

    Menentukan apakah akan mengunggah log mentah. Nilai valid:

    • True: Unggah log mentah.

    • False (default): Jangan unggah log mentah.

    topicFormat

    string

    Tidak

    Metode yang digunakan untuk menghasilkan topik. Nilai valid:

    • none (default): Jangan hasilkan topik log.

    • group_topic: Gunakan topik grup mesin tempat konfigurasi Logtail diterapkan sebagai topik log.

    • Ekspresi reguler yang digunakan untuk mencocokkan jalur file log: Sebagian dari jalur file log digunakan sebagai topik log yang dikumpulkan. Contohnya, /var/log/(.*).log.

    Untuk informasi lebih lanjut, lihat Topik log.

    fileEncoding

    string

    Tidak

    Format File Encoding log. Nilai valid: utf8 dan gbk.

    maxDepth

    int

    Tidak

    Tetapkan Maximum Directory Monitoring Depth untuk log. Nilai valid: 0 hingga 1000. Nilai 0 menunjukkan bahwa hanya direktori file log yang ditentukan yang dipantau.

    preserve

    bool

    Tidak

    Menentukan strategi waktu habis.

    Nilai valid:

    • True (default): Tidak pernah habis waktu.

    • False: Jika file log tidak diperbarui dalam 30 menit, Logtail menganggapnya habis waktu dan berhenti memantaunya.

    preserveDepth

    string

    Tidak

    Kedalaman direktori maksimum untuk waktu habis. Parameter ini diperlukan saat preserve disetel ke False. Nilai valid: 1 hingga 3.

    filterKey

    list

    Tidak

    Hanya log dengan nilai bidang yang cocok dengan ekspresi reguler yang ditentukan oleh filterRegex yang dikumpulkan.

    filterRegex

    string

    Tidak

    Ekspresi reguler yang sesuai dengan filterKey.

    filterRegex dan filterKey harus memiliki jumlah elemen yang sama.

    Parameter Respon

    Untuk informasi lebih lanjut tentang parameter respon, lihat CreateConfig.

    Kode contoh

    from aliyun.log import LogClient
from aliyun.log.logtail_config_detail import SimpleFileConfigDetail
import os

# Dalam contoh ini, ID AccessKey dan Rahasia AccessKey diperoleh dari variabel lingkungan.
access_key_id = os.environ.get('ALIBABA_CLOUD_ACCESS_KEY_ID', '')
access_key_secret = os.environ.get('ALIBABA_CLOUD_ACCESS_KEY_SECRET', '')

# Tentukan titik akhir Simple Log Service.
endpoint = "ap-southeast-1.log.aliyuncs.com"

client = LogClient(endpoint, access_key_id, access_key_secret)


project = "slsproject-1"
logstore = "logstore-1"
configName = logstore + "-stt1-logtail"
logPath = "/data/logs"
filePattern = "*.log"


# Buat konfigurasi pengumpulan log teks sederhana
def main():
    try:
        config_detail = SimpleFileConfigDetail(logstore, configName, logPath, filePattern)
        res = client.create_logtail_config(project, config_detail)
        res.log_print()
    except Exception as error:
        print(error)


if __name__ == '__main__':
    main()

    Respon contoh

    CreateLogtailConfigResponse:
headers: {'Server': 'AliyunSLS', 'Content-Length': '0', 'Connection': 'keep-alive', 'Access-Control-Allow-Origin': '*', 'Date': 'Fri, 22 Nov 2024 06:40:40 GMT', 'x-log-time': '1732257640', 'x-log-requestid': '67402768AA8C117B143D****'}

Proses selesai dengan kode keluar 0

    Referensi