All Products
Search
Document Center

Simple Log Service:UpdateLogtailPipelineConfig

Last Updated:Jun 11, 2026

Memperbarui konfigurasi pipeline Logtail.

Coba sekarang

Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

Test

RAM authorization

Tabel berikut menjelaskan otorisasi yang diperlukan untuk memanggil API ini. Anda dapat menentukannya dalam kebijakan Resource Access Management (RAM). Kolom pada tabel dijelaskan sebagai berikut:

  • Action: Aksi yang dapat digunakan dalam elemen Action pada pernyataan kebijakan izin RAM untuk memberikan izin guna melakukan operasi tersebut.

  • API: API yang dapat Anda panggil untuk melakukan aksi tersebut.

  • Access level: Tingkat akses yang telah ditentukan untuk setiap API. Nilai yang valid: create, list, get, update, dan delete.

  • Resource type: Jenis resource yang mendukung otorisasi untuk melakukan aksi tersebut. Ini menunjukkan apakah aksi tersebut mendukung izin tingkat resource. Resource yang ditentukan harus kompatibel dengan aksi tersebut. Jika tidak, kebijakan tersebut tidak akan berlaku.

    • Untuk API dengan izin tingkat resource, jenis resource yang diperlukan ditandai dengan tanda bintang (*). Tentukan Nama Sumber Daya Alibaba Cloud (ARN) yang sesuai dalam elemen Resource pada kebijakan.

    • Untuk API tanpa izin tingkat resource, ditampilkan sebagai All Resources. Gunakan tanda bintang (*) dalam elemen Resource pada kebijakan.

  • Condition key: Kunci kondisi yang didefinisikan oleh layanan. Kunci ini memungkinkan kontrol granular, berlaku baik hanya untuk aksi maupun untuk aksi yang terkait dengan resource tertentu. Selain kunci kondisi spesifik layanan, Alibaba Cloud menyediakan serangkaian common condition keys yang berlaku di semua layanan yang didukung RAM.

  • Dependent action: Aksi dependen yang diperlukan untuk menjalankan aksi tersebut. Untuk menyelesaikan aksi tersebut, pengguna RAM atau role RAM harus memiliki izin untuk melakukan semua aksi dependen.

Action

Access level

Resource type

Condition key

Dependent action

log:UpdateLogtailPipelineConfig

update

*All Resource

*

  • log:TLSVersion
None

Sintaks permintaan

PUT /pipelineconfigs/{configName} HTTP/1.1

Path Parameters

Parameter

Type

Required

Description

Example

configName

string

Yes

Nama konfigurasi pipeline Logtail.

test-config

Parameter permintaan

Parameter

Type

Required

Description

Example

project

string

Yes

Nama project.

test-project

body

object

No

Konten konfigurasi pipeline Logtail.

configName

string

Yes

Nama konfigurasi.

Penting

Nama harus sama dengan nilai parameter configName di path request.

test-config

logSample

string

No

Contoh log. Mendukung banyak log.

2022-06-14 11:13:29.796 | DEBUG | __main__::1 - hello world

global

object

No

Konfigurasi global.

inputs

array<object>

Yes

Daftar plug-in input.

Penting

Saat ini, Anda hanya dapat mengonfigurasi satu plug-in input.

object

No

Plug-in input.

Catatan

Untuk parameter plug-in input file, lihat Plug-in File. Untuk parameter plug-in input lainnya, lihat Plug-in pemrosesan.

{ "Type": "input_file", "FilePaths": ["/var/log/*.log"] }

processors

array<object>

No

Daftar plug-in pemrosesan.

Catatan

Plug-in pemrosesan diklasifikasikan menjadi plug-in pemrosesan native dan plug-in pemrosesan ekstensi. Untuk informasi lebih lanjut, lihat Plug-in pemrosesan.

Penting
Catatan
  • Plug-in native hanya dapat digunakan untuk mengumpulkan log teks.

  • Anda tidak dapat menambahkan plug-in native dan plug-in ekstensi pada saat yang sama.

  • Ketika Anda menggunakan plug-in native, persyaratan berikut harus dipenuhi:

    • Plug-in pemrosesan pertama harus berupa plug-in parsing berbasis ekspresi reguler, plug-in parsing berbasis separator, plug-in parsing berbasis JSON, plug-in parsing berbasis NGINX, plug-in parsing berbasis Apache, atau plug-in parsing berbasis IIS.

    • Setelah plug-in pemrosesan pertama, Anda hanya dapat menambahkan satu plug-in parsing waktu, satu plug-in filter, dan beberapa plug-in masking data.

object

No

Plug-in pemrosesan.

Catatan

Untuk informasi lebih lanjut, lihat Plug-in pemrosesan.

{ "Type": "processor_parse_json_native", "SourceKey": "content" }

aggregators

array<object>

No

Daftar plug-in aggregator.

Penting

Parameter ini hanya valid jika Anda menggunakan plug-in pemrosesan ekstensi. Anda dapat menggunakan maksimum satu plug-in aggregator.

object

No

Plug-in aggregator.

flushers

array<object>

Yes

Daftar plug-in output.

Penting

Saat ini, Anda hanya dapat menambahkan satu plug-in output SLS.

object

No

Plug-in output.

{ "Type": "flusher_sls", "Logstore": "test" }

task

object

No

Konfigurasi global

ParameterTipeWajibNilai defaultContohDeskripsi
TopicTypestringTidakKosongfilepathJenis topik. Nilai yang valid:* filepath: mengekstrak informasi dari path file log sebagai topik. Nilai ini hanya valid jika plug-in input adalah input_file.
* machine_group_topic: menggunakan topik dari grup mesin tempat konfigurasi diterapkan.
* custom: menggunakan topik kustom. Untuk informasi lebih lanjut, lihat Topik log.
TopicFormatstringYa, jika TopicType diatur ke filepath atau custom.//var/log/(.*).logFormat topik.
EnableTimestampNanosecondboolTidakfalsefalseMenentukan apakah akan mengaktifkan presisi nanodetik untuk timestamp.
PipelineMetaTagKeyobjectTidakKosong{"HOST_NAME":"hostname"}
Penting Parameter ini hanya didukung oleh LoongCollector 3.0.10 dan yang lebih baru.
Mengontrol tag yang terkait dengan informasi LoongCollector. Key adalah nama parameter tag, dan value adalah nama field dari tag dalam log. Jika nilainya adalah default, nilai default digunakan. Jika nilainya adalah string kosong, tag akan dihapus. Tag berikut dapat dikonfigurasi:* HOST_NAME: nama host. Tag ini ditambahkan secara default. Nilai default adalah "__hostname__".
* AGENT_TAG: identifier kustom. Tag ini ditambahkan secara default. Nilai default adalah "__user_defined_id__".
* HOST_ID: ID host. Tag ini tidak ditambahkan secara default. Nilai default adalah "__host_id__".
* CLOUD_PROVIDER: Tag ini tidak ditambahkan secara default. Nilai default adalah "__cloud_provider__".

Plug-in input

Plug-in input File

ParameterTipeWajibNilai defaultContohDeskripsi
TypestringYa/input_fileJenis plug-in. Atur nilai ke input_file.
FilePaths[string]Ya/["/var/log/*.log"]Daftar path ke file log yang akan dikumpulkan. Saat ini hanya satu path yang diizinkan. Anda dapat menggunakan karakter wildcard tanda bintang (*) dan tanda bintang ganda () dalam path. Karakter wildcard tanda bintang ganda () hanya boleh muncul sekali dan harus digunakan sebelum nama file.
MaxDirSearchDepthuintTidak00Kedalaman maksimum subdirektori yang dapat dicocokkan oleh karakter wildcard tanda bintang ganda () dalam path file. Parameter ini hanya valid jika karakter wildcard tanda bintang ganda () digunakan dalam path log. Nilai yang valid: 0 hingga 1000.
ExcludeFilePaths[string]TidakKosong["/home/admin/*.log"]Blacklist path file. Path harus berupa path absolut. Karakter wildcard tanda bintang (*) didukung.
ExcludeFiles[string]TidakKosong["app*.log", "password"]Blacklist nama file. Karakter wildcard tanda bintang (*) didukung.
ExcludeDirs[string]TidakKosong["/home/admin/dir1", "/home/admin/dir2*"]Blacklist direktori. Path harus berupa path absolut. Karakter wildcard tanda bintang (*) didukung.
FileEncodingstringTidakutf8utf8Format encoding file. Nilai yang valid: utf8 dan gbk.
TailSizeKBuintTidak10241024Posisi pengumpulan awal dari file yang cocok ketika konfigurasi pertama kali berlaku, diukur dari akhir file. Jika ukuran file lebih kecil dari nilai ini, pengumpulan dimulai dari awal. Nilai yang valid: 0 hingga 10485760 KB.
MultilineobjectTidakKosong/Opsi agregasi multiline.
Multiline.ModestringTidakcustomcustomMode agregasi multiline. Nilai yang valid: custom dan JSON.
Multiline.StartPatternstringWajib jika Multiline.Mode diatur ke custom.Kosong\d+-\d+-\d+.*Ekspresi reguler untuk awal baris.
EnableContainerDiscoveryboolTidakfalsetrueMenentukan apakah akan mengaktifkan penemuan container. Parameter ini hanya valid jika Logtail berjalan dalam mode DaemonSet dan path file yang dikumpulkan adalah path di dalam container.
ContainerFiltersobjectTidakKosong/Opsi pemfilteran container. Hubungan antara beberapa opsi adalah "AND". Parameter ini hanya valid jika EnableContainerDiscovery diatur ke true.
ContainerFilters.K8sNamespaceRegexstringTidakKosongdefaultUntuk container yang di-deploy di environment Kubernetes, menentukan kondisi untuk namespace dari pod tempat container yang akan dikumpulkan berada. Jika Anda tidak menambahkan parameter ini, semua container dikumpulkan. Ekspresi reguler didukung.
ContainerFilters.K8sPodRegexstringTidakKosongtest-podUntuk container yang di-deploy di environment Kubernetes, menentukan kondisi untuk nama pod tempat container yang akan dikumpulkan berada. Jika Anda tidak menambahkan parameter ini, semua container dikumpulkan. Ekspresi reguler didukung.
ContainerFilters.IncludeK8sLabelmapTidakKosong/Untuk container yang di-deploy di environment Kubernetes, menentukan kondisi label untuk pod tempat container yang akan dikumpulkan berada. Hubungan antara beberapa kondisi adalah "OR". Jika Anda tidak menambahkan parameter ini, semua container dikumpulkan. Ekspresi reguler didukung. Key dari map adalah nama label pod, dan value adalah nilai label pod. Aturan berikut berlaku:* Jika value dalam map kosong, pod mana pun yang memiliki label dengan key yang ditentukan akan dicocokkan.
* Jika value dalam map tidak kosong:
- Jika value dimulai dengan ^ dan diakhiri dengan $, pod dicocokkan jika memiliki label dengan key yang ditentukan dan nilai label cocok dengan ekspresi reguler.
- Dalam kasus lain, pod dicocokkan jika memiliki label dengan key yang ditentukan dan nilai label sama dengan value yang ditentukan.
ContainerFilters.ExcludeK8sLabelmapTidakKosong/Untuk container yang di-deploy di environment Kubernetes, menentukan kondisi label untuk pod tempat container yang akan dikecualikan dari pengumpulan berada. Hubungan antara beberapa kondisi adalah "OR". Jika Anda tidak menambahkan parameter ini, semua container dikumpulkan. Ekspresi reguler didukung. Key dari map adalah nama label pod, dan value adalah nilai label pod. Aturan berikut berlaku:* Jika value dalam map kosong, pod mana pun yang memiliki label dengan key yang ditentukan akan dicocokkan.
* Jika value dalam map tidak kosong:
- Jika value dimulai dengan ^ dan diakhiri dengan $, pod dicocokkan jika memiliki label dengan key yang ditentukan dan nilai label cocok dengan ekspresi reguler.
- Dalam kasus lain, pod dicocokkan jika memiliki label dengan key yang ditentukan dan nilai label sama dengan value yang ditentukan.
ContainerFilters.K8sContainerRegexstringTidakKosongtest-containerUntuk container yang di-deploy di environment Kubernetes, menentukan kondisi untuk nama container yang akan dikumpulkan. Jika Anda tidak menambahkan parameter ini, semua container dikumpulkan. Ekspresi reguler didukung.
ContainerFilters.IncludeEnvmapTidakKosong/Menentukan kondisi variabel environment untuk container yang akan dikumpulkan. Hubungan antara beberapa kondisi adalah "OR". Jika Anda tidak menambahkan parameter ini, semua container dikumpulkan. Ekspresi reguler didukung. Key dari map adalah nama variabel environment, dan value adalah nilai variabel environment. Aturan berikut berlaku:* Jika value dalam map kosong, container mana pun yang memiliki variabel environment dengan key yang ditentukan akan dicocokkan.
* Jika value dalam map tidak kosong:
- Jika value dimulai dengan ^ dan diakhiri dengan $, container dicocokkan jika memiliki variabel environment dengan key yang ditentukan dan nilai variabel cocok dengan ekspresi reguler.
- Dalam kasus lain, container dicocokkan jika memiliki variabel environment dengan key yang ditentukan dan nilai variabel sama dengan value yang ditentukan.
ContainerFilters.ExcludeEnvmapTidakKosong/Menentukan kondisi variabel environment untuk container yang akan dikecualikan dari pengumpulan. Hubungan antara beberapa kondisi adalah "OR". Jika Anda tidak menambahkan parameter ini, semua container dikumpulkan. Ekspresi reguler didukung. Key dari map adalah nama variabel environment, dan value adalah nilai variabel environment. Aturan berikut berlaku:* Jika value dalam map kosong, container mana pun yang memiliki variabel environment dengan key yang ditentukan akan dicocokkan.
* Jika value dalam map tidak kosong:
- Jika value dimulai dengan ^ dan diakhiri dengan $, container dicocokkan jika memiliki variabel environment dengan key yang ditentukan dan nilai variabel cocok dengan ekspresi reguler.
- Dalam kasus lain, container dicocokkan jika memiliki variabel environment dengan key yang ditentukan dan nilai variabel sama dengan value yang ditentukan.
ContainerFilters.IncludeContainerLabelmapTidakKosong/Menentukan kondisi label untuk container yang akan dikumpulkan. Hubungan antara beberapa kondisi adalah "OR". Jika Anda tidak menambahkan parameter ini, nilai default kosong, yang berarti semua container dikumpulkan. Ekspresi reguler didukung. Key dari map adalah nama label container, dan value adalah nilai label container. Aturan berikut berlaku:* Jika value dalam map kosong, container mana pun yang memiliki label dengan key yang ditentukan akan dicocokkan.
* Jika value dalam map tidak kosong:
- Jika value dimulai dengan ^ dan diakhiri dengan $, container dicocokkan jika memiliki label dengan key yang ditentukan dan nilai label cocok dengan ekspresi reguler.
- Dalam kasus lain, container dicocokkan jika memiliki label dengan key yang ditentukan dan nilai label sama dengan value yang ditentukan.
ContainerFilters.ExcludeContainerLabelmapTidakKosong/Menentukan kondisi label untuk container yang akan dikecualikan dari pengumpulan. Hubungan antara beberapa kondisi adalah "OR". Jika Anda tidak menambahkan parameter ini, nilai default kosong, yang berarti semua container dikumpulkan. Ekspresi reguler didukung. Key dari map adalah nama label container, dan value adalah nilai label container. Aturan berikut berlaku:* Jika value dalam map kosong, container mana pun yang memiliki label dengan key yang ditentukan akan dicocokkan.
* Jika value dalam map tidak kosong:
- Jika value dimulai dengan ^ dan diakhiri dengan $, container dicocokkan jika memiliki label dengan key yang ditentukan dan nilai label cocok dengan ekspresi reguler.
- Dalam kasus lain, container dicocokkan jika memiliki label dengan key yang ditentukan dan nilai label sama dengan value yang ditentukan.
ExternalK8sLabelTagmapTidakKosong/Untuk container yang di-deploy di environment Kubernetes, menentukan tag terkait label pod yang akan ditambahkan ke log. Key dari map adalah nama label pod, dan value adalah nama tag yang sesuai. Misalnya, jika Anda menambahkan app: k8s_label_app ke map, dan sebuah pod memiliki label app=serviceA, informasi ini ditambahkan ke log sebagai tag, yang berarti field __tag__:k8s_label_app: serviceA ditambahkan. Jika pod tidak memiliki label app, field kosong __tag__:k8s_label_app: ditambahkan.
ExternalEnvTagmapTidakKosong/Untuk container yang di-deploy di environment Kubernetes, menentukan tag terkait variabel environment container yang akan ditambahkan ke log. Key dari map adalah nama variabel environment, dan value adalah nama tag yang sesuai. Misalnya, jika Anda menambahkan VERSION: env_version ke map, dan sebuah container memiliki variabel environment VERSION=v1.0.0, informasi ini ditambahkan ke log sebagai tag, yang berarti field __tag__:env_version: v1.0.0 ditambahkan. Jika container tidak memiliki variabel environment VERSION, field kosong __tag__:env_version: ditambahkan.
CollectingContainersMetaboolTidakfalsetrueMenentukan apakah akan mengaktifkan preview metadata container.
AppendingLogPositionMetaboolTidakfalsefalseMenentukan apakah akan menambahkan metadata dari file tempat log berada ke log. Metadata mencakup field tag:inode dan field file_offset.
AllowingIncludedByMultiConfigsboolTidakfalsefalseMenentukan apakah akan mengizinkan konfigurasi saat ini untuk mengumpulkan file yang telah dicocokkan oleh konfigurasi lain.
TagsobjectTidakKosong{"FileInodeTagKey":"inode"}
Penting Parameter ini hanya didukung oleh LoongCollector 3.0.10 dan yang lebih baru.
Mengontrol tag yang terkait dengan pengumpulan file. Key adalah nama parameter tag, dan value adalah nama field dari tag dalam log. Jika nilainya adalah default, nilai default digunakan. Jika nilainya adalah string kosong, tag akan dihapus. Tag berikut dapat dikonfigurasi:* FileInodeTagKey: inode file. Tag ini tidak ditambahkan secara default. Nilai default adalah "__inode__".
* FilePathTagKey: path file. Tag ini ditambahkan secara default. Nilai default adalah "__path__".Parameter berikut hanya valid jika parameter EnableContainerDiscovery diatur ke true.* K8sNamespaceTagKey: namespace container tempat file berada. Tag ini ditambahkan secara default. Nilai default adalah "_namespace_".
* K8sPodNameTagKey: nama pod tempat file berada. Tag ini ditambahkan secara default. Nilai default adalah "_pod_name_".
* K8sPodUidTagKey: UID pod tempat file berada. Tag ini ditambahkan secara default. Nilai default adalah "_pod_uid_".
* ContainerNameTagKey: nama container tempat file berada. Tag ini ditambahkan secara default. Nilai default adalah "_container_name_".
* ContainerIpTagKey: alamat IP container tempat file berada. Tag ini ditambahkan secara default. Nilai default adalah "_container_ip_".
* ContainerImageNameTagKey: image container tempat file berada. Tag ini ditambahkan secara default. Nilai default adalah "_image_name_".
FileOffsetKeystringTidakKosong_file_offset_
Penting Parameter ini hanya didukung oleh LoongCollector 3.0.10 dan yang lebih baru.
Tag untuk posisi log dalam file. Tag ini tidak ditambahkan secara default. Nilai default adalah file_offset. Jika nilainya adalah default, nilai default digunakan. Jika nilainya adalah string kosong, tag akan dihapus. Jika parameter EnableLogPositionMeta ada bersamaan dengan parameter Tags.FileInodeTagKey atau FileOffsetKey, parameter EnableLogPositionMeta akan diabaikan.

Container stdout (legacy)

ParameterTipeWajibNilai defaultContohDeskripsi
TypestringYa/service_docker_stdoutJenis plug-in. Atur nilai ke service_docker_stdout.
StdoutBooleanTidaktruetrueMenentukan apakah akan mengumpulkan standard output (stdout).
StderrBooleanTidaktruetrueMenentukan apakah akan mengumpulkan standard error (stderr).
StartLogMaxOffsetIntegerTidak128 × 1024131072Panjang data historis yang akan diambil selama pengumpulan pertama, dalam byte. Kami merekomendasikan nilai antara 131072 dan 1048576.
IncludeLabelMap, dengan LabelKey dan LabelValue bertipe StringTidakKosongWhitelist label container, digunakan untuk menentukan container yang akan dikumpulkan. Nilai default adalah kosong, yang berarti standard output semua container dikumpulkan. Jika Anda ingin mengatur whitelist label container, LabelKey wajib, dan LabelValue bersifat opsional.
- Jika LabelValue kosong, container mana pun yang memiliki label dengan LabelKey yang ditentukan akan dicocokkan.
- Jika LabelValue tidak kosong, hanya container yang memiliki label dengan LabelKey=LabelValue yang ditentukan yang akan dicocokkan.
Secara default, LabelValue dicocokkan sebagai string, artinya kecocokan hanya terjadi jika LabelValue identik dengan nilai label container. Jika nilainya dimulai dengan ^ dan diakhiri dengan $, itu adalah pencocokan ekspresi reguler. Misalnya, jika Anda mengatur LabelKey ke io.kubernetes.container.name dan LabelValue ke `^(nginx
ExcludeLabelMap, dengan LabelKey dan LabelValue bertipe StringTidakKosongBlacklist label container, digunakan untuk mengecualikan container dari pengumpulan. Nilai default adalah kosong, yang berarti tidak ada container yang dikecualikan. Jika Anda ingin mengatur blacklist label container, LabelKey wajib, dan LabelValue bersifat opsional.
- Jika LabelValue kosong, container mana pun yang memiliki label dengan LabelKey yang ditentukan akan dikecualikan.
- Jika LabelValue tidak kosong, hanya container yang memiliki label dengan LabelKey=LabelValue yang ditentukan yang akan dikecualikan.
Secara default, LabelValue dicocokkan sebagai string, artinya kecocokan hanya terjadi jika LabelValue identik dengan nilai label container. Jika nilainya dimulai dengan ^ dan diakhiri dengan $, itu adalah pencocokan ekspresi reguler. Misalnya, jika Anda mengatur LabelKey ke io.kubernetes.container.name dan LabelValue ke `^(nginx
IncludeEnvMap, dengan EnvKey dan EnvValue bertipe StringTidakKosongWhitelist variabel environment, digunakan untuk menentukan container yang akan dikumpulkan. Nilai default adalah kosong, yang berarti standard output semua container dikumpulkan. Jika Anda ingin mengatur whitelist variabel environment, EnvKey wajib, dan EnvValue bersifat opsional.
- Jika EnvValue kosong, container mana pun yang memiliki variabel environment dengan EnvKey yang ditentukan akan dicocokkan.
- Jika EnvValue tidak kosong, hanya container yang memiliki variabel environment dengan EnvKey=EnvValue yang ditentukan yang akan dicocokkan.
Secara default, EnvValue dicocokkan sebagai string, artinya kecocokan hanya terjadi jika EnvValue identik dengan nilai variabel environment. Jika nilainya dimulai dengan ^ dan diakhiri dengan $, itu adalah pencocokan ekspresi reguler. Misalnya, jika Anda mengatur EnvKey ke NGINX_SERVICE_PORT dan EnvValue ke `^(80
ExcludeEnvMap, dengan EnvKey dan EnvValue bertipe StringTidakKosongBlacklist variabel environment, digunakan untuk mengecualikan container dari pengumpulan. Nilai default adalah kosong, yang berarti tidak ada container yang dikecualikan. Jika Anda ingin mengatur blacklist variabel environment, EnvKey wajib, dan EnvValue bersifat opsional.
- Jika EnvValue kosong, log container mana pun yang memiliki variabel environment dengan EnvKey yang ditentukan akan dikecualikan.
- Jika EnvValue tidak kosong, hanya container yang memiliki variabel environment dengan EnvKey=EnvValue yang ditentukan yang akan dikecualikan.
Secara default, EnvValue dicocokkan sebagai string, artinya kecocokan hanya terjadi jika EnvValue identik dengan nilai variabel environment. Jika nilainya dimulai dengan ^ dan diakhiri dengan $, itu adalah pencocokan ekspresi reguler. Misalnya, jika Anda mengatur EnvKey ke NGINX_SERVICE_PORT dan EnvValue ke `^(80
IncludeK8sLabelMap, dengan LabelKey dan LabelValue bertipe StringTidakKosongWhitelist label Kubernetes (didefinisikan di template.metadata), digunakan untuk menentukan container yang akan dikumpulkan. Jika Anda ingin mengatur whitelist label Kubernetes, LabelKey wajib, dan LabelValue bersifat opsional.
- Jika LabelValue kosong, container mana pun yang memiliki label Kubernetes dengan LabelKey yang ditentukan akan dicocokkan.
- Jika LabelValue tidak kosong, hanya container yang memiliki label Kubernetes dengan LabelKey=LabelValue yang ditentukan yang akan dicocokkan.
Secara default, LabelValue dicocokkan sebagai string, artinya kecocokan hanya terjadi jika LabelValue identik dengan nilai label Kubernetes. Jika nilainya dimulai dengan ^ dan diakhiri dengan $, itu adalah pencocokan ekspresi reguler. Misalnya, jika Anda mengatur LabelKey ke app dan LabelValue ke `^(test1
ExcludeK8sLabelMap, dengan LabelKey dan LabelValue bertipe StringTidakKosongBlacklist label Kubernetes (didefinisikan di template.metadata), digunakan untuk mengecualikan container dari pengumpulan. Jika Anda ingin mengatur blacklist label Kubernetes, LabelKey wajib, dan LabelValue bersifat opsional.
- Jika LabelValue kosong, container mana pun yang memiliki label Kubernetes dengan LabelKey yang ditentukan akan dikecualikan.
- Jika LabelValue tidak kosong, hanya container yang memiliki label Kubernetes dengan LabelKey=LabelValue yang ditentukan yang akan dikecualikan.
Secara default, LabelValue dicocokkan sebagai string, artinya kecocokan hanya terjadi jika LabelValue identik dengan nilai label Kubernetes. Jika nilainya dimulai dengan ^ dan diakhiri dengan $, itu adalah pencocokan ekspresi reguler. Misalnya, jika Anda mengatur LabelKey ke app dan LabelValue ke `^(test1
K8sNamespaceRegexStringTidakKosong^(defaultnginx)$
K8sPodRegexStringTidakKosong^(nginx-log-demo.*)$Menentukan container yang akan dikumpulkan berdasarkan nama pod. Ekspresi reguler didukung. Misalnya, jika Anda mengatur ini ke ^(nginx-log-demo.*)$, semua container di pod yang namanya dimulai dengan nginx-log-demo akan dicocokkan.
K8sContainerRegexStringTidakKosong^(container-test)$Menentukan container yang akan dikumpulkan berdasarkan nama container (nama container Kubernetes didefinisikan di spec.containers). Ekspresi reguler didukung. Misalnya, jika Anda mengatur ini ke ^(container-test)$, semua container bernama container-test akan dicocokkan.

Parameter pemrosesan data

ParameterTipeWajibNilai defaultContohDeskripsi
BeginLineRegexStringTidakKosongEkspresi reguler untuk mencocokkan awal baris.
Jika item konfigurasi ini kosong, itu menunjukkan mode satu baris.
Jika ekspresi ini cocok dengan awal sebuah baris, baris tersebut diperlakukan sebagai log baru. Jika tidak, baris ditambahkan ke log sebelumnya.
BeginLineCheckLengthIntegerTidakKosongPanjang yang akan diperiksa untuk pencocokan awal baris, dalam byte.
Nilai default adalah 10 × 1024 byte.
Jika ekspresi reguler untuk awal baris dapat dicocokkan dalam N byte pertama, kami merekomendasikan pengaturan parameter ini untuk meningkatkan efisiensi pencocokan awal baris.
BeginLineTimeoutMsIntegerTidakKosongPeriode timeout untuk pencocokan awal baris, dalam milidetik.
Nilai default adalah 3000 milidetik.
Jika tidak ada log baru muncul dalam 3000 milidetik, pencocokan berakhir, dan log terakhir diunggah ke Simple Log Service.
MaxLogSizeIntegerTidakKosongPanjang maksimum sebuah log, dalam byte. Nilai default adalah 0.
Nilai default adalah 512 × 1024 byte.
Jika panjang log melebihi nilai ini, sistem berhenti mencari awal baris dan mengunggah log secara langsung.
ExternalK8sLabelTagMap, dengan LabelKey dan LabelValue bertipe StringTidakKosongSetelah mengatur tag log label Kubernetes (didefinisikan di template.metadata), iLogtail menambahkan field terkait label Kubernetes ke log.
Misalnya, jika Anda mengatur LabelKey ke app dan LabelValue ke k8s_label_app, dan sebuah pod memiliki label app=serviceA, iLogtail menambahkan informasi ini ke log, yang berarti field k8s_label_app: serviceA ditambahkan. Jika pod tidak memiliki label bernama app, field kosong k8s_label_app: ditambahkan.
ExternalEnvTagMap, dengan EnvKey dan EnvValue bertipe StringTidakKosongSetelah mengatur tag log variabel environment container, iLogtail menambahkan field terkait variabel environment container ke log.
Misalnya, jika Anda mengatur EnvKey ke VERSION dan EnvValue ke env_version, dan sebuah container memiliki variabel environment VERSION=v1.0.0, informasi ini ditambahkan ke log sebagai tag, yang berarti field env_version: v1.0.0 ditambahkan. Jika container tidak memiliki variabel environment bernama VERSION, field kosong env_version: ditambahkan.

Variabel environment pemrosesan data

Variabel environmentTipeWajibNilai defaultContohDeskripsi
ALIYUN_LOG_ENV_TAGSStringTidakKosongSetelah mengatur tag log variabel environment global, iLogtail menambahkan field terkait variabel environment dari container iLogtail ke log. Beberapa nama variabel environment dipisahkan oleh GARIS VERTIKAL (

Plug-in input MySQL

ParameterTipeWajibNilai defaultContohDeskripsi
TypestringYa/service_mysqlJenis plug-in. Atur nilai ke service_mysql.
AddressstringTidak127.0.0.1:3306rm-*.mysql.rds.aliyuncs.comAlamat MySQL.
UserstringTidakrootrootUsername untuk login ke database MySQL.
PasswordstringTidakKosongPassword untuk pengguna login ke database MySQL. Jika Anda memiliki persyaratan keamanan yang tinggi, atur username dan password ke xxx. Setelah konfigurasi pengumpulan disinkronkan ke mesin Anda, temukan konfigurasi di file /usr/local/ilogtail/user_log_config.json dan modifikasi. Untuk informasi lebih lanjut, lihat Memodifikasi konfigurasi lokal.
Penting Jika Anda memodifikasi parameter ini di konsol, konfigurasi lokal akan ditimpa setelah sinkronisasi.
DataBasestringTidak/project_databaseNama database.
DialTimeOutMsintTidak50005000Periode timeout untuk koneksi ke database MySQL, dalam ms.
ReadTimeOutMsintTidak50005000Periode timeout untuk membaca hasil query MySQL, dalam ms.
StateMentstringTidak/Pernyataan SELECT. Jika CheckPoint diatur ke true, kondisi WHERE dalam pernyataan SELECT harus mencakup kolom checkpoint (CheckPointColumn). Anda dapat menggunakan tanda tanya (?) sebagai placeholder yang bekerja dengan kolom checkpoint. Misalnya, atur CheckPointColumn ke id, CheckPointStart ke 0, dan StateMent ke SELECT * from ... where id > ?. Setelah setiap pengumpulan, sistem menyimpan ID entri data terakhir sebagai checkpoint. Pada pengumpulan berikutnya, tanda tanya (?) dalam pernyataan query digantikan dengan ID yang sesuai dengan checkpoint tersebut.
LimitboolTidakfalsetrueMenentukan apakah akan menggunakan LIMIT untuk paging.* true: Gunakan LIMIT.
* false (default): Jangan gunakan LIMIT.Kami merekomendasikan penggunaan LIMIT untuk paging. Jika Limit diatur ke true, sistem secara otomatis menambahkan klausa LIMIT ke pernyataan SELECT selama query SQL.
PageSizeintTidak/10Ukuran halaman. Ini harus dikonfigurasi jika Limit diatur ke true.
MaxSyncSizeintTidak00Jumlah maksimum record yang akan disinkronkan dalam satu waktu. Nilai default adalah 0, yang berarti tidak ada batasan.
CheckPointboolTidakfalsetrueMenentukan apakah akan menggunakan checkpoint.* true: Gunakan checkpoint.
* false (default): Jangan gunakan checkpoint.Checkpoint dapat digunakan sebagai titik awal untuk pengumpulan data berikutnya untuk mengimplementasikan pengumpulan data inkremental.
CheckPointColumnstringTidakKosong1Nama kolom checkpoint. Ini harus dikonfigurasi jika CheckPoint diatur ke true. Peringatan Nilai dalam kolom ini harus inkremental. Jika tidak, data mungkin hilang. Nilai maksimum dalam setiap hasil query digunakan sebagai input untuk query berikutnya.
CheckPointColumnTypestringTidakKosongintTipe data kolom checkpoint. Tipe yang didukung adalah int dan time. Penyimpanan internal untuk tipe int adalah int64. Tipe time mendukung tipe date, datetime, dan time MySQL. Ini harus dikonfigurasi jika CheckPoint diatur ke true.
CheckPointStartstringTidakKosongNilai awal kolom checkpoint. Ini harus dikonfigurasi jika CheckPoint diatur ke true.
CheckPointSavePerPageboolTidaktruetrueMenentukan apakah akan menyimpan checkpoint untuk setiap halaman.* true (default): Simpan checkpoint untuk setiap halaman.
* false: Simpan checkpoint setelah setiap sinkronisasi selesai.
IntervalMsintTidak6000060000Interval sinkronisasi. Nilai default adalah 60000, dalam ms.

Plug-in input HTTP

ParameterTipeWajibNilai defaultContohDeskripsi
TypestringYa/metric_httpJenis plug-in. Atur nilai ke metric_http.
AddressstringYa/Daftar URL. Penting Harus dimulai dengan http atau https.
IntervalMsintYa/10Interval untuk setiap request, dalam ms.
MethodstringTidakGETGETNama metode request. Harus dalam huruf kapital.
BodystringTidakKosongKonten field HTTP Body.
HeadersmapTidakKosong{"key":"value"}Konten HTTP Header, misalnya, {"key":"value"}. Ganti dengan nilai yang sebenarnya.
PerAddressSleepMsintTidak100100Interval antara request untuk setiap URL dalam daftar Addresses, dalam ms.
ResponseTimeoutMsintTidak50005000Periode timeout request, dalam ms.
IncludeBodyboolTidakfalsetrueMenentukan apakah akan mengumpulkan Body request. Nilai default adalah false. Jika diatur ke true, konten Body request disimpan dalam key bernama content.
FollowRedirectsboolTidakfalsefalseMenentukan apakah akan menangani redireksi secara otomatis.
InsecureSkipVerifyboolTidakfalsefalseMenentukan apakah akan melewatkan pemeriksaan keamanan HTTPS.
ResponseStringMatchstringTidak/Melakukan pemeriksaan ekspresi reguler pada konten Body yang dikembalikan. Hasil pemeriksaan disimpan dalam key bernama response_match. Jika cocok, nilainya yes. Jika tidak cocok, nilainya no.

Plug-in input Syslog

ParameterTipeWajibNilai defaultContohDeskripsi
TypestringYa/service_syslogJenis plug-in. Atur nilai ke service_syslog.
AddressstringTidaktcp://127.0.0.1:9999Menentukan protokol, alamat, dan port untuk Logtail mendengarkan. Logtail mendengarkan dan memperoleh data log berdasarkan konfigurasi Logtail. Formatnya adalah [tcp/udp]://[ ip ]:[ port ]. Jika tidak dikonfigurasi, defaultnya adalah tcp://127.0.0.1:9999, yang berarti hanya dapat menerima log yang diteruskan secara lokal. Catatan* Protokol, alamat, dan nomor port pendengar yang diatur dalam konfigurasi Logtail harus sama dengan aturan penerusan yang diatur dalam file konfigurasi rsyslog.
* Jika server tempat Logtail diinstal memiliki beberapa alamat IP yang dapat menerima log, Anda dapat mengatur alamat ke 0.0.0.0 untuk mendengarkan semua alamat IP server.
ParseProtocolstringTidakKosongrfc3164Menentukan protokol yang digunakan untuk mem-parse log. Default-nya adalah kosong, yang berarti tidak ada parsing. Opsinya adalah:* Kosong: Tidak ada parsing.
* rfc3164: Menentukan penggunaan protokol RFC3164 untuk mem-parse log.
* rfc5424: Menentukan penggunaan protokol RFC5424 untuk mem-parse log.
auto: Menentukan bahwa Logtail secara otomatis memilih protokol parsing yang sesuai berdasarkan konten log.
IgnoreParseFailureboolTidaktruetrueMenentukan tindakan yang akan diambil setelah kegagalan parsing. Jika tidak dikonfigurasi, default-nya adalah true, yang berarti parsing ditinggalkan, dan konten field yang dikembalikan diisi secara langsung. Jika diatur ke false, log dibuang ketika parsing gagal.

Plug-in input Systemd Journal

ParameterTipeWajibNilai defaultContohDeskripsi
TypestringYa/service_journalJenis plug-in. Atur nilai ke service_journal.
JournalPaths[string]YaKosong/var/log/journalPath log Journal. Kami merekomendasikan mengonfigurasi ini sebagai direktori tempat log Journal berada.
SeekPositionstringTidaktailtailMetode pengumpulan awal. Dapat diatur ke head atau tail.* head berarti mengumpulkan semua data.
* tail berarti hanya mengumpulkan data baru setelah konfigurasi pengumpulan Logtail diterapkan.
KernelboolTidaktruetrueMenentukan apakah akan mengumpulkan log kernel.
Units[string]TidakKosong""Daftar Unit yang akan dikumpulkan. Default-nya adalah kosong, yang berarti semua dikumpulkan.
ParseSyslogFacilityboolTidakfalsefalseMenentukan apakah akan mem-parse field facility dari log syslog. Jika tidak dikonfigurasi, tidak di-parse.
ParsePriorityboolTidakfalsefalseMenentukan apakah akan mem-parse field Priority. Jika tidak dikonfigurasi, tidak di-parse. Jika diatur ke true, hubungan pemetaan untuk field Priority adalah sebagai berikut. "0": "emergency" "1": "alert" "2": "critical" "3": "error" "4": "warning" "5": "notice" "6": "informational" "7": "debug"
UseJournalEventTimeboolTidakfalsefalseMenentukan apakah akan menggunakan field dari log Journal sebagai waktu log. Jika tidak dikonfigurasi, waktu pengumpulan digunakan sebagai waktu log. Pengumpulan log real-time biasanya memiliki perbedaan kurang dari 3 detik.

Plug-in input SQL Server

ParameterTipeWajibNilai defaultContohDeskripsi
TypestringYa/service_mssqlJenis plug-in. Atur nilai ke service_mssql.
AddressstringTidak127.0.0.1:1433rm-*.sqlserver.rds.aliyuncs.comAlamat SQL Server.
UserstringTidakrootrootNama akun untuk login ke database SQL Server.
PasswordstringTidakKosongPassword untuk akun login ke database SQL Server. Jika Anda memiliki persyaratan keamanan yang tinggi, atur username dan password ke xxx. Setelah konfigurasi pengumpulan disinkronkan ke mesin Anda, temukan konfigurasi di file /usr/local/ilogtail/user_log_config.json dan modifikasi. Untuk informasi lebih lanjut, lihat Memodifikasi konfigurasi lokal.
Penting Jika Anda memodifikasi parameter ini di konsol, konfigurasi lokal akan ditimpa setelah sinkronisasi.
DataBasestringTidak/project_databaseNama database.
DialTimeOutMsintTidak50005000Periode timeout untuk koneksi ke database SQL Server, dalam ms.
ReadTimeOutMsintTidak50005000Periode timeout untuk membaca hasil query SQL Server, dalam ms.
StateMentstringTidak/Pernyataan SELECT. Jika CheckPoint diatur ke true, kondisi WHERE dalam pernyataan SELECT harus mencakup kolom checkpoint (CheckPointColumn). Anda dapat menggunakan tanda tanya (?) sebagai placeholder yang bekerja dengan kolom checkpoint. Misalnya, atur CheckPointColumn ke id, CheckPointStart ke 0, dan StateMent ke SELECT * from ... where id > ?. Setelah setiap pengumpulan, sistem menyimpan ID entri data terakhir sebagai checkpoint. Pada pengumpulan berikutnya, tanda tanya (?) dalam pernyataan query digantikan dengan ID yang sesuai dengan checkpoint tersebut.
LimitboolTidakfalsetrueMenentukan apakah akan menggunakan LIMIT untuk paging.* true: Gunakan LIMIT.
* false (default): Jangan gunakan LIMIT.Kami merekomendasikan penggunaan LIMIT untuk paging. Jika Limit diatur ke true, sistem secara otomatis menambahkan klausa LIMIT ke pernyataan SELECT selama query SQL.
PageSizeintTidak/10Ukuran halaman. Ini harus dikonfigurasi jika Limit diatur ke true.
MaxSyncSizeintTidak00Jumlah maksimum record yang akan disinkronkan dalam satu waktu. Nilai default adalah 0, yang berarti tidak ada batasan.
CheckPointboolTidakfalsetrueMenentukan apakah akan menggunakan checkpoint.* true: Gunakan checkpoint.
* false (default): Jangan gunakan checkpoint.Checkpoint dapat digunakan sebagai titik awal untuk pengumpulan data berikutnya untuk mengimplementasikan pengumpulan data inkremental.
CheckPointColumnstringTidakKosong1Nama kolom checkpoint. Ini harus dikonfigurasi jika CheckPoint diatur ke true. Peringatan Nilai dalam kolom ini harus inkremental. Jika tidak, data mungkin hilang. Nilai maksimum dalam setiap hasil query digunakan sebagai input untuk query berikutnya.
CheckPointColumnTypestringTidakKosongintTipe data kolom checkpoint. Tipe yang didukung adalah int dan time. Penyimpanan internal untuk tipe int adalah int64. Tipe time mendukung tipe date, datetime, dan time SQL Server. Ini harus dikonfigurasi jika CheckPoint diatur ke true.
CheckPointStartstringTidakKosongNilai awal kolom checkpoint. Ini harus dikonfigurasi jika CheckPoint diatur ke true.
CheckPointSavePerPageboolTidaktruetrueMenentukan apakah akan menyimpan checkpoint untuk setiap halaman.* true (default): Simpan checkpoint untuk setiap halaman.
* false: Simpan checkpoint setelah setiap sinkronisasi selesai.
IntervalMsintTidak6000060000Interval sinkronisasi. Nilai default adalah 60000, dalam ms.

Plug-in input PostgreSQL

ParameterTipeWajibNilai defaultContohDeskripsi
TypestringYa/service_pgsqlJenis plug-in. Atur nilai ke service_pgsql.
AddressstringTidak127.0.0.1:5432rm-*.pg.rds.aliyuncs.comAlamat PostgreSQL.
UserstringTidakrootrootNama akun untuk login ke database PostgreSQL.
PasswordstringTidakKosongPassword untuk akun login ke database PostgreSQL. Jika Anda memiliki persyaratan keamanan yang tinggi, atur username dan password ke xxx. Setelah konfigurasi pengumpulan disinkronkan ke mesin Anda, temukan konfigurasi di file /usr/local/ilogtail/user_log_config.json dan modifikasi. Untuk informasi lebih lanjut, lihat Memodifikasi konfigurasi lokal.
Penting Jika Anda memodifikasi parameter ini di konsol, konfigurasi lokal akan ditimpa setelah sinkronisasi.
DataBasestringTidak/project_databaseNama database PostgreSQL.
DialTimeOutMsintTidak50005000Periode timeout untuk koneksi ke database PostgreSQL, dalam ms.
ReadTimeOutMsintTidak50005000Periode timeout untuk membaca hasil query PostgreSQL, dalam ms.
StateMentstringTidak/Pernyataan SELECT. Jika CheckPoint diatur ke true, kondisi WHERE dalam pernyataan SELECT StateMent harus mencakup kolom checkpoint (parameter CheckPointColumn), dan nilainya harus diatur ke $1. Misalnya, atur CheckPointColumn ke id dan StateMent ke SELECT * from ... where id > $1
LimitboolTidakfalsetrueMenentukan apakah akan menggunakan LIMIT untuk paging.* true: Gunakan LIMIT.
* false (default): Jangan gunakan LIMIT.Kami merekomendasikan penggunaan LIMIT untuk paging. Jika Limit diatur ke true, sistem secara otomatis menambahkan klausa LIMIT ke pernyataan SELECT selama query SQL.
PageSizeintTidak/10Ukuran halaman. Ini harus dikonfigurasi jika Limit diatur ke true.
MaxSyncSizeintTidak00Jumlah maksimum record yang akan disinkronkan dalam satu waktu. Nilai default adalah 0, yang berarti tidak ada batasan.
CheckPointboolTidakfalsetrueMenentukan apakah akan menggunakan checkpoint.* true: Gunakan checkpoint.
* false (default): Jangan gunakan checkpoint.Checkpoint dapat digunakan sebagai titik awal untuk pengumpulan data berikutnya untuk mengimplementasikan pengumpulan data inkremental.
CheckPointColumnstringTidakKosong1Nama kolom checkpoint. Ini harus dikonfigurasi jika CheckPoint diatur ke true. Peringatan Nilai dalam kolom ini harus inkremental. Jika tidak, data mungkin hilang. Nilai maksimum dalam setiap hasil query digunakan sebagai input untuk query berikutnya.
CheckPointColumnTypestringTidakKosongintTipe data kolom checkpoint. Tipe yang didukung adalah int dan time. Penyimpanan internal untuk tipe int adalah int64. Tipe time mendukung tipe time PostgreSQL. Ini harus dikonfigurasi jika CheckPoint diatur ke true.
CheckPointStartstringTidakKosongNilai awal kolom checkpoint. Ini harus dikonfigurasi jika CheckPoint diatur ke true.
CheckPointSavePerPageboolTidaktruetrueMenentukan apakah akan menyimpan checkpoint untuk setiap halaman.* true (default): Simpan checkpoint untuk setiap halaman.
* false: Simpan checkpoint setelah setiap sinkronisasi selesai.
IntervalMsintTidak6000060000Interval sinkronisasi. Nilai default adalah 60000, dalam ms.

Plug-in input SNMP

ParameterTipeWajibNilai defaultContohDeskripsi
Targets[string]Ya/127.0.0.1Alamat IP grup mesin target.
PortstringTidak161161Port yang digunakan oleh protokol SNMP.
CommunitystringTidakpublicpublicNama community. SNMPv1 dan SNMPv2 menggunakan nama community untuk autentikasi.
UserNamestringTidakKosongrootUsername. SNMPv3 mendukung autentikasi menggunakan username.
AuthenticationProtocolstringTidakNoAuthNoAuthProtokol autentikasi. SNMPv3 mendukung autentikasi menggunakan protokol autentikasi.
AuthenticationPassphrasestringTidakKosongPassword autentikasi. Nilai default adalah kosong. Jika Anda mengatur AuthenticationProtocol ke MD5 atau SHA, Anda perlu mengatur AuthenticationPassphrase.
PrivacyProtocolstringTidakNoPrivNoPrivProtokol privasi. SNMPv3 mendukung autentikasi menggunakan protokol privasi.
PrivacyPassphrasestringTidakKosongPassword protokol privasi. Secara default, sama dengan password autentikasi. Jika Anda mengatur PrivacyProtocol ke DES atau AES, Anda harus mengatur PrivacyPassphrase.
TimeoutintTidak55Periode timeout untuk satu operasi query, dalam detik.
VersionintTidak22Versi protokol SNMP. Nilai yang valid adalah 1, 2, dan 3.
TransportstringTidakudpudpMetode komunikasi SNMP. Nilai yang valid adalah udp dan tcp.
MaxRepetitionsintTidak00Jumlah percobaan ulang setelah timeout query.
Oids[string]TidakKosong1Object identifier yang akan di-query di mesin target.
Fields[string]TidakKosongintField yang akan di-query di mesin target. Plug-in ini terlebih dahulu menerjemahkan field dengan mencarinya di Management Information Base (MIB) lokal, menerjemahkannya menjadi object identifier, dan meng-query-nya bersama-sama.
Tables[string]TidakKosongTabel yang akan di-query di mesin target. Plug-in ini terlebih dahulu meng-query semua field dalam tabel, kemudian mencarinya di Management Information Base (MIB) lokal, menerjemahkannya menjadi object identifier, dan meng-query-nya bersama-sama.

Plug-in output Script

ParameterTipeWajibNilai defaultContohDeskripsi
TypestringYa/input_commandJenis plug-in. Atur nilai ke input_command.
ScriptTypestringYaKosongshellMenentukan jenis konten script. Saat ini mendukung bash, shell, python2, dan python3.
UserstringYa/publicUsername yang digunakan untuk menjalankan perintah. Hanya pengguna non-root yang didukung. Catatan * Pastikan username yang ditentukan ada di mesin. Kami merekomendasikan konfigurasi privilege paling sedikit, memberikan izin rwx hanya ke direktori atau file yang diperlukan.
ScriptContentstringYaKosongKonten script. Mendukung konten PlainText dan terenkripsi Base64, dengan panjang dalam 512*1024 byte.
ContentEncodingstringTidakPlainTextPlainTextFormat teks dari konten script. Nilai yang valid:* PlainText (default): Plain text, tidak di-encode.
* Base64: Encoding Base64.
LineSplitSepstringTidakKosongSeparator untuk konten output script. Jika kosong, tidak ada pemisahan yang dilakukan, dan seluruh output dikembalikan sebagai satu entri data.
CmdPathstringTidakKosong/usr/bin/bashPath untuk menjalankan perintah script. Jika kosong, path default digunakan. Path default adalah sebagai berikut:* bash: /usr/bin/bash
* shell: /usr/bin/sh
* python2: /usr/bin/python2
* python3: /usr/bin/python3
TimeoutMilliSecondsintTidak30003000Periode timeout untuk mengeksekusi script, dalam milidetik.
IgnoreErrorboolTidakfalsefalseMenentukan apakah akan mengabaikan log Error ketika eksekusi plug-in gagal. Nilai default adalah false, yang berarti tidak diabaikan.
Environments[string]TidakVariabel environment. Default-nya adalah nilai dari os.Environ(). Jika Environments diatur, variabel environment yang ditetapkan ditambahkan ke os.Environ().
IntervalMsintTidak50005000Frekuensi pemicu pengumpulan atau frekuensi eksekusi script, dalam milidetik.

Plug-in pemrosesan native

Plug-in parsing ekspresi reguler native

ParameterTipeWajibNilai defaultContohDeskripsi
TypestringYa/processor_parse_regex_nativeJenis plug-in. Atur nilai ke processor_parse_regex_native.
SourceKeystringYa/contentNama field sumber.
RegexstringYa/(\d+-\d+-\d+)\s+(.*)Ekspresi reguler.
Keys[string]Ya/["time", "msg"]Daftar field yang diekstrak.
KeepingSourceWhenParseFailboolTidakfalsefalseMenentukan apakah akan mempertahankan field sumber ketika parsing gagal.
KeepingSourceWhenParseSucceedboolTidakfalsefalseMenentukan apakah akan mempertahankan field sumber ketika parsing berhasil.
RenamedSourceKeystringTidakKosongkeyNama field untuk menyimpan field sumber ketika dipertahankan. Jika tidak diisi, nama tidak diubah secara default.

Plug-in parsing JSON native

ParameterTipeWajibNilai defaultContohDeskripsi
TypestringYa/processor_parse_json_nativeJenis plug-in. Atur nilai ke processor_parse_json_native.
SourceKeystringYa/contentNama field sumber.
KeepingSourceWhenParseFailboolTidakfalsefalseMenentukan apakah akan mempertahankan field sumber ketika parsing gagal.
KeepingSourceWhenParseSucceedboolTidakfalsefalseMenentukan apakah akan mempertahankan field sumber ketika parsing berhasil.
RenamedSourceKeystringTidakKosongkeyNama field untuk menyimpan field sumber ketika dipertahankan. Jika tidak diisi, nama tidak diubah secara default.

Plug-in parsing separator native

ParameterTipeWajibNilai defaultContohDeskripsi
TypestringYa/processor_parse_delimiter_nativeJenis plug-in. Atur nilai ke processor_parse_delimiter_native.
SourceKeystringYa/contentNama field sumber.
SeparatorstringYa/,Separator.
QuotestringTidak""Quote.
Keys[string]Ya/["time", "msg"]Daftar field yang diekstrak.
AllowingShortenedFieldsboolTidaktruetrueMenentukan apakah akan mengizinkan jumlah field yang diekstrak kurang dari jumlah Keys. Jika tidak diizinkan, skenario ini diperlakukan sebagai kegagalan parsing.
OverflowedFieldsTreatmentstringTidakextendextendPerilaku ketika jumlah field yang diekstrak lebih besar dari jumlah Keys. Nilai yang valid:* extend: Mempertahankan field tambahan, dan setiap field tambahan ditambahkan ke log sebagai field terpisah. Nama field untuk field tambahan adalah __column$i__, di mana $i mewakili nomor urut field tambahan, dimulai dari 0.
* keep: Mempertahankan field tambahan, tetapi menambahkan konten tambahan sebagai field tunggal ke log. Nama field adalah __column0__.
* discard: Membuang field tambahan.
KeepingSourceWhenParseFailboolTidakfalsefalseMenentukan apakah akan mempertahankan field sumber ketika parsing gagal.
KeepingSourceWhenParseSucceedboolTidakfalsefalseMenentukan apakah akan mempertahankan field sumber ketika parsing berhasil.
RenamedSourceKeystringTidakKosongkeyNama field untuk menyimpan field sumber ketika dipertahankan. Jika tidak diisi, nama tidak diubah secara default.

Plug-in parsing Apsara native

ParameterTipeWajibNilai defaultContohDeskripsi
TypestringYa/processor_parse_apsara_nativeJenis plug-in. Atur nilai ke processor_parse_apsara_native.
SourceKeystringYa/contentNama field sumber.
TimezonestringTidakKosongGMT+08:00Zona waktu dari waktu log. Format-nya adalah GMT+HH:MM (Timur) atau GMT-HH:MM (Barat).
KeepingSourceWhenParseFailboolTidakfalsefalseMenentukan apakah akan mempertahankan field sumber ketika parsing gagal.
KeepingSourceWhenParseSucceedboolTidakfalsefalseMenentukan apakah akan mempertahankan field sumber ketika parsing berhasil.
RenamedSourceKeystringTidakKosongkeyNama field untuk menyimpan field sumber ketika dipertahankan. Jika tidak diisi, nama tidak diubah secara default.

Plug-in parsing waktu native

ParameterTipeWajibNilai defaultContohDeskripsi
TypestringYa/processor_parse_timestamp_nativeJenis plug-in. Atur nilai ke processor_parse_timestamp_native.
SourceKeystringYa/contentNama field sumber.
SourceFormatstringYa/%Y/%m/%d %H:%M:%SFormat waktu log. Untuk informasi lebih lanjut, lihat Format waktu.
SourceTimezonestringTidakKosongGMT+08:00Zona waktu dari waktu log. Format-nya adalah GMT+HH:MM (Timur) atau GMT-HH:MM (Barat).

Plug-in filter native

ParameterTipeWajibContohNilai defaultDeskripsi
TypestringYaprocessor_filter_regex_native/Jenis plug-in. Atur nilai ke processor_filter_regex_native.
IncludemapYa//Whitelist field log, di mana key adalah nama field dan value adalah ekspresi reguler. Ini menunjukkan kondisi yang harus dipenuhi oleh konten field yang ditentukan oleh key agar event saat ini dikumpulkan. Hubungan antara beberapa kondisi adalah "AND". Log dikumpulkan hanya ketika semua kondisi terpenuhi.

Plug-in masking data native

ParameterTipeWajibNilai defaultContohDeskripsi
TypestringYa/processor_desensitize_nativeJenis plug-in. Atur nilai ke processor_desensitize_native.
SourceKeystringYa/contentNama field sumber.
MethodstringYa/constMetode masking data. Nilai yang valid: const: mengganti konten sensitif dengan konstanta. md5: mengganti konten sensitif dengan nilai MD5-nya.
ReplacingStringstringTidak, wajib jika Method diatur ke const./******String konstanta yang digunakan untuk mengganti konten sensitif.
ContentPatternBeforeReplacedStringstringYa/'password:'Ekspresi reguler prefiks untuk konten sensitif.
ReplacedContentPatternstringYa/[^']*Ekspresi reguler untuk konten sensitif.
ReplacingAllboolTidaktruetrueMenentukan apakah akan mengganti semua konten sensitif yang cocok.

Plug-in pemrosesan ekstensi

Ekstrak field

Mode ekspresi reguler

ParameterTipeWajibNilai defaultContohDeskripsi
TypestringYa/processor_regexJenis plug-in. Atur nilai ke processor_regex.
SourceKeystringYa/contentNama field sumber.
RegexstringYa/(\d+-\d+-\d+)\s+(.*)Ekspresi reguler. Anda perlu menggunakan tanda kurung () untuk menandai field yang akan diekstrak.
Keys[string]Ya/["ip", "time", "method"]Menentukan nama field untuk konten yang diekstrak, misalnya, ["ip", "time", "method"].
NoKeyErrorbooleanTidakfalsefalseMenentukan apakah sistem melaporkan error jika field sumber yang Anda tentukan tidak ada dalam log mentah.* true: Laporkan error.
* false (default): Jangan laporkan error.
NoMatchErrorbooleanTidakfalsefalseMenentukan apakah sistem melaporkan error jika ekspresi reguler yang Anda tentukan tidak cocok dengan nilai field sumber.* true: Laporkan error.
* false (default): Jangan laporkan error.
KeepSourcebooleanTidakfalsefalseMenentukan apakah akan mempertahankan field sumber dalam log yang di-parse.* true: Pertahankan.
* false (default): Jangan pertahankan.
FullMatchbooleanTidaktruetrueMenentukan apakah hanya akan mengekstrak ketika sepenuhnya cocok.* true (default): Nilai field hanya diekstrak jika semua field yang Anda atur dalam parameter Keys dapat dicocokkan dengan nilai field sumber melalui ekspresi reguler dalam parameter Regex.
* false: Pencocokan parsial juga diekstrak.
KeepSourceIfParseErrorbooleantruetruefalseMenentukan apakah akan mempertahankan field sumber dalam log yang di-parse jika parsing gagal.* true: Pertahankan.
* false (default): Jangan pertahankan.

Mode anchor

ParameterTipeWajibNilai defaultContohDeskripsi
TypestringYa/processor_anchorJenis plug-in. Atur nilai ke processor_anchor.
SourceKeyArray anchorYa/contentNama field sumber.
AnchorsstringYa/Daftar item anchor.
StartStringYaKosongtimeKata kunci awal. Jika kosong, ini cocok dengan awal string.
StopStringYaKosong\tKata kunci akhir. Jika kosong, ini cocok dengan akhir string.
FieldNameStringYaKosongtimeMenentukan nama field untuk konten yang diekstrak.
FieldTypeStringYaKosongstringTipe field. Nilai yang valid adalah string atau json.
ExpondJsonbooleanTidakfalsefalseMenentukan apakah akan melakukan ekspansi JSON.* true: Perluas.
* false (default): Jangan perluas.
ExpondConnecterStringTidak__Konektor untuk ekspansi JSON. Nilai default adalah garis bawah (_).
MaxExpondDepthIntTidak00Kedalaman maksimum untuk ekspansi JSON. Nilai default adalah 0, yang berarti tidak ada batasan.
NoAnchorErrorBooleanTidakfalsefalseMenentukan apakah sistem melaporkan error ketika item anchor tidak dapat ditemukan.* true: Laporkan error.
* false (default): Jangan laporkan error.
NoKeyErrorBooleanTidakfalsefalseMenentukan apakah sistem melaporkan error jika field sumber yang Anda tentukan tidak ada dalam log mentah.* true: Laporkan error.
* false (default): Jangan laporkan error.
KeepSourceBooleanTidakfalsefalseMenentukan apakah akan mempertahankan field sumber dalam log yang di-parse.* true: Laporkan error.
* false (default): Jangan laporkan error.

Mode CSV

ParameterTipeWajibNilai defaultContohDeskripsi
TypestringYa/processor_csvJenis plug-in. Atur nilai ke processor_csv.
SourceKeyStringYa/csvNama field sumber.
SplitKeysArray stringYa/["date", "ip", "content"]Menentukan nama field untuk konten yang diekstrak, misalnya, ["date", "ip", "content"]. Penting Jika jumlah field yang akan dipisahkan kurang dari jumlah field dalam parameter SplitKeys, field tambahan dalam parameter SplitKeys akan diabaikan.
PreserveOthersBooleanTidakfalsefalseMenentukan apakah akan mempertahankan bagian berlebih jika jumlah field yang akan dipisahkan lebih besar dari jumlah field dalam parameter SplitKeys.* true: Pertahankan.
* false (default): Jangan pertahankan.
ExpandOthersBooleanTidakfalsefalseMenentukan apakah akan mem-parse bagian berlebih.* true: Parse. Anda dapat mem-parse bagian berlebih melalui parameter ExpandOthers dan kemudian menentukan prefiks penamaan untuk field tambahan melalui parameter ExpandKeyPrefix. *
* false (default): Jangan parse. Jika Anda mengatur PreserveOthers ke true dan ExpandOthers ke false, konten bagian berlebih disimpan dalam field _decode_preserve_.Catatan Jika konten field tambahan berisi konten non-standar, Anda perlu menormalkannya sesuai format CSV sebelum menyimpannya.
ExpandKeyPrefixStringTidakPrefiks penamaan untuk field tambahan. Misalnya, jika dikonfigurasi sebagai expand_, nama field akan menjadi expand_1, expand_2.
TrimLeadingSpaceBooleanTidakfalsefalseMenentukan apakah akan mengabaikan spasi di awal nilai field.* true: Abaikan.
* false (default): Jangan abaikan.
SplitSepStringTidak,,Separator. Nilai default adalah koma (,).
KeepSourceBooleanTidakfalsefalseMenentukan apakah akan mempertahankan field sumber dalam log yang di-parse.* true: Pertahankan.
* false (default): Jangan pertahankan.
NoKeyErrorBooleanTidakfalsefalseMenentukan apakah sistem melaporkan error jika field sumber yang Anda tentukan tidak ada dalam log mentah.* true: Laporkan error.
* false (default): Jangan laporkan error.

Mode separator karakter tunggal

ParameterTipeWajibNilai defaultContohDeskripsi
TypestringYa/processor_split_charJenis plug-in. Atur nilai ke processor_split_char.
SourceKeyStringYaNama field sumber.
SplitSepStringYaSeparator. Harus berupa karakter tunggal. Dapat diatur ke karakter tidak terlihat, seperti .
SplitKeysArray stringYa["ip", "time", "method"]Menentukan nama field untuk konten yang diekstrak, misalnya, ["ip", "time", "method"].
PreserveOthersBooleanTidakfalsefalseMenentukan apakah akan mempertahankan bagian berlebih jika jumlah field yang akan dipisahkan lebih besar dari jumlah field dalam parameter SplitKeys.* true: Pertahankan.
* false (default): Jangan pertahankan.
QuoteFlagBooleanTidakfalsefalseMenentukan apakah akan menggunakan quote.* true: Gunakan.
* false (default): Jangan gunakan.
QuoteStringTidak/Quote. Harus berupa karakter tunggal. Dapat berupa karakter tidak terlihat, seperti . Hanya valid jika QuoteFlag diatur ke true.
NoKeyErrorBooleanTidakfalsefalseMenentukan apakah sistem melaporkan error jika field sumber yang Anda tentukan tidak ada dalam log mentah.* true: Laporkan error.
* false (default): Jangan laporkan error.
NoMatchErrorBooleanTidakfalsefalseMenentukan apakah sistem melaporkan error jika separator yang Anda tentukan tidak cocok dengan separator dalam log.* true: Laporkan error.
* false (default): Jangan laporkan error.
KeepSourceBooleanTidakfalsefalseMenentukan apakah akan mempertahankan field sumber dalam log yang di-parse.* true: Pertahankan.
* false (default): Jangan pertahankan.

Mode separator multi-karakter

ParameterTipeWajibNilai defaultContohDeskripsi
TypestringYa/processor_split_stringJenis plug-in. Atur nilai ke processor_split_string.
SourceKeyStringYaNama field sumber.
SplitSepStringYaSeparator. Harus berupa karakter tunggal. Dapat diatur ke karakter tidak terlihat, seperti .
SplitKeysArray stringYa["key1","key2"]Menentukan nama field untuk konten yang diekstrak, misalnya, ["key1","key2"].Catatan Jika jumlah field yang akan dipisahkan kurang dari jumlah field dalam parameter SplitKeys, field tambahan dalam parameter SplitKeys akan diabaikan.
PreserveOthersBooleanTidakfalsefalseMenentukan apakah akan mempertahankan bagian berlebih jika jumlah field yang akan dipisahkan lebih besar dari jumlah field dalam parameter SplitKeys.* true: Pertahankan.
* false (default): Jangan pertahankan.
ExpandOthersBooleanTidakfalsefalseMenentukan apakah akan menggunakan quote.* true: Gunakan.
* false (default): Jangan gunakan.
ExpandKeyPrefixStringTidak/expand_Prefiks penamaan untuk bagian berlebih. Misalnya, jika dikonfigurasi sebagai expand_, nama field akan menjadi expand_1, expand_2.
NoKeyErrorBooleanTidakfalsefalseMenentukan apakah sistem melaporkan error jika field sumber yang Anda tentukan tidak ada dalam log mentah.* true: Laporkan error.
* false (default): Jangan laporkan error.
NoMatchErrorBooleanTidakfalsefalseMenentukan apakah sistem melaporkan error jika separator yang Anda tentukan tidak cocok dengan separator dalam log.* true: Laporkan error.
* false (default): Jangan laporkan error.
KeepSourceBooleanTidakfalsefalseMenentukan apakah akan mempertahankan field sumber dalam log yang di-parse.* true: Pertahankan.
* false (default): Jangan pertahankan.

Mode pasangan key-value

ParameterTipeWajibNilai defaultContohDeskripsi
TypestringYa/processor_split_key_valueJenis plug-in. Atur nilai ke processor_split_key_value.
SourceKeystringYaNama field sumber.
DelimiterstringTidak\t\tSeparator antara pasangan key-value. Nilai default adalah karakter tab \t.
SeparatorstringTidak::Separator antara key dan value dalam satu pasangan key-value. Nilai default adalah titik dua (:).
KeepSourceBooleanTidakfalsefalseMenentukan apakah akan mempertahankan field sumber dalam log yang di-parse.* true: Pertahankan.
* false (default): Jangan pertahankan.
ErrIfSourceKeyNotFoundBooleanTidaktruefalseMenentukan apakah sistem melaporkan error jika field sumber yang Anda tentukan tidak ada dalam log mentah.* true (default): Laporkan error.
* false: Jangan laporkan error.
DiscardWhenSeparatorNotFoundBooleanTidakfalsefalseMenentukan apakah akan membuang pasangan key-value jika tidak ada separator yang cocok ditemukan.* true: Buang.
* false (default): Jangan buang.
ErrIfSeparatorNotFoundBooleanTidaktruefalseMenentukan apakah sistem melaporkan error ketika separator yang ditentukan tidak ada.* true (default): Laporkan error.
* false: Jangan laporkan error.
ErrIfKeyIsEmptyBooleanTidaktruefalseMenentukan apakah sistem melaporkan error ketika key setelah pemisahan kosong.* true (default): Laporkan error.
* false: Jangan laporkan error.
QuoteStringTidakQuote. Ketika diatur, jika sebuah nilai dibungkus dalam quote, nilai di dalam quote akan diekstrak. Quote multi-karakter didukung. Secara default, fungsi quote tidak diaktifkan. Penting * Jika quote-nya adalah tanda kutip ganda (""), Anda perlu menambahkan karakter escape, yaitu backslash (\). Ketika backslash (\) digunakan dengan quote di dalam quote, backslash (\) dikeluarkan sebagai bagian dari value.

Mode Grok

ParameterTipeWajibNilai defaultContohDeskripsi
TypestringYa/processor_grokJenis plug-in. Atur nilai ke processor_grok.
CustomPatternDirArray stringTidakDirektori tempat file pattern Grok kustom berada. Plug-in processor_grok membaca semua file dalam direktori. Jika parameter ini tidak ditambahkan, tidak ada file pattern Grok kustom yang diimpor. Penting Setelah memperbarui file pattern Grok kustom, Anda perlu me-restart Logtail agar berlaku.
CustomPatternsMapTidakPattern GROK kustom, di mana key adalah nama aturan dan value adalah ekspresi Grok. Untuk ekspresi yang didukung secara default, lihat processor_grok. Jika ekspresi yang Anda butuhkan tidak ada di link, masukkan ekspresi Grok kustom di Match. Jika parameter ini tidak ditambahkan, tidak ada pattern GROK kustom yang digunakan.
SourceKeyStringTidakcontentcontentNama field sumber. Nilai default adalah field content.
MatchArray stringYaArray ekspresi Grok. Plug-in processor_grok mencocokkan log dengan daftar ekspresi yang dikonfigurasi di sini dari atas ke bawah dan mengembalikan hasil ekstraksi pertama yang berhasil dicocokkan. Catatan Mengonfigurasi beberapa ekspresi Grok dapat memengaruhi performa. Kami merekomendasikan tidak lebih dari 5.
TimeoutMilliSecondsLongTidak0Waktu percobaan maksimum untuk mengekstrak field dengan ekspresi Grok, dalam milidetik. Jika parameter ini tidak ditambahkan atau diatur ke 0, itu berarti tidak ada timeout.
IgnoreParseFailureBooleanTidaktruetrueMenentukan apakah akan mengabaikan log yang gagal di-parse.* true (default): Abaikan.
* false: Hapus.
KeepSourceBooleanTidaktruetrueMenentukan apakah akan mempertahankan field sumber setelah parsing berhasil.* true (default): Pertahankan.
* false: Buang.
NoKeyErrorBooleanTidakfalsetrueMenentukan apakah sistem melaporkan error jika field sumber yang Anda tentukan tidak ada dalam log mentah.* true: Laporkan error.
* false (default): Jangan laporkan error.
NoMatchErrorBooleanTidaktruetrueMenentukan apakah sistem melaporkan error ketika tidak ada ekspresi yang diatur dalam parameter Match yang cocok dengan log.* true (default): Laporkan error.
* false: Jangan laporkan error.
TimeoutErrorBooleanTidaktruetrueMenentukan apakah sistem melaporkan error pada timeout pencocokan.* true (default): Laporkan error.
* false: Jangan laporkan error.

Tambah field

ParameterTipeWajibNilai defaultContohDeskripsi
TypestringYa/processor_add_fieldsJenis plug-in. Atur nilai ke processor_add_fields.
FieldsMapYaNama dan nilai field yang akan ditambahkan. Format pasangan key-value. Mendukung penambahan beberapa.
IgnoreIfExistBooleanTidakfalsefalseMenentukan apakah akan mengabaikan field duplikat jika field dengan nama yang sama sudah ada.* true: Abaikan.
* false (default): Jangan abaikan.

Hapus field

ParameterTipeWajibNilai defaultContohDeskripsi
TypestringYa/processor_dropJenis plug-in. Atur nilai ke processor_drop.
DropKeysArray stringYaMenentukan field yang akan dihapus. Beberapa dapat dikonfigurasi.

Ubah nama field

ParameterTipeWajibNilai defaultContohDeskripsi
TypestringYa/processor_renameJenis plug-in. Atur nilai ke processor_rename.
NoKeyErrorBooleanTidakfalsefalseMenentukan apakah sistem melaporkan error jika field sumber yang Anda tentukan tidak ada dalam log.* true: Laporkan error.
* false (default): Jangan laporkan error.
SourceKeysArray stringYaField sumber yang akan diubah namanya.
DestKeysArray stringYaField setelah diubah namanya.

Kemas field

ParameterTipeWajibNilai defaultContohDeskripsi
TypestringYa/processor_packjsonJenis plug-in. Atur nilai ke processor_packjson.
SourceKeysArray stringYaField sumber yang akan dikemas.
DestKeyStringTidakField setelah dikemas.
KeepSourceBooleanTidaktruetrueMenentukan apakah akan mempertahankan field sumber dalam log yang di-parse.* true (default): Pertahankan.
* false: Buang.
AlarmIfIncompleteBooleanTidaktruetrueMenentukan apakah sistem melaporkan error jika field sumber yang Anda tentukan tidak ada dalam log mentah.* true (default): Pertahankan.
* false: Buang.

Perluas field JSON

ParameterTipeWajibNilai defaultContohDeskripsi
TypestringYa/processor_jsonJenis plug-in. Atur nilai ke processor_json.
SourceKeyStringYaNama field sumber yang akan diperluas.
NoKeyErrorBooleanTidaktruetrueMenentukan apakah sistem melaporkan error jika field sumber yang Anda tentukan tidak ada dalam log mentah.* true (default): Laporkan error.
* false: Jangan laporkan error.
ExpandDepthIntTidak01Kedalaman ekspansi JSON. Nilai default adalah 0, yang berarti tidak ada batasan. 1 menunjukkan level saat ini, dan seterusnya.
ExpandConnectorStringTidak__Konektor untuk ekspansi JSON. Nilai default adalah garis bawah (_).
PrefixStringTidakPrefiks yang akan ditambahkan ke nama field selama ekspansi JSON.
KeepSourceBooleanTidaktruetrueMenentukan apakah akan mempertahankan field sumber dalam log yang di-parse.* true (default): Pertahankan.
* false: Buang.
UseSourceKeyAsPrefixBooleanTidakMenentukan apakah akan menggunakan nama field sumber sebagai prefiks untuk semua nama field JSON yang diperluas.
KeepSourceIfParseErrorBooleanTidaktruetrueMenentukan apakah akan mempertahankan log sumber jika parsing gagal.* true (default): Pertahankan.
* false: Buang.
ExpandArrayBooleanTidakfalsefalseMenentukan apakah akan memperluas tipe array. Parameter ini didukung oleh Logtail 1.8.0 dan yang lebih baru.* false (default): Jangan perluas.
* true: Perluas. Misalnya, {"k":["1","2"]} diperluas menjadi {"k[0]":"1","k[1]":"2"}.

Filter log

ParameterTipeWajibNilai defaultContohDeskripsi
TypestringYa/processor_filter_regexJenis plug-in. Atur nilai ke processor_filter_regex.
IncludeJSON ObjectTidakKey adalah field log, dan Value adalah ekspresi reguler yang harus cocok dengan nilai field. Hubungan antara pasangan key-value adalah AND. Jika nilai field log cocok dengan ekspresi reguler yang sesuai, log akan dikumpulkan.
ExcludeJSON ObjectTidakKey adalah field log, dan Value adalah ekspresi reguler yang harus cocok dengan nilai field. Hubungan antara pasangan key-value adalah OR. Jika nilai field mana pun dalam log cocok dengan ekspresi reguler yang sesuai, log akan dibuang.

Ekstrak waktu log

ParameterTipeWajibNilai defaultContohDeskripsi
TypestringYa/processor_gotimeJenis plug-in. Atur nilai ke processor_gotime.
SourceKeyStringYaNama field sumber.
SourceFormatStringYaFormat waktu sumber.
SourceLocationIntYaZona waktu dari waktu sumber. Jika nilai parameter kosong, ini menunjukkan zona waktu host atau container tempat Logtail berada.
DestKeyStringYaField tujuan setelah parsing.
DestFormatStringYaFormat waktu setelah parsing.
DestLocationIntTidakZona waktu setelah parsing. Jika nilai parameter kosong, ini menunjukkan zona waktu lokal.
SetTimeBooleanTidaktruetrueMenentukan apakah akan mengatur waktu yang di-parse sebagai waktu log.* true (default): Ya.
* false: Tidak.
KeepSourceBooleanTidaktruetrueMenentukan apakah akan mempertahankan field sumber dalam log yang di-parse.* true (default): Pertahankan.
* false: Jangan pertahankan.
NoKeyErrorBooleanTidaktruetrueMenentukan apakah sistem melaporkan error jika field sumber yang Anda tentukan tidak ada dalam log mentah.* true (default): Laporkan error.
* false: Jangan laporkan error.
AlarmIfFailBooleanTidaktruetrueMenentukan apakah sistem melaporkan error jika gagal mengekstrak waktu log.* true (default): Laporkan error.
* false: Jangan laporkan error.

Konversi alamat IP

ParameterTipeWajibNilai defaultContohDeskripsi
TypestringYa/processor_geoipJenis plug-in. Atur nilai ke processor_geoip.
SourceKeyStringYaNama field sumber yang akan dikonversi untuk alamat IP.
DBPathStringYa/user/data/GeoLite2-City_20180102/GeoLite2-City.mmdbPath lengkap dari database GeoIP. Misalnya, /user/data/GeoLite2-City_20180102/GeoLite2-City.mmdb.
NoKeyErrorBooleanTidakfalsefalseMenentukan apakah sistem melaporkan error jika nama field sumber yang Anda tentukan tidak ada dalam log mentah.* true: Laporkan error.
* false (default): Jangan laporkan error.
NoMatchErrorBooleanTidaktruetrueMenentukan apakah sistem melaporkan error jika alamat IP tidak valid atau tidak ditemukan dalam database.* true (default): Laporkan error.
* false: Jangan laporkan error.
KeepSourceBooleanTidaktruetrueMenentukan apakah akan mempertahankan field sumber dalam log yang di-parse.* true (default): Pertahankan.
* false: Jangan pertahankan.
LanguageStringTidakzh-CNzh-CNAtribut bahasa. Nilai default adalah zh-CN. Penting Pastikan database GeoIP Anda berisi bahasa yang sesuai.

Masking data

ParameterTipeWajibNilai defaultContohDeskripsi
TypestringYa/processor_desensitizeJenis plug-in. Atur nilai ke processor_desensitize.
SourceKeyStringYaNama field log.
MethodStringYaconstMetode masking data. Nilai yang valid:* const: Mengganti konten sensitif dengan sebuah string. Anda dapat menentukan string target dengan parameter ReplaceString.
* md5: Mengganti konten sensitif dengan nilai MD5-nya.
MatchStringTidakfullfullMenentukan metode untuk mengekstrak konten sensitif. Nilai yang valid:* full (default): Ekstrak semua, yang berarti mengganti semua konten dalam nilai field target.
* regex: Menggunakan ekspresi reguler untuk mengekstrak konten sensitif.
ReplaceStringStringTidakString yang digunakan untuk mengganti konten sensitif. Wajib jika Method diatur ke const.
RegexBeginStringTidakEkspresi reguler untuk mencocokkan prefiks konten sensitif. Wajib jika Match diatur ke regex.
RegexContentStringTidakEkspresi reguler untuk mencocokkan konten sensitif. Wajib jika Match diatur ke regex.

Petakan nilai field

ParameterTipeWajibNilai defaultContohDeskripsi
TypestringYa/processor_dict_mapJenis plug-in. Atur nilai ke processor_dict_map.
SourceKeyStringYaNama field sumber.
MapDictMapTidakKamus pemetaan. Jika kamus pemetaan kecil, Anda dapat mengaturnya langsung dengan parameter ini. Anda tidak perlu menyediakan file kamus CSV lokal. Penting Ketika Anda mengatur parameter DictFilePath, konfigurasi dalam parameter MapDict tidak akan berlaku.
DictFilePathStringTidakFile kamus dalam format CSV. Separator untuk file CSV ini adalah koma (,), dan referensi field ditunjukkan dengan tanda kutip ganda (").
DestKeyStringTidakNama field setelah pemetaan.
HandleMissingBooleanTidakfalsefalseMenentukan apakah sistem memproses field target jika hilang dari log mentah.* true: Proses. Sistem mengisinya dengan nilai dari parameter Missing.
* false (default): Jangan proses.
MissingStringTidakUnknownUnknownKetika memproses field target yang hilang dalam log mentah, mengatur nilai pengisian yang sesuai. Nilai default adalah Unknown. Parameter ini berlaku ketika HandleMissing dikonfigurasi sebagai true.
MaxDictSizeIntTidak10001000Ukuran maksimum kamus pemetaan. Nilai default adalah 1000, yang berarti hingga 1000 aturan pemetaan dapat disimpan. Untuk membatasi penggunaan memori plug-in di server, Anda dapat mengurangi nilai ini.
ModeStringTidakoverwriteoverwriteMetode pemrosesan ketika field yang dipetakan sudah ada dalam log mentah.* overwrite (default): Menimpa field asli.
* fill: Tidak menimpa field asli.

Enkripsi field

ParameterTipeWajibNilai defaultContohDeskripsi
TypestringYa/processor_encryptJenis plug-in. Atur nilai ke processor_encrypt.
SourceKeyArray stringYaNama field sumber.
EncryptionParametersObjectYaKonfigurasi terkait key.
KeyStringYaMengatur key. Harus 64 karakter heksadesimal.
IVStringTidak00000000000000000000000000000000Mengatur initial vector untuk enkripsi. Harus 32 karakter heksadesimal. Nilai default adalah 00000000000000000000000000000000.
KeyFilePathBooleanTidakPath file untuk membaca parameter enkripsi. Jika tidak dikonfigurasi, ini membaca dari Konfigurasi Logtail - Konfigurasi Input - Path File.
KeepSourceValueIfErrorStringTidakfalsefalseMenentukan apakah sistem mempertahankan nilai field sumber jika enkripsi gagal.* true: Pertahankan.
* false (default): Jangan pertahankan.Jika enkripsi gagal, nilai field digantikan dengan ENCRYPT_ERROR.

Ganti string

ParameterTipeWajibNilai defaultContohDeskripsi
TypestringYa/processor_string_replaceJenis plug-in. Atur nilai ke processor_string_replace.
SourceKeyStringYaNama field sumber.
MethodStringYaMenentukan metode pencocokan. Nilai yang valid:* const: Mengganti dengan sebuah string.
* regex: Mengganti menggunakan ekspresi reguler.
* unquote: Menghapus karakter escape.
MatchStringTidakMasukkan konten yang akan dicocokkan.* Ketika Method diatur ke const, masukkan string yang cocok dengan konten yang akan diganti. Jika beberapa string cocok, semua akan diganti.
* Ketika Method diatur ke regex, masukkan ekspresi reguler yang cocok dengan konten yang akan diganti. Jika beberapa string cocok, semua akan diganti. Anda juga dapat menggunakan grouping regex untuk mencocokkan grup tertentu.
* Ketika Method diatur ke unquote, Anda tidak perlu mengonfigurasi parameter ini.
ReplaceStringStringTidakString untuk penggantian. Nilai default adalah "".* Ketika Method diatur ke const, masukkan string untuk mengganti konten asli.
* Ketika Method diatur ke regex, masukkan string untuk mengganti konten asli. Mendukung penggantian berdasarkan grup regex.
* Ketika Method diatur ke unquote, Anda tidak perlu mengonfigurasi parameter ini.
DestKeyStringTidakMenentukan field baru untuk konten yang diganti. Secara default, tidak ada field baru yang ditambahkan.

Encode dan decode data

ParameterTipeWajibNilai defaultContohDeskripsi
TypestringYa/processor_base64_encodingJenis plug-in. Atur nilai ke processor_base64_encoding.
SourceKeyStringYaNama field sumber.
NewKeyStringYaNama field hasil setelah encoding.
NoKeyErrorBooleanTidakfalsefalseMenentukan apakah sistem melaporkan error jika field sumber yang Anda tentukan tidak ada dalam log mentah.* true: Laporkan error.
* false (default): Jangan laporkan error.

Konversi log ke metrik

ParameterTipeWajibNilai defaultContohDeskripsi
TypestringYa/processor_log_to_sls_metricJenis plug-in. Atur nilai ke processor_log_to_sls_metric.
MetricTimeKeyStringTidakMenentukan field waktu dalam log, yang dipetakan ke field __time_nano__ dalam data time series. Secara default, nilai field __time__ dalam log diekstrak. Pastikan field yang ditentukan adalah timestamp yang valid dan diformat dengan benar. Saat ini mendukung Unix timestamp dalam detik (10 digit), milidetik (13 digit), mikrodetik (16 digit), dan nanodetik (19 digit).
MetricLabelKeys[]StringYaMenentukan daftar Key untuk field __labels__. Key harus mengikuti ekspresi reguler ^[a-zA-Z_][a-zA-Z0-9_]*$. Value tidak boleh berisi garis vertikal (
MetricValuesMapYaDigunakan untuk menentukan nama Metric dan nilai Metric. Nama Metric sesuai dengan field __name__ dan harus mengikuti ekspresi reguler ^[a-zA-Z_:][a-zA-Z0-9_:]*$. Nilai Metric sesuai dengan field __value__ dan harus bertipe Double. Untuk informasi lebih lanjut, lihat Data time series (Metric) .
CustomMetricLabelsMapTidakField __labels__ kustom. Key harus mengikuti ekspresi reguler ^[a-zA-Z_][a-zA-Z0-9_]*$, dan Value tidak boleh berisi garis vertikal (
IgnoreErrorBooleanTidakMenentukan apakah akan menghasilkan log Error ketika tidak ada log yang cocok. Nilai default adalah false, yang berarti tidak ada output.

Konversi log ke trace

ParameterTipeWajibNilai defaultContohDeskripsi
TypestringYa/processor_otel_traceJenis plug-in. Atur nilai ke processor_otel_trace.
SourceKeyStringYaNama field sumber.
FormatStringYajsonFormat setelah konversi. Nilai yang valid: protobuf, json, protojson.
NoKeyErrorBooleanTidakfalsetrueMenentukan apakah akan melaporkan error ketika field sumber yang sesuai tidak ada dalam log. Nilai default adalah false.
TraceIDNeedDecodeBooleanTidakMenentukan apakah akan melakukan decoding Base64 pada TraceID. Nilai default adalah false. Ketika Format diatur ke protojson, jika TraceID telah di-encode Base64, Anda perlu mengatur TraceIDNeedDecode ke true. Jika tidak, konversi akan gagal.
SpanIDNeedDecodeBooleanTidakMenentukan apakah akan melakukan decoding Base64 pada SpanID. Nilai default adalah false. Ketika Format diatur ke protojson, jika SpanID telah di-encode Base64, Anda perlu mengatur SpanIDNeedDecode ke true. Jika tidak, konversi akan gagal.
ParentSpanIDNeedDecodeBooleanTidakMenentukan apakah akan melakukan decoding Base64 pada ParentSpanID. Nilai default adalah false. Ketika Format diatur ke protojson, jika ParentSpanID telah di-encode Base64, Anda perlu mengatur ParentSpanIDNeedDecode ke true. Jika tidak, konversi akan gagal.

Plug-in output

Plug-in output SLS

ParameterTipeWajibNilai defaultContohDeskripsi
TypestringYa/flusher_slsJenis plug-in. Atur nilai ke flusher_sls.
LogstorestirngYa/test-logstoreNama Logstore.

Elemen respons

Element

Type

Description

Example

Tidak ada yang didefinisikan.

Contoh

Respons sukses

JSONformat

{}

Kode kesalahan

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.