CreateLogtailPipelineConfig - Simple Log Service

Membuat 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:CreateLogtailPipelineConfig

create

*全部资源

*

log:TLSVersion

None

Sintaks permintaan

POST /pipelineconfigs HTTP/1.1

Parameter permintaan

Parameter	Type	Required	Description	Example
project	string	Yes	Nama proyek.	test-project
body	object	No	Konten konfigurasi pipeline Logtail.
configName	string	Yes	Nama konfigurasi. Catatan Nama konfigurasi harus unik dalam proyek dan tidak dapat diubah setelah konfigurasi dibuat. Nama tersebut harus mengikuti aturan berikut: Hanya boleh berisi huruf kecil, angka, tanda hubung (-), dan garis bawah (_). Harus dimulai dan diakhiri dengan huruf kecil atau angka. Panjangnya harus antara 2 hingga 128 karakter.	test-config
logSample	string	No	Contoh log. Beberapa entri log didukung.	2022-06-14 11:13:29.796 \| DEBUG \| __main__::1 - hello world
global	object	No	Konfigurasi global.
inputs	array<object>	Yes	Daftar plugin input. Penting Saat ini, Anda hanya dapat mengonfigurasi satu plugin input.
	object	No	Plugin input. Catatan Untuk informasi tentang parameter plugin input file, lihat File plugin. Untuk informasi tentang parameter plugin input lainnya, lihat Processing plugins.	{ "Type": "input_file", "FilePaths": ["/var/log/*.log"] }
processors	array<object>	No	Daftar plugin pemrosesan. Catatan Plugin pemrosesan diklasifikasikan menjadi plugin pemrosesan native dan plugin pemrosesan ekstensi. Untuk informasi selengkapnya, lihat Processing plugins. Penting Catatan Plugin native hanya dapat digunakan untuk mengumpulkan log teks. Anda tidak dapat menambahkan plugin native dan plugin ekstensi secara bersamaan. Saat menggunakan plugin native, persyaratan berikut harus dipenuhi: Plugin pemrosesan pertama harus berupa plugin parsing berbasis ekspresi reguler, plugin parsing berbasis pemisah, plugin parsing berbasis JSON, plugin parsing berbasis NGINX, plugin parsing berbasis Apache, atau plugin parsing berbasis IIS. Setelah plugin pemrosesan pertama, Anda hanya dapat menambahkan satu plugin pemrosesan parsing waktu, satu plugin filter, dan beberapa plugin penyamaran data.
	object	No	Plugin pemrosesan. Catatan Untuk informasi selengkapnya tentang plugin pemrosesan native dan ekstensi, lihat Processing plugins.	{ "Type": "processor_parse_json_native", "SourceKey": "content" }
aggregators	array<object>	No	Daftar plugin agregasi. Penting Parameter ini hanya berlaku saat Anda menggunakan plugin pemrosesan ekstensi. Anda dapat menggunakan maksimal satu plugin agregasi.
	object	No	Plugin agregasi.
flushers	array<object>	Yes	Daftar plugin output. Penting Saat ini, Anda hanya dapat menambahkan satu plugin flusher_sls.
	object	No	Plugin output.	{ "Type": "flusher_sls", "Logstore": "test" }
task	object	No	Konfigurasi task.

Konfigurasi Global

Parameter	Type	Required	Default value	Example	Description
TopicType	string	No	None	filepath	Jenis topik. Nilai yang valid: filepath: mengekstrak informasi dari jalur file log sebagai topik. Nilai ini hanya berlaku ketika plugin input adalah input_file. machine_group_topic: menggunakan topik dari kelompok mesin tempat konfigurasi diterapkan. custom: topik kustom. Untuk informasi selengkapnya, lihat Log topic.
TopicFormat	string	No. Parameter ini wajib jika Anda mengatur TopicType ke filepath atau custom.	/	/var/log/(.*).log	Format topik.
EnableTimestampNanosecond	bool	No	false	false	Menentukan apakah akan mengaktifkan presisi nanodetik untuk stempel waktu.
PipelineMetaTagKey	object	No	None	{"HOST_NAME":"__hostname__"}	Penting Parameter ini hanya didukung oleh LoongCollector 3.0.10 dan versi yang lebih baru. Mengontrol tag yang terkait dengan informasi LoongCollector. Kunci adalah nama parameter tag, dan nilai adalah nama field tag dalam log. Jika Anda mengatur nilai ke __default__, nilai default digunakan. Jika Anda mengatur nilai ke string kosong, tag tersebut dihapus. Tag berikut dapat dikonfigurasi: HOST_NAME: hostname. Tag ini ditambahkan secara default. Nilai default adalah "__hostname__". AGENT_TAG: pengenal 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__".

Plugin Input

Plugin Input File

Parameter	Type	Required	Default value	Example	Description
Type	string	Yes	/	input_file	Jenis plugin. Atur nilainya ke input_file.
FilePaths	[string]	Yes	/	["/var/log/*.log"]	Jalur file log yang ingin Anda kumpulkan. Saat ini, hanya satu jalur yang didukung. Anda dapat menggunakan karakter wildcard () dan () dalam jalur tersebut. Karakter wildcard double-asterisk (*) hanya dapat muncul sekali dan hanya dapat digunakan sebelum nama file.
MaxDirSearchDepth	uint	No	0	0	Kedalaman maksimum direktori yang cocok dengan karakter wildcard double-asterisk () dalam jalur file. Parameter ini hanya berlaku jika jalur file berisi karakter wildcard double-asterisk (). Nilai yang valid: 0 hingga 1000.
ExcludeFilePaths	[string]	No	None	["/home/admin/*.log"]	Daftar hitam jalur file. Jalurnya harus berupa jalur mutlak. Karakter wildcard (*) didukung.
ExcludeFiles	[string]	No	None	["app*.log", "password"]	Daftar hitam nama file. Karakter wildcard (*) didukung.
ExcludeDirs	[string]	No	None	["/home/admin/dir1", "/home/admin/dir2*"]	Daftar hitam direktori. Jalurnya harus berupa jalur mutlak. Karakter wildcard (*) didukung.
FileEncoding	string	No	utf8	utf8	Format encoding file. Nilai yang valid: utf8 dan gbk.
TailSizeKB	uint	No	1024	1024	Ukuran data yang dikumpulkan dari akhir file saat konfigurasi diterapkan untuk pertama kalinya. Jika ukuran file lebih kecil dari nilai yang ditentukan, data dikumpulkan dari awal file. Satuan: KB. Nilai yang valid: 0 hingga 10485760.
Multiline	object	No	None	/	Opsi agregasi log multiline.
Multiline.Mode	string	No	custom	custom	Mode agregasi log multiline. Nilai yang valid: custom dan JSON.
Multiline.StartPattern	string	Required if Multiline.Mode is set to custom	None	\d+-\d+-\d+.*	Ekspresi reguler untuk mencocokkan baris pertama log multiline.
EnableContainerDiscovery	bool	No	false	true	Menentukan apakah akan mengaktifkan penemuan kontainer. Parameter ini hanya berlaku ketika Logtail berjalan dalam mode DaemonSet dan jalur pengumpulan adalah jalur di dalam kontainer.
ContainerFilters	object	No	None	/	Opsi pemfilteran kontainer. Beberapa opsi digabungkan menggunakan operator AND. Parameter ini hanya berlaku jika Anda mengatur EnableContainerDiscovery ke true.
ContainerFilters.K8sNamespaceRegex	string	No	None	default	Untuk kontainer di lingkungan Kubernetes, menentukan namespace pod tempat kontainer yang akan dikumpulkan berada. Jika Anda tidak menentukan parameter ini, semua kontainer dikumpulkan. Ekspresi reguler didukung.
ContainerFilters.K8sPodRegex	string	No	None	test-pod	Untuk kontainer di lingkungan Kubernetes, menentukan nama pod tempat kontainer yang akan dikumpulkan berada. Jika Anda tidak menentukan parameter ini, semua kontainer dikumpulkan. Ekspresi reguler didukung.
ContainerFilters.IncludeK8sLabel	map	No	None	/	Untuk kontainer di lingkungan Kubernetes, menentukan label pod tempat kontainer yang akan dikumpulkan berada. Beberapa kondisi digabungkan menggunakan operator OR. Jika Anda tidak menentukan parameter ini, semua kontainer dikumpulkan. Ekspresi reguler didukung. Kunci dalam map adalah nama label pod, dan nilai adalah nilai label pod. Aturan berikut berlaku: Jika nilai dalam map kosong, pod yang berisi kunci tersebut dicocokkan. Jika nilai dalam map tidak kosong: Jika nilai dimulai dengan `^` dan diakhiri dengan `$`, pod yang memiliki nama label yang cocok dengan kunci dan nilai label yang cocok dengan ekspresi reguler dicocokkan. Dalam kasus lain, pod yang memiliki nama label yang cocok dengan kunci dan nilai label yang cocok dengan nilai tersebut dicocokkan.
ContainerFilters.ExcludeK8sLabel	map	No	None	/	Untuk kontainer di lingkungan Kubernetes, menentukan label pod tempat kontainer yang akan dikecualikan berada. Beberapa kondisi digabungkan menggunakan operator OR. Jika Anda tidak menentukan parameter ini, semua kontainer dikumpulkan. Ekspresi reguler didukung. Kunci dalam map adalah nama label pod, dan nilai adalah nilai label pod. Aturan berikut berlaku: Jika nilai dalam map kosong, pod yang berisi kunci tersebut dicocokkan. Jika nilai dalam map tidak kosong: Jika nilai dimulai dengan `^` dan diakhiri dengan `$`, pod yang memiliki nama label yang cocok dengan kunci dan nilai label yang cocok dengan ekspresi reguler dicocokkan. Dalam kasus lain, pod yang memiliki nama label yang cocok dengan kunci dan nilai label yang cocok dengan nilai tersebut dicocokkan.
ContainerFilters.K8sContainerRegex	string	No	None	test-container	Untuk kontainer di lingkungan Kubernetes, menentukan nama kontainer yang akan dikumpulkan. Jika Anda tidak menentukan parameter ini, semua kontainer dikumpulkan. Ekspresi reguler didukung.
ContainerFilters.IncludeEnv	map	No	None	/	Variabel lingkungan kontainer yang akan dikumpulkan. Beberapa kondisi digabungkan menggunakan operator OR. Jika Anda tidak menentukan parameter ini, semua kontainer dikumpulkan. Ekspresi reguler didukung. Kunci dalam map adalah nama variabel lingkungan, dan nilai adalah nilai variabel lingkungan. Aturan berikut berlaku: Jika nilai dalam map kosong, kontainer yang variabel lingkungannya berisi kunci tersebut dicocokkan. Jika nilai dalam map tidak kosong: Jika nilai dimulai dengan `^` dan diakhiri dengan `$`, kontainer yang memiliki nama variabel lingkungan yang cocok dengan kunci dan nilai variabel lingkungan yang cocok dengan ekspresi reguler dicocokkan. Dalam kasus lain, kontainer yang memiliki nama variabel lingkungan yang cocok dengan kunci dan nilai variabel lingkungan yang cocok dengan nilai tersebut dicocokkan.
ContainerFilters.ExcludeEnv	map	No	None	/	Variabel lingkungan kontainer yang akan dikecualikan. Beberapa kondisi digabungkan menggunakan operator OR. Jika Anda tidak menentukan parameter ini, semua kontainer dikumpulkan. Ekspresi reguler didukung. Kunci dalam map adalah nama variabel lingkungan, dan nilai adalah nilai variabel lingkungan. Aturan berikut berlaku: Jika nilai dalam map kosong, kontainer yang variabel lingkungannya berisi kunci tersebut dicocokkan. Jika nilai dalam map tidak kosong: Jika nilai dimulai dengan `^` dan diakhiri dengan `$`, kontainer yang memiliki nama variabel lingkungan yang cocok dengan kunci dan nilai variabel lingkungan yang cocok dengan ekspresi reguler dicocokkan. Dalam kasus lain, kontainer yang memiliki nama variabel lingkungan yang cocok dengan kunci dan nilai variabel lingkungan yang cocok dengan nilai tersebut dicocokkan.
ContainerFilters.IncludeContainerLabel	map	No	None	/	Label kontainer yang akan dikumpulkan. Beberapa kondisi digabungkan menggunakan operator OR. Jika Anda tidak menentukan parameter ini, nilai default-nya kosong, yang berarti semua kontainer dikumpulkan. Ekspresi reguler didukung. Kunci dalam map adalah nama label kontainer, dan nilai adalah nilai label kontainer. Aturan berikut berlaku: Jika nilai dalam map kosong, kontainer yang berisi kunci tersebut dicocokkan. Jika nilai dalam map tidak kosong: Jika nilai dimulai dengan `^` dan diakhiri dengan `$`, kontainer yang memiliki nama label yang cocok dengan kunci dan nilai label yang cocok dengan ekspresi reguler dicocokkan. Dalam kasus lain, kontainer yang memiliki nama label yang cocok dengan kunci dan nilai label yang cocok dengan nilai tersebut dicocokkan.
ContainerFilters.ExcludeContainerLabel	map	No	None	/	Label kontainer yang akan dikecualikan. Beberapa kondisi digabungkan menggunakan operator OR. Jika Anda tidak menentukan parameter ini, nilai default-nya kosong, yang berarti semua kontainer dikumpulkan. Ekspresi reguler didukung. Kunci dalam map adalah nama label kontainer, dan nilai adalah nilai label kontainer. Aturan berikut berlaku: Jika nilai dalam map kosong, kontainer yang berisi kunci tersebut dicocokkan. Jika nilai dalam map tidak kosong: Jika nilai dimulai dengan `^` dan diakhiri dengan `$`, kontainer yang memiliki nama label yang cocok dengan kunci dan nilai label yang cocok dengan ekspresi reguler dicocokkan. Dalam kasus lain, kontainer yang memiliki nama label yang cocok dengan kunci dan nilai label yang cocok dengan nilai tersebut dicocokkan.
ExternalK8sLabelTag	map	No	None	/	Untuk kontainer di lingkungan Kubernetes, menentukan tag terkait label pod yang ingin Anda tambahkan ke log. Kunci dalam map adalah nama label pod, dan nilai adalah nama tag yang sesuai. Misalnya, jika Anda menambahkan `app: k8s_label_app` ke map dan sebuah pod berisi label `app=serviceA`, informasi tersebut ditambahkan ke log sebagai tag. Field yang ditambahkan adalah `__tag__:k8s_label_app: serviceA`. Jika pod tidak berisi label `app`, field kosong `__tag__:k8s_label_app:` ditambahkan.
ExternalEnvTag	map	No	None	/	Untuk kontainer di lingkungan Kubernetes, menentukan tag terkait variabel lingkungan kontainer yang ingin Anda tambahkan ke log. Kunci dalam map adalah nama variabel lingkungan, dan nilai adalah nama tag yang sesuai. Misalnya, jika Anda menambahkan `VERSION: env_version` ke map dan sebuah kontainer memiliki variabel lingkungan `VERSION=v1.0.0`, informasi tersebut ditambahkan ke log sebagai tag. Field yang ditambahkan adalah `__tag__:env_version: v1.0.0`. Jika kontainer tidak memiliki variabel lingkungan `VERSION`, field kosong `__tag__:env_version:` ditambahkan.
CollectingContainersMeta	bool	No	false	true	Menentukan apakah akan mengaktifkan pratinjau metadata kontainer.
AppendingLogPositionMeta	bool	No	false	false	Menentukan apakah akan menambahkan metadata file tempat log tersebut berada. Metadata tersebut mencakup field __tag__:__inode__ dan field __file_offset__.
AllowingIncludedByMultiConfigs	bool	No	false	false	Menentukan apakah akan mengizinkan konfigurasi saat ini mengumpulkan file yang cocok dengan konfigurasi lain.
Tags	object	No	None	{"FileInodeTagKey":"__inode__"}	Penting Parameter ini hanya didukung oleh LoongCollector 3.0.10 dan versi yang lebih baru. Mengontrol tag yang terkait dengan pengumpulan file. Kunci adalah nama parameter tag, dan nilai adalah nama field tag dalam log. Jika Anda mengatur nilai ke __default__, nilai default digunakan. Jika Anda mengatur nilai ke string kosong, tag tersebut dihapus. Tag berikut dapat dikonfigurasi: FileInodeTagKey: inode file. Tag ini tidak ditambahkan secara default. Nilai default adalah "__inode__". FilePathTagKey: jalur file. Tag ini ditambahkan secara default. Nilai default adalah "__path__". Parameter berikut hanya berlaku jika Anda mengatur parameter EnableContainerDiscovery ke true. K8sNamespaceTagKey: namespace kontainer tempat file tersebut berada. Tag ini ditambahkan secara default. Nilai default adalah "_namespace_". K8sPodNameTagKey: nama pod tempat file tersebut berada. Tag ini ditambahkan secara default. Nilai default adalah "_pod_name_". K8sPodUidTagKey: UID pod tempat file tersebut berada. Tag ini ditambahkan secara default. Nilai default adalah "_pod_uid_". ContainerNameTagKey: nama kontainer tempat file tersebut berada. Tag ini ditambahkan secara default. Nilai default adalah "_container_name_". ContainerIpTagKey: alamat IP kontainer tempat file tersebut berada. Tag ini ditambahkan secara default. Nilai default adalah "_container_ip_". ContainerImageNameTagKey: citra kontainer tempat file tersebut berada. Tag ini ditambahkan secara default. Nilai default adalah "_image_name_".
FileOffsetKey	string	No	None	__file_offset__	Penting Parameter ini hanya didukung oleh LoongCollector 3.0.10 dan versi yang lebih baru. Tag untuk posisi log dalam file. Tag ini tidak ditambahkan secara default. Nilai default adalah __file_offset__. Jika Anda mengatur nilai ke __default__, nilai default digunakan. Jika Anda mengatur nilai ke string kosong, tag tersebut dihapus. Jika parameter AppendingLogPositionMeta dan parameter Tags.FileInodeTagKey atau FileOffsetKey ditentukan secara bersamaan, parameter AppendingLogPositionMeta diabaikan.

Stdout Kontainer (Versi Lama)

Parameter	Type	Required	Default value	Example	Description
Type	string	Yes	/	service_docker_stdout	Jenis plugin. Atur nilainya ke service_docker_stdout.
Stdout	Boolean	No	true	true	Menentukan apakah akan mengumpulkan stdout.
Stderr	Boolean	No	true	true	Menentukan apakah akan mengumpulkan stderr.
StartLogMaxOffset	Integer	No	128×1024	131072	Panjang data historis yang dikumpulkan untuk pertama kalinya. Satuan: byte. Kami menyarankan agar Anda mengatur parameter ini ke nilai antara 131072 dan 1048576.
IncludeLabel	Map, where LabelKey and LabelValue are of the String type	No	None		Daftar putih label kontainer. Parameter ini menentukan kontainer dari mana Anda ingin mengumpulkan log. Secara default, parameter ini dibiarkan kosong, yang berarti output standar semua kontainer dikumpulkan. Jika Anda ingin mengonfigurasi daftar putih label kontainer, Anda harus menentukan LabelKey. LabelValue bersifat opsional. Jika LabelValue kosong, kontainer yang labelnya berisi LabelKey dicocokkan. Jika LabelValue tidak kosong, hanya kontainer yang labelnya berisi LabelKey=LabelValue yang dicocokkan. Secara default, LabelValue digunakan untuk pencocokan string. Pencocokan hanya ditemukan jika LabelValue identik dengan nilai label kontainer. Jika nilai dimulai dengan `^` dan diakhiri dengan `$`, nilai tersebut digunakan untuk pencocokan ekspresi reguler. Misalnya, jika Anda mengatur LabelKey ke `io.kubernetes.container.name` dan LabelValue ke `^(nginx\|cube)$`, kontainer bernama nginx dan cube dicocokkan. Beberapa daftar putih digabungkan menggunakan operator OR. Sebuah kontainer dicocokkan jika labelnya memenuhi kondisi pada salah satu daftar putih.
ExcludeLabel	Map, where LabelKey and LabelValue are of the String type	No	None		Daftar hitam label kontainer. Parameter ini menentukan kontainer yang ingin Anda kecualikan. Secara default, parameter ini dibiarkan kosong, yang berarti tidak ada kontainer yang dikecualikan. Jika Anda ingin mengonfigurasi daftar hitam label kontainer, Anda harus menentukan LabelKey. LabelValue bersifat opsional. Jika LabelValue kosong, kontainer yang labelnya berisi LabelKey dikecualikan. Jika LabelValue tidak kosong, hanya kontainer yang labelnya berisi LabelKey=LabelValue yang dikecualikan. Secara default, LabelValue digunakan untuk pencocokan string. Pencocokan hanya ditemukan jika LabelValue identik dengan nilai label kontainer. Jika nilai dimulai dengan `^` dan diakhiri dengan `$`, nilai tersebut digunakan untuk pencocokan ekspresi reguler. Misalnya, jika Anda mengatur LabelKey ke `io.kubernetes.container.name` dan LabelValue ke `^(nginx\|cube)$`, kontainer bernama nginx dan cube dicocokkan. Beberapa daftar hitam digabungkan menggunakan operator OR. Sebuah kontainer dikecualikan jika labelnya memenuhi kondisi pada salah satu daftar hitam.
IncludeEnv	Map, where EnvKey and EnvValue are of the String type	No	None		Daftar putih variabel lingkungan. Parameter ini menentukan kontainer dari mana Anda ingin mengumpulkan log. Secara default, parameter ini dibiarkan kosong, yang berarti output standar semua kontainer dikumpulkan. Jika Anda ingin mengonfigurasi daftar putih variabel lingkungan, Anda harus menentukan EnvKey. EnvValue bersifat opsional. Jika EnvValue kosong, kontainer yang variabel lingkungannya berisi EnvKey dicocokkan. Jika EnvValue tidak kosong, hanya kontainer yang variabel lingkungannya berisi EnvKey=EnvValue yang dicocokkan. Secara default, EnvValue digunakan untuk pencocokan string. Pencocokan hanya ditemukan jika EnvValue identik dengan nilai variabel lingkungan. Jika nilai dimulai dengan `^` dan diakhiri dengan `$`, nilai tersebut digunakan untuk pencocokan ekspresi reguler. Misalnya, jika Anda mengatur EnvKey ke `NGINX_SERVICE_PORT` dan EnvValue ke `^(80
ExcludeEnv	Map, where EnvKey and EnvValue are of the String type	No	None		Daftar hitam variabel lingkungan. Parameter ini menentukan kontainer yang ingin Anda kecualikan. Secara default, parameter ini dibiarkan kosong, yang berarti tidak ada kontainer yang dikecualikan. Jika Anda ingin mengonfigurasi daftar hitam variabel lingkungan, Anda harus menentukan EnvKey. EnvValue bersifat opsional. Jika EnvValue kosong, log dari kontainer yang variabel lingkungannya berisi EnvKey dikecualikan. Jika EnvValue tidak kosong, hanya kontainer yang variabel lingkungannya berisi EnvKey=EnvValue yang dikecualikan. Secara default, EnvValue digunakan untuk pencocokan string. Pencocokan hanya ditemukan jika EnvValue identik dengan nilai variabel lingkungan. Jika nilai dimulai dengan `^` dan diakhiri dengan `$`, nilai tersebut digunakan untuk pencocokan ekspresi reguler. Misalnya, jika Anda mengatur EnvKey ke `NGINX_SERVICE_PORT` dan EnvValue ke `^(80\|6379)$`, kontainer yang port layanannya 80 dan 6379 dicocokkan. Beberapa daftar hitam digabungkan menggunakan operator OR. Sebuah kontainer dikecualikan jika variabel lingkungannya memenuhi kondisi pada salah satu pasangan kunci-nilai.
IncludeK8sLabel	Map, where LabelKey and LabelValue are of the String type	No	None		Daftar putih label Kubernetes (didefinisikan dalam template.metadata). Parameter ini menentukan kontainer dari mana Anda ingin mengumpulkan log. Jika Anda ingin mengonfigurasi daftar putih label Kubernetes, Anda harus menentukan LabelKey. LabelValue bersifat opsional. Jika LabelValue kosong, kontainer yang label Kubernetes-nya berisi LabelKey dicocokkan. Jika LabelValue tidak kosong, hanya kontainer yang label Kubernetes-nya berisi LabelKey=LabelValue yang dicocokkan. Secara default, LabelValue digunakan untuk pencocokan string. Pencocokan hanya ditemukan jika LabelValue identik dengan nilai label Kubernetes. Jika nilai dimulai dengan `^` dan diakhiri dengan `$`, nilai tersebut digunakan untuk pencocokan ekspresi reguler. Misalnya, jika Anda mengatur LabelKey ke `app` dan LabelValue ke `^(test1\|test2)$`, kontainer yang label Kubernetes-nya berisi app:test1 atau app:test2 dicocokkan. Beberapa daftar putih digabungkan menggunakan operator OR. Sebuah kontainer dicocokkan jika label Kubernetes-nya memenuhi kondisi pada salah satu daftar putih.
ExcludeK8sLabel	Map, where LabelKey and LabelValue are of the String type	No	None		Daftar hitam label Kubernetes (didefinisikan dalam template.metadata). Parameter ini menentukan kontainer yang ingin Anda kecualikan. Jika Anda ingin mengonfigurasi daftar hitam label Kubernetes, Anda harus menentukan LabelKey. LabelValue bersifat opsional. Jika LabelValue kosong, kontainer yang label Kubernetes-nya berisi LabelKey dikecualikan. Jika LabelValue tidak kosong, hanya kontainer yang label Kubernetes-nya berisi LabelKey=LabelValue yang dikecualikan. Secara default, LabelValue digunakan untuk pencocokan string. Pencocokan hanya ditemukan jika LabelValue identik dengan nilai label Kubernetes. Jika nilai dimulai dengan `^` dan diakhiri dengan `$`, nilai tersebut digunakan untuk pencocokan ekspresi reguler. Misalnya, jika Anda mengatur LabelKey ke `app` dan LabelValue ke `^(test1\|test2)$`, kontainer yang label Kubernetes-nya berisi app:test1 atau app:test2 dicocokkan. Beberapa daftar hitam digabungkan menggunakan operator OR. Sebuah kontainer dikecualikan jika label Kubernetes-nya memenuhi kondisi pada salah satu daftar hitam.
K8sNamespaceRegex	String	No	None	^(default\|nginx)$	Namespace berdasarkan mana Anda ingin mengumpulkan log dari kontainer. Ekspresi reguler didukung. Misalnya, jika Anda mengatur parameter ini ke `^(default\|nginx)$`, semua kontainer di namespace nginx dan default dicocokkan.
K8sPodRegex	String	No	None	^(nginx-log-demo.*)$	Nama pod berdasarkan mana Anda ingin mengumpulkan log dari kontainer. Ekspresi reguler didukung. Misalnya, jika Anda mengatur parameter ini ke `^(nginx-log-demo.*)$`, semua kontainer di pod yang namanya dimulai dengan nginx-log-demo dicocokkan.
K8sContainerRegex	String	No	None	^(container-test)$	Nama kontainer berdasarkan mana Anda ingin mengumpulkan log. Nama kontainer Kubernetes didefinisikan dalam spec.containers. Ekspresi reguler didukung. Misalnya, jika Anda mengatur parameter ini ke `^(container-test)$`, semua kontainer bernama container-test dicocokkan.

Parameter Pemrosesan Data

Parameter	Type	Required	Default value	Example	Description
BeginLineRegex	String	No	None		Ekspresi reguler untuk mencocokkan baris pertama log. Jika Anda membiarkan parameter ini kosong, mode single-line digunakan. Jika awal baris cocok dengan ekspresi reguler, baris tersebut dianggap sebagai baris pertama log baru. Jika tidak, baris tersebut ditambahkan ke log sebelumnya.
BeginLineCheckLength	Integer	No	None		Panjang maksimum untuk pencocokan baris pertama. Satuan: byte. Nilai default adalah 10 × 1024 byte. Jika ekspresi reguler untuk pencocokan baris pertama dapat dicocokkan dalam N byte pertama, kami menyarankan agar Anda mengatur parameter ini untuk meningkatkan efisiensi pencocokan.
BeginLineTimeoutMs	Integer	No	None		Periode timeout untuk pencocokan baris pertama. Satuan: milidetik. Nilai default adalah 3.000 milidetik. Jika tidak ada log baru yang dihasilkan dalam 3.000 milidetik, pencocokan berakhir, dan log terakhir diunggah ke Simple Log Service.
MaxLogSize	Integer	No	None		Panjang maksimum log. Nilai default adalah 0. Satuan: byte. Nilai default adalah 512 × 1024 byte. Jika panjang log melebihi nilai yang ditentukan, sistem berhenti mencari baris pertama dan langsung mengunggah log tersebut.
ExternalK8sLabelTag	Map, where LabelKey and LabelValue are of the String type	No	None		Tag label Kubernetes (didefinisikan dalam template.metadata). Setelah Anda mengonfigurasi parameter ini, iLogtail menambahkan field terkait label Kubernetes ke log. Misalnya, jika Anda mengatur LabelKey ke app dan LabelValue ke `k8s_label_app`, dan sebuah pod berisi label `app=serviceA`, iLogtail menambahkan informasi ini ke log. Field yang ditambahkan adalah k8s_label_app: serviceA. Jika pod tidak berisi label app, field kosong k8s_label_app: ditambahkan.
ExternalEnvTag	Map, where EnvKey and EnvValue are of the String type	No	None		Tag variabel lingkungan kontainer. Setelah Anda mengonfigurasi parameter ini, iLogtail menambahkan field terkait variabel lingkungan kontainer ke log. Misalnya, jika Anda mengatur EnvKey ke `VERSION` dan EnvValue ke `env_version`, dan sebuah kontainer memiliki variabel lingkungan `VERSION=v1.0.0`, informasi ini ditambahkan ke log sebagai tag. Field yang ditambahkan adalah env_version: v1.0.0. Jika kontainer tidak memiliki variabel lingkungan VERSION, field kosong env_version: ditambahkan.

Variabel Lingkungan Pemrosesan Data

Environment variable Type Required Default value Example Description

ALIYUN_LOG_ENV_TAGS

String

None

Tag variabel lingkungan global. Setelah Anda mengonfigurasi parameter ini, iLogtail menambahkan field terkait variabel lingkungan kontainer tempat iLogtail berada ke log. Pisahkan beberapa nama variabel lingkungan dengan tanda pipa vertikal (|).

Misalnya, jika Anda mengatur parameter ini ke node_name|node_ip dan kontainer iLogtail mengekspos variabel lingkungan terkait, informasi ini ditambahkan ke log sebagai tag. Field yang ditambahkan adalah node_ip:172.16.0.1 dan node_name:worknode.

Stdout Kontainer (Versi Baru)

Parameter	Type	Required	Default value	Example	Description
Type	string	Yes	/	input_container_stdio	Jenis plugin. Atur nilainya ke `input_container_stdio`.
IgnoringStdout	Boolean	No	false	false	Menentukan apakah akan mengabaikan stdout. `false` menunjukkan bahwa stdout dikumpulkan. `true` menunjukkan bahwa stdout tidak dikumpulkan.
IgnoringStderr	Boolean	No	false	false	Menentukan apakah akan mengabaikan stderr. `false` menunjukkan bahwa stderr dikumpulkan. `true` menunjukkan bahwa stderr tidak dikumpulkan.
TailSizeKB	Integer (uint)	No	1024	2048	Ukuran data yang dikumpulkan dari akhir file saat konfigurasi diterapkan untuk pertama kalinya. Satuan: KB. Jika ukuran file lebih kecil dari nilai yang ditentukan, data dikumpulkan dari awal file. Nilai yang valid: 0 hingga 104857600.
AllowingIncludedByMultiConfigs	Boolean	No	false	true	Menentukan apakah akan mengizinkan konfigurasi saat ini mengumpulkan log stdout dari kontainer yang cocok dengan konfigurasi lain. Nilai default `false` mencegah pengumpulan duplikat oleh beberapa konfigurasi.
ContainerFilters	Object	No	None	Lihat tabel opsi pemfilteran kontainer (ContainerFilters) di bawah ini	Opsi pemfilteran kontainer. Beberapa opsi digabungkan menggunakan operator AND.
ExternalK8sLabelTag	Map, where LabelKey/LabelValue are String	No	None	{"app":"k8s_label_app"}	Untuk skenario Kubernetes: mengambil nilai dari label pod dan menambahkannya ke log sebagai tag. Kunci map adalah nama label pod, dan nilai adalah nama field log (nama tag). Jika sebuah pod tidak memiliki label yang ditentukan, field kosong ditambahkan.
ExternalEnvTag	Map, where EnvKey/EnvValue are String	No	None	{"VERSION":"env_version"}	Untuk skenario kontainer: mengambil nilai dari variabel lingkungan kontainer dan menambahkannya ke log sebagai tag. Kunci map adalah nama variabel lingkungan, dan nilai adalah nama field log (nama tag). Jika sebuah kontainer tidak memiliki variabel lingkungan yang ditentukan, field kosong ditambahkan.
Multiline	Object	No	None	Lihat tabel opsi agregasi multiline (Multiline) di bawah ini	Opsi agregasi multiline.

Opsi Pemfilteran Kontainer (ContainerFilters)

Parameter	Type	Required	Default value	Example	Description
IncludeK8sLabel	Map, where LabelKey/LabelValue are String	No	None	{"app":"^(test1\|test2)$"}	Daftar putih label Kubernetes (didefinisikan dalam `metadata.labels` sebuah pod). Parameter ini menentukan kontainer dari mana Anda ingin mengumpulkan log. Secara default, parameter ini dibiarkan kosong, yang berarti output standar semua kontainer dikumpulkan. Jika LabelValue kosong, kontainer yang label Kubernetes-nya berisi LabelKey dicocokkan. Jika LabelValue tidak kosong, hanya kontainer yang label Kubernetes-nya berisi LabelKey=LabelValue yang dicocokkan. Secara default, LabelValue digunakan untuk pencocokan string. Pencocokan hanya ditemukan jika LabelValue identik dengan nilai label Kubernetes. Jika nilai dimulai dengan `^` dan diakhiri dengan `$`, nilai tersebut digunakan untuk pencocokan ekspresi reguler. Beberapa daftar putih digabungkan menggunakan operator OR. Sebuah kontainer dicocokkan jika label Kubernetes-nya memenuhi kondisi pada salah satu daftar putih.
ExcludeK8sLabel	Map, where LabelKey/LabelValue are String	No	None	{"env":"^(test.*)$"}	Daftar hitam label Kubernetes (didefinisikan dalam `metadata.labels` sebuah pod). Parameter ini menentukan kontainer yang ingin Anda kecualikan. Secara default, parameter ini dibiarkan kosong, yang berarti tidak ada kontainer yang dikecualikan. Jika LabelValue kosong, kontainer yang label Kubernetes-nya berisi LabelKey dikecualikan. Jika LabelValue tidak kosong, hanya kontainer yang label Kubernetes-nya berisi LabelKey=LabelValue yang dikecualikan. Secara default, LabelValue digunakan untuk pencocokan string. Pencocokan hanya ditemukan jika LabelValue identik dengan nilai label Kubernetes. Jika nilai dimulai dengan `^` dan diakhiri dengan `$`, nilai tersebut digunakan untuk pencocokan ekspresi reguler. Beberapa daftar hitam digabungkan menggunakan operator OR. Sebuah kontainer dikecualikan jika label Kubernetes-nya memenuhi kondisi pada salah satu daftar hitam.
IncludeEnv	Map, where EnvKey/EnvValue are String	No	None	{"NGINX_SERVICE_PORT":"^(80\|6379)$"}	Daftar putih variabel lingkungan. Parameter ini menentukan kontainer dari mana Anda ingin mengumpulkan log. Secara default, parameter ini dibiarkan kosong, yang berarti output standar semua kontainer dikumpulkan. Jika Anda ingin mengonfigurasi daftar putih variabel lingkungan, Anda harus menentukan EnvKey. EnvValue bersifat opsional. Jika EnvValue kosong, kontainer yang variabel lingkungannya berisi EnvKey dicocokkan. Jika EnvValue tidak kosong, hanya kontainer yang variabel lingkungannya berisi EnvKey=EnvValue yang dicocokkan. Secara default, EnvValue digunakan untuk pencocokan string. Pencocokan hanya ditemukan jika EnvValue identik dengan nilai variabel lingkungan. Jika nilai dimulai dengan `^` dan diakhiri dengan `$`, nilai tersebut digunakan untuk pencocokan ekspresi reguler. Beberapa daftar putih digabungkan menggunakan operator OR. Sebuah kontainer dicocokkan jika variabel lingkungannya memenuhi kondisi pada salah satu pasangan kunci-nilai.
ExcludeEnv	Map, where EnvKey/EnvValue are String	No	None	{"POD_NAMESPACE":"kube-system"}	Daftar hitam variabel lingkungan. Parameter ini menentukan kontainer yang ingin Anda kecualikan. Secara default, parameter ini dibiarkan kosong, yang berarti tidak ada kontainer yang dikecualikan. Jika Anda ingin mengonfigurasi daftar hitam variabel lingkungan, Anda harus menentukan EnvKey. EnvValue bersifat opsional. Jika EnvValue kosong, kontainer yang variabel lingkungannya berisi EnvKey dikecualikan. Jika EnvValue tidak kosong, hanya kontainer yang variabel lingkungannya berisi EnvKey=EnvValue yang dikecualikan. Secara default, EnvValue digunakan untuk pencocokan string. Pencocokan hanya ditemukan jika EnvValue identik dengan nilai variabel lingkungan. Jika nilai dimulai dengan `^` dan diakhiri dengan `$`, nilai tersebut digunakan untuk pencocokan ekspresi reguler. Beberapa daftar hitam digabungkan menggunakan operator OR. Sebuah kontainer dikecualikan jika variabel lingkungannya memenuhi kondisi pada salah satu pasangan kunci-nilai.
IncludeContainerLabel	Map, where LabelKey/LabelValue are String	No	None	{"io.kubernetes.container.name":"nginx"}	Daftar putih label kontainer. Parameter ini menentukan kontainer dari mana Anda ingin mengumpulkan log. Secara default, parameter ini dibiarkan kosong, yang berarti output standar semua kontainer dikumpulkan. Jika Anda ingin mengonfigurasi daftar putih label kontainer, Anda harus menentukan LabelKey. LabelValue bersifat opsional. Jika LabelValue kosong, kontainer yang labelnya berisi LabelKey dicocokkan. Jika LabelValue tidak kosong, hanya kontainer yang labelnya berisi LabelKey=LabelValue yang dicocokkan. Secara default, LabelValue digunakan untuk pencocokan string. Pencocokan hanya ditemukan jika LabelValue identik dengan nilai label kontainer. Jika nilai dimulai dengan `^` dan diakhiri dengan `$`, nilai tersebut digunakan untuk pencocokan ekspresi reguler. Beberapa daftar putih digabungkan menggunakan operator OR. Sebuah kontainer dicocokkan jika labelnya memenuhi kondisi pada salah satu daftar putih.
ExcludeContainerLabel	Map, where LabelKey/LabelValue are String	No	None	{"io.kubernetes.pod.namespace":"kube-system"}	Daftar hitam label kontainer. Parameter ini menentukan kontainer yang ingin Anda kecualikan. Secara default, parameter ini dibiarkan kosong, yang berarti tidak ada kontainer yang dikecualikan. Jika Anda ingin mengonfigurasi daftar hitam label kontainer, Anda harus menentukan LabelKey. LabelValue bersifat opsional. Jika LabelValue kosong, kontainer yang labelnya berisi LabelKey dikecualikan. Jika LabelValue tidak kosong, hanya kontainer yang labelnya berisi LabelKey=LabelValue yang dikecualikan. Secara default, LabelValue digunakan untuk pencocokan string. Pencocokan hanya ditemukan jika LabelValue identik dengan nilai label kontainer. Jika nilai dimulai dengan `^` dan diakhiri dengan `$`, nilai tersebut digunakan untuk pencocokan ekspresi reguler. Beberapa daftar hitam digabungkan menggunakan operator OR. Sebuah kontainer dikecualikan jika labelnya memenuhi kondisi pada salah satu daftar hitam.

Opsi Agregasi Multiline (Multiline)

Parameter	Type	Required	Default value	Example	Description
Mode	String	No	custom	custom	Mode agregasi multiline. Nilai yang valid: `custom` dan `JSON`. Jika Anda mengatur parameter ini ke `JSON`, log dibaca dan digabungkan dalam format JSON.
StartPattern	String	No (required in custom mode)	None	\d+-\d+-\d+.*	Ekspresi reguler untuk baris pertama log. Pencocokan menunjukkan awal log baru.
UnmatchedContentTreatment	String	No	single_line	discard	Metode pemrosesan untuk segmen log yang tidak cocok. Nilai yang valid: `discard` (membuang segmen) dan `single_line` (mengeluarkan setiap segmen yang tidak cocok sebagai log single-line).

Plugin Input MySQL

Parameter	Type	Required	Default value	Example	Description
Type	string	Yes	/	service_mysql	Jenis plugin. Atur nilainya ke service_mysql.
Address	string	No	127.0.0.1:3306	rm-*.mysql.rds.aliyuncs.com	Alamat database MySQL.
User	string	No	root	root	Nama pengguna yang digunakan untuk login ke database MySQL.
Password	string	No	None		Kata sandi pengguna yang digunakan untuk login ke database MySQL. Untuk alasan keamanan, Anda dapat mengatur nama pengguna dan kata sandi ke xxx. Setelah konfigurasi pengumpulan disinkronkan ke mesin lokal Anda, temukan konfigurasi tersebut di file `/usr/local/ilogtail/user_log_config.json` dan modifikasi. Untuk informasi selengkapnya, lihat Modify local configurations. Penting Jika Anda memodifikasi parameter ini di konsol, konfigurasi lokal akan ditimpa setelah sinkronisasi.
DataBase	string	No	/	project_database	Nama database.
DialTimeOutMs	int	No	5000	5000	Periode timeout untuk menghubungkan ke database MySQL. Satuan: ms.
ReadTimeOutMs	int	No	5000	5000	Periode timeout untuk membaca hasil kueri MySQL. Satuan: ms.
StateMent	string	No	/		Pernyataan SELECT. Jika Anda mengatur CheckPoint ke true, klausa WHERE dalam pernyataan SELECT harus berisi kolom checkpoint (CheckPointColumn). Anda dapat menggunakan tanda tanya (?) sebagai placeholder untuk bekerja dengan kolom checkpoint. Misalnya, Anda dapat mengatur 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 kueri diganti dengan ID yang sesuai dengan checkpoint.
Limit	bool	No	false	true	Menentukan apakah akan menggunakan LIMIT untuk paging. true: menggunakan LIMIT untuk paging. false (default): tidak menggunakan LIMIT untuk paging. Kami menyarankan agar Anda menggunakan LIMIT untuk paging. Jika Anda mengatur Limit ke true, sistem secara otomatis menambahkan klausa LIMIT ke pernyataan SELECT selama kueri SQL.
PageSize	int	No	/	10	Jumlah entri yang dikembalikan pada setiap halaman. Parameter ini wajib jika Anda mengatur Limit ke true.
MaxSyncSize	int	No	0	0	Jumlah maksimum catatan yang disinkronkan sekaligus. Nilai default adalah 0, yang berarti tidak ada batasan.
CheckPoint	bool	No	false	true	Menentukan apakah akan menggunakan checkpoint. true: menggunakan checkpoint. false (default): tidak menggunakan checkpoint. Checkpoint dapat digunakan sebagai titik awal untuk pengumpulan data berikutnya guna mengimplementasikan pengumpulan data inkremental.
CheckPointColumn	string	No	None	1	Nama kolom checkpoint. Parameter ini wajib jika Anda mengatur CheckPoint ke true. Peringatan Nilai dalam kolom ini harus bersifat inkremental. Jika tidak, data mungkin gagal dikumpulkan. Nilai maksimum dalam setiap hasil kueri digunakan sebagai input untuk kueri berikutnya.
CheckPointColumnType	string	No	None	int	Tipe data kolom checkpoint. Nilai yang valid: int dan time. Tipe int disimpan sebagai int64. Tipe time mendukung tipe date, datetime, dan time MySQL. Parameter ini wajib jika Anda mengatur CheckPoint ke true.
CheckPointStart	string	No	None		Nilai awal kolom checkpoint. Parameter ini wajib jika Anda mengatur CheckPoint ke true.
CheckPointSavePerPage	bool	No	true	true	Menentukan apakah akan menyimpan checkpoint untuk setiap halaman. true (default): menyimpan checkpoint untuk setiap halaman. false: menyimpan checkpoint setelah setiap sinkronisasi selesai.
IntervalMs	int	No	60000	60000	Interval sinkronisasi. Nilai default adalah 60.000. Satuan: ms.

Plugin Input HTTP

Parameter	Type	Required	Default value	Example	Description
Type	string	Yes	/	metric_http	Jenis plugin. Atur nilainya ke metric_http.
Address	string	Yes	/		Daftar URL. Penting URL harus dimulai dengan `http` atau `https`.
IntervalMs	int	Yes	/	10	Interval antar permintaan. Satuan: ms.
Method	string	No	GET	GET	Metode permintaan. Nilainya harus dalam huruf kapital.
Body	string	No	None		Konten badan HTTP.
Headers	map	No	None	{"key":"value"}	Konten header HTTP. Misalnya, `{"key":"value"}`. Ganti kontennya dengan nilai aktual.
PerAddressSleepMs	int	No	100	100	Interval antar permintaan untuk setiap URL dalam daftar Addresses. Satuan: ms.
ResponseTimeoutMs	int	No	5000	5000	Periode timeout permintaan. Satuan: ms.
IncludeBody	bool	No	false	true	Menentukan apakah akan mengumpulkan badan permintaan. Nilai default adalah false. Jika Anda mengatur parameter ini ke true, konten badan permintaan disimpan dalam kunci bernama content.
FollowRedirects	bool	No	false	false	Menentukan apakah akan menangani pengalihan secara otomatis.
InsecureSkipVerify	bool	No	false	false	Menentukan apakah akan melewati pemeriksaan keamanan HTTPS.
ResponseStringMatch	string	No	/		Melakukan pemeriksaan ekspresi reguler pada konten badan yang dikembalikan. Hasil pemeriksaan disimpan dalam kunci bernama _response_match_. Jika ditemukan kecocokan, nilainya adalah yes. Jika tidak ditemukan kecocokan, nilainya adalah no.

Plugin Input Syslog

Parameter	Type	Required	Default value	Example	Description
Type	string	Yes	/	service_syslog	Jenis plugin. Atur nilainya ke service_syslog.
Address	string	No	tcp://127.0.0.1:9999		Protokol, alamat, dan port yang didengarkan oleh Logtail. Logtail mendengarkan protokol, alamat, dan port yang ditentukan serta mendapatkan data log. Formatnya adalah `[tcp/udp]://[` ip `]:[` port `]`. Jika Anda tidak mengonfigurasi parameter ini, nilai default `tcp://127.0.0.1:9999` digunakan. Ini menunjukkan bahwa hanya log yang diteruskan dari mesin lokal yang dapat diterima. Catatan Protokol, alamat, dan nomor port yang ditentukan dalam konfigurasi Logtail harus sama dengan aturan pengalihan yang ditentukan 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`. Ini menunjukkan bahwa Logtail mendengarkan semua alamat IP server.
ParseProtocol	string	No	None	rfc3164	Protokol yang digunakan untuk mengurai log. Nilai default kosong, yang berarti log tidak diurai. Nilai yang valid: Kosong: tidak mengurai log. rfc3164: menggunakan protokol RFC3164 untuk mengurai log. rfc5424: menggunakan protokol RFC5424 untuk mengurai log. auto: secara otomatis memilih protokol penguraian yang sesuai berdasarkan konten log.
IgnoreParseFailure	bool	No	true	true	Operasi yang dilakukan setelah kegagalan penguraian. Jika Anda tidak mengonfigurasi parameter ini, nilai default `true` digunakan, yang berarti penguraian ditinggalkan dan field konten yang dikembalikan diisi langsung. Jika Anda mengatur parameter ini ke `false`, log dibuang jika penguraian gagal.

Plugin Input Systemd Journal

Parameter	Type	Required	Default value	Example	Description
Type	string	Yes	/	service_journal	Jenis plugin. Atur nilainya ke service_journal.
JournalPaths	[string]	Yes	None	/var/log/journal	Jalur log Journal. Kami menyarankan agar Anda mengatur parameter ini ke direktori tempat log Journal disimpan.
SeekPosition	string	No	tail	tail	Metode pengumpulan awal. Nilai yang valid: head dan tail. head: mengumpulkan semua data. tail: hanya mengumpulkan data baru setelah konfigurasi pengumpulan Logtail diterapkan.
Kernel	bool	No	true	true	Menentukan apakah akan mengumpulkan log kernel.
Units	[string]	No	None	""	Daftar unit yang akan dikumpulkan. Secara default, parameter ini dibiarkan kosong, yang berarti semua unit dikumpulkan.
ParseSyslogFacility	bool	No	false	false	Menentukan apakah akan mengurai field facility log syslog. Jika Anda tidak mengonfigurasi parameter ini, field tersebut tidak diurai.
ParsePriority	bool	No	false	false	Menentukan apakah akan mengurai field Priority. Jika Anda tidak mengonfigurasi parameter ini, field tersebut tidak diurai. Jika Anda mengatur parameter ini ke true, field Priority dipetakan sebagai berikut: `plaintext "0": "emergency" "1": "alert" "2": "critical" "3": "error" "4": "warning" "5": "notice" "6": "informational" "7": "debug"`
UseJournalEventTime	bool	No	false	false	Menentukan apakah akan menggunakan field dalam log Journal sebagai waktu log. Jika Anda tidak mengonfigurasi parameter ini, waktu pengumpulan digunakan sebagai waktu log. Selisih waktu untuk pengumpulan log waktu nyata umumnya dalam 3 detik.

Plugin Input SQL Server

Parameter	Type	Required	Default value	Example	Description
Type	string	Yes	/	service_mssql	Jenis plugin. Atur nilainya ke service_mssql.
Address	string	No	127.0.0.1:1433	rm-*.sqlserver.rds.aliyuncs.com	Alamat database SQL Server.
User	string	No	root	root	Nama pengguna yang digunakan untuk login ke database SQL Server.
Password	string	No	None		Kata sandi pengguna yang digunakan untuk login ke database SQL Server. Untuk alasan keamanan, Anda dapat mengatur nama pengguna dan kata sandi ke xxx. Setelah konfigurasi pengumpulan disinkronkan ke mesin lokal Anda, temukan konfigurasi tersebut di file `/usr/local/ilogtail/user_log_config.json` dan modifikasi. Untuk informasi selengkapnya, lihat Modify local configurations. Penting Jika Anda memodifikasi parameter ini di konsol, konfigurasi lokal akan ditimpa setelah sinkronisasi.
DataBase	string	No	/	project_database	Nama database.
DialTimeOutMs	int	No	5000	5000	Periode timeout untuk menghubungkan ke database SQL Server. Satuan: ms.
ReadTimeOutMs	int	No	5000	5000	Periode timeout untuk membaca hasil kueri SQL Server. Satuan: ms.
StateMent	string	No	/		Pernyataan SELECT. Jika Anda mengatur CheckPoint ke true, klausa WHERE dalam pernyataan SELECT harus berisi kolom checkpoint (CheckPointColumn). Anda dapat menggunakan tanda tanya (?) sebagai placeholder untuk bekerja dengan kolom checkpoint. Misalnya, Anda dapat mengatur 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 kueri diganti dengan ID yang sesuai dengan checkpoint.
Limit	bool	No	false	true	Menentukan apakah akan menggunakan LIMIT untuk paging. true: menggunakan LIMIT untuk paging. false (default): tidak menggunakan LIMIT untuk paging. Kami menyarankan agar Anda menggunakan LIMIT untuk paging. Jika Anda mengatur Limit ke true, sistem secara otomatis menambahkan klausa LIMIT ke pernyataan SELECT selama kueri SQL.
PageSize	int	No	/	10	Jumlah entri yang dikembalikan pada setiap halaman. Parameter ini wajib jika Anda mengatur Limit ke true.
MaxSyncSize	int	No	0	0	Jumlah maksimum catatan yang disinkronkan sekaligus. Nilai default adalah 0, yang berarti tidak ada batasan.
CheckPoint	bool	No	false	true	Menentukan apakah akan menggunakan checkpoint. true: menggunakan checkpoint. false (default): tidak menggunakan checkpoint. Checkpoint dapat digunakan sebagai titik awal untuk pengumpulan data berikutnya guna mengimplementasikan pengumpulan data inkremental.
CheckPointColumn	string	No	None	1	Nama kolom checkpoint. Parameter ini wajib jika Anda mengatur CheckPoint ke true. Peringatan Nilai dalam kolom ini harus bersifat inkremental. Jika tidak, data mungkin gagal dikumpulkan. Nilai maksimum dalam setiap hasil kueri digunakan sebagai input untuk kueri berikutnya.
CheckPointColumnType	string	No	None	int	Tipe data kolom checkpoint. Nilai yang valid: int dan time. Tipe int disimpan sebagai int64. Tipe time mendukung tipe date, datetime, dan time SQL Server. Parameter ini wajib jika Anda mengatur CheckPoint ke true.
CheckPointStart	string	No	None		Nilai awal kolom checkpoint. Parameter ini wajib jika Anda mengatur CheckPoint ke true.
CheckPointSavePerPage	bool	No	true	true	Menentukan apakah akan menyimpan checkpoint untuk setiap halaman. true (default): menyimpan checkpoint untuk setiap halaman. false: menyimpan checkpoint setelah setiap sinkronisasi selesai.
IntervalMs	int	No	60000	60000	Interval sinkronisasi. Nilai default adalah 60.000. Satuan: ms.

Plugin Input PostgreSQL

Parameter	Type	Required	Default value	Example	Description
Type	string	Yes	/	service_pgsql	Jenis plugin. Atur nilainya ke service_pgsql.
Address	string	No	127.0.0.1:5432	rm-*.pg.rds.aliyuncs.com	Alamat database PostgreSQL.
User	string	No	root	root	Nama pengguna yang digunakan untuk login ke database PostgreSQL.
Password	string	No	None		Kata sandi pengguna yang digunakan untuk login ke database PostgreSQL. Untuk alasan keamanan, Anda dapat mengatur nama pengguna dan kata sandi ke xxx. Setelah konfigurasi pengumpulan disinkronkan ke mesin lokal Anda, temukan konfigurasi tersebut di file `/usr/local/ilogtail/user_log_config.json` dan modifikasi. Untuk informasi selengkapnya, lihat Modify local configurations. Penting Jika Anda memodifikasi parameter ini di konsol, konfigurasi lokal akan ditimpa setelah sinkronisasi.
DataBase	string	No	/	project_database	Nama database PostgreSQL.
DialTimeOutMs	int	No	5000	5000	Timeout koneksi untuk database PostgreSQL, dalam milidetik.
ReadTimeOutMs	int	No	5000	5000	Timeout untuk membaca hasil kueri PostgreSQL. Satuan: ms.
StateMent	string	No	/		Pernyataan SELECT. Jika CheckPoint diatur ke true, klausa WHERE dalam StateMent harus menyertakan kondisi untuk kolom checkpoint. Kolom checkpoint ditentukan oleh parameter CheckPointColumn. Kondisi ini harus menggunakan $1 sebagai placeholder untuk nilai checkpoint. Misalnya: Atur CheckPointColumn ke id dan StateMent ke `SELECT * from ... where id > $1`
Limit	Boolean	No	false	true	Menentukan apakah akan menggunakan Limit untuk paging. true: Gunakan Limit. false (default): Jangan gunakan Limit. Gunakan Limit untuk paging. Jika diatur ke true, sistem secara otomatis menambahkan pernyataan LIMIT ke pernyataan SELECT selama kueri SQL.
PageSize	int	No	/	10	Ukuran halaman. Parameter ini wajib jika `Limit` diatur ke `true`.
MaxSyncSize	int	No	0	0	Jumlah maksimum catatan yang disinkronkan setiap kali. Nilai default adalah 0, yang berarti tidak ada batasan.
CheckPoint	bool	No	false	true	Menentukan apakah akan menggunakan checkpoint. true: Gunakan checkpoint. false: (Default) Jangan gunakan checkpoint. Checkpoint dapat digunakan sebagai titik awal untuk pengumpulan data berikutnya guna mengaktifkan pengumpulan data inkremental.
CheckPointColumn	string	No	Empty	1	Nama kolom CheckPoint. Parameter ini wajib saat CheckPoint diatur ke true. Peringatan Nilai kolom ini harus bersifat inkremental. Jika tidak, masalah pengumpulan data dapat terjadi karena nilai maksimum dari setiap kueri digunakan sebagai input untuk kueri berikutnya.
CheckPointColumnType	string	No	empty	int	Tipe data kolom CheckPoint. Nilai yang didukung adalah `int` dan `time`. Tipe `int` disimpan sebagai `int64`. Tipe `time` mendukung tipe waktu PostgreSQL. Parameter ini wajib saat parameter CheckPoint diatur ke `true`.
CheckPointStart	string	No	empty		Nilai awal kolom CheckPoint. Parameter ini wajib saat CheckPoint diatur ke true.
CheckPointSavePerPage	bool	No	true	true	Menentukan apakah akan menyimpan checkpoint untuk setiap halaman. true (Default): Menyimpan checkpoint untuk setiap halaman. false: Menyimpan checkpoint setelah setiap sinkronisasi selesai.
IntervalMs	int	No	60000	60000	Interval sinkronisasi. Nilai default adalah 60000 ms.

Plugin Input SNMP

Parameter	Type	Required	Default value	Example	Description
Targets	[string]	Yes	/	127.0.0.1	Alamat IP grup mesin target.
Port	string	No	161	161	Port yang digunakan oleh protokol SNMP.
Community	string	No	public	public	String komunitas. SNMPv1 dan SNMPv2 menggunakan string komunitas untuk otentikasi.
UserName	string	No	Empty	root	Nama pengguna. SNMPv3 mendukung otentikasi menggunakan nama pengguna.
AuthenticationProtocol	string	No	NoAuth	NoAuth	Protokol otentikasi. SNMPv3 mendukung otentikasi menggunakan protokol otentikasi.
AuthenticationPassphrase	string	No	Empty		Frasa sandi otentikasi. Nilai default kosong. Jika Anda mengatur `AuthenticationProtocol` ke `MD5` atau `SHA`, Anda harus mengatur `AuthenticationPassphrase`.
PrivacyProtocol	string	No	NoPriv	NoPriv	Protokol privasi. SNMPv3 mendukung otentikasi menggunakan protokol privasi.
PrivacyPassphrase	string	No	Empty		Frasa sandi protokol privasi. Secara default, frasa sandi ini sama dengan frasa sandi otentikasi. Jika Anda mengatur `PrivacyProtocol` ke `DES` atau `AES`, Anda harus mengatur `PrivacyPassphrase`.
Timeout	int	No	5	5	Periode timeout untuk operasi kueri, dalam detik.
Version	int	No	2	2	Versi protokol SNMP. Nilai yang valid adalah `1`, `2`, dan `3`.
Transport	string	No	udp	udp	Metode komunikasi SNMP. Nilai yang valid adalah `udp` dan `tcp`.
MaxRepetitions	int	No	0	0	Jumlah percobaan ulang setelah kueri timeout.
Oids	[string]	No	Empty	1	Object Identifiers (OID) yang akan dikueri pada mesin target.
Fields	[string]	No	Empty	int	Field yang akan dikueri pada mesin target. Plugin mencari field-field ini di Management Information Base (MIB) lokal, menerjemahkannya menjadi Object Identifiers (OID), lalu mengkuerinya.
Tables	[string]	No	Empty		Tabel yang akan dikueri pada mesin target. Plugin menemukan semua field dalam tabel yang ditentukan, mencarinya di Management Information Base (MIB) lokal, menerjemahkannya menjadi Object Identifiers (OID), lalu mengkuerinya.

Plugin Collector Output Skrip

Parameter	Type	Required	Default value	Example	Description
Type	string	Yes	/	input_command	Jenis plugin. Nilainya tetap input_command.
ScriptType	string	Yes	Empty	shell	Jenis konten skrip. Nilai yang valid adalah bash, shell, python2, dan python3.
User	string	Yes	/	public	Nama pengguna yang digunakan untuk menjalankan perintah. Hanya pengguna non-root yang didukung. Catatan * Pastikan nama pengguna yang ditentukan ada di mesin. Konfigurasikan hak istimewa minimal. Berikan hanya izin rwx untuk folder atau file yang akan dipantau.
ScriptContent	string	Yes	Empty		Konten skrip. Kontennya dapat berupa teks biasa atau di-encode Base64. Panjangnya tidak boleh melebihi 512 × 1024 byte.
ContentEncoding	string	No	PlainText	PlainText	Format encoding konten skrip. Parameter ini opsional. Nilai yang valid: PlainText (Default): Konten skrip berupa teks biasa dan tidak di-encode. Base64: Konten skrip di-encode Base64.
LineSplitSep	string	No	Empty		Pemisah yang digunakan untuk membagi output skrip. Jika Anda membiarkan parameter ini kosong, output tidak dibagi dan dikembalikan sebagai satu entri log.
CmdPath	string	No	Empty	/usr/bin/bash	Jalur eksekusi skrip. Jika parameter ini kosong, jalur default digunakan. Jalur default adalah sebagai berikut: bash: /usr/bin/bash shell: /usr/bin/sh python2: /usr/bin/python2 python3: /usr/bin/python3
TimeoutMilliSeconds	int	No	3000	3000	Periode timeout untuk eksekusi skrip. Satuan: milidetik.
IgnoreError	bool	No	false	false	Menentukan apakah akan mengabaikan log error jika plugin gagal dieksekusi. Nilai default adalah false, yang berarti error tidak diabaikan.
Environments	[string]	No			Variabel lingkungan. Secara default, nilai os.Environ() digunakan. Jika Anda mengatur parameter ini, variabel lingkungan yang ditentukan ditambahkan ke nilai os.Environ().
IntervalMs	int	No	5000	5000	Interval pengumpulan data atau eksekusi skrip. Satuan: milidetik.

Plugin Prosesor Native

Plugin Parsing Regex Native

Parameter	Type	Required	Default value	Example	Description
Type	string	Yes	None	processor_parse_regex_native	Jenis plugin. Nilainya tetap processor_parse_regex_native.
SourceKey	string	Yes	None	content	Nama field sumber.
Regex	string	Yes	None	(\d+-\d+-\d+)\s+(.*)	Ekspresi reguler.
Keys	[string]	Yes	None	["time", "msg"]	Daftar field yang diekstraksi.
KeepingSourceWhenParseFail	bool	No	false	false	Menentukan apakah akan menyimpan field sumber jika penguraian gagal.
KeepingSourceWhenParseSucceed	bool	No	false	false	Menentukan apakah akan menyimpan field sumber jika penguraian berhasil.
RenamedSourceKey	string	No	Empty	key	Nama baru untuk field sumber jika disimpan. Jika Anda membiarkan parameter ini kosong, field sumber tidak diganti namanya.

Plugin Parsing JSON Native

Parameter	Type	Required	Default Value	Example	Description
Type	string	Yes	/	processor_parse_json_native	Jenis plug-in. Nilainya tetap processor_parse_json_native.
SourceKey	string	Yes	/	content	Nama field sumber.
KeepingSourceWhenParseFail	bool	No	false	false	Menentukan apakah akan menyimpan field sumber jika penguraian gagal.
KeepingSourceWhenParseSucceed	bool	No	false	false	Menentukan apakah akan menyimpan field sumber jika penguraian berhasil.
RenamedSourceKey	string	No	empty	key	Nama field baru untuk field sumber saat disimpan. Jika parameter ini dibiarkan kosong, field sumber tidak diganti namanya.

Plugin Parsing Pemisah Native

Parameter	Type	Required	Default value	Example	Description
Type	string	Yes	/	processor_parse_delimiter_native	Jenis plug-in. Nilainya harus processor_parse_delimiter_native.
SourceKey	string	Yes	/	content	Nama field sumber.
Separator	string	Yes	/	,	Karakter pemisah.
Quote	string	No	"	"	Karakter kutipan.
Keys	[string]	Yes	/	["time", "msg"]	Daftar kunci untuk field yang diekstraksi.
AllowingShortenedFields	bool	No	true	true	Menentukan apakah akan mengizinkan jumlah field yang diekstraksi lebih sedikit daripada kunci. Jika diatur ke false, penguraian gagal jika jumlah field lebih kecil daripada jumlah kunci.
OverflowedFieldsTreatment	string	No	extend	extend	Perilaku saat jumlah field yang diekstraksi lebih besar daripada jumlah kunci. Nilai yang valid: extend: Menyimpan field tambahan dan menambahkan masing-masing ke log sebagai field terpisah. Field tambahan dinamai __column$i__, di mana $i adalah nomor urut field, dimulai dari 0. keep: Menyimpan field tambahan dan menambahkannya ke log sebagai satu field bernama __column0__. discard: Membuang field tambahan.
KeepingSourceWhenParseFail	bool	No	false	false	Menentukan apakah akan menyimpan field sumber jika penguraian gagal.
KeepingSourceWhenParseSucceed	bool	No	false	false	Menentukan apakah akan menyimpan field sumber jika penguraian berhasil.
RenamedSourceKey	string	No	empty	key	Nama field yang digunakan untuk menyimpan field sumber saat field sumber disimpan. Jika Anda tidak menentukan nama, field sumber tidak diganti namanya.

Plugin Parsing Apsara Native

Parameter	Type	Required	Default value	Example	Description
Type	string	Yes	/	processor_parse_apsara_native	Jenis plugin. Nilainya tetap processor_parse_apsara_native.
SourceKey	string	Yes	/	content	Nama field sumber.
Timezone	string	No	Empty	GMT+08:00	Zona waktu log. Formatnya adalah GMT+HH:MM untuk zona waktu timur atau GMT-HH:MM untuk zona waktu barat.
KeepingSourceWhenParseFail	bool	No	false	false	Menentukan apakah akan menyimpan field sumber saat penguraian gagal.
KeepingSourceWhenParseSucceed	bool	No	false	false	Menentukan apakah akan menyimpan field sumber saat penguraian berhasil.
RenamedSourceKey	string	No	Empty	key	Nama field yang menyimpan field sumber jika field sumber disimpan. Jika parameter ini kosong, field sumber tidak diganti namanya.

Plugin Parsing Waktu Native

Parameter	Type	Required	Default value	Example	Description
Type	string	Yes	/	processor_parse_timestamp_native	Jenis plugin. Nilainya harus processor_parse_timestamp_native.
SourceKey	string	Yes	/	content	Nama field sumber.
SourceFormat	string	Yes	/	%Y/%m/%d %H:%M:%S	Format waktu log. Untuk informasi selengkapnya, lihat Time formats.
SourceTimezone	string	No	Empty	GMT+08:00	Zona waktu log. Formatnya adalah GMT+HH:MM untuk zona waktu timur atau GMT-HH:MM untuk zona waktu barat.

Plugin Filtering Native

Parameter	Type	Required	Example	Default value	Description
Type	string	Yes	processor_filter_regex_native	/	Jenis plugin. Nilainya tetap processor_filter_regex_native.
Include	map	Yes	/	/	Daftar putih untuk field log. Kunci adalah nama field dan nilai adalah ekspresi reguler. Log dikumpulkan hanya jika konten field yang ditentukan cocok dengan ekspresi reguler. Jika Anda menentukan beberapa kondisi, log dikumpulkan hanya jika memenuhi semuanya.

Plugin Penyamaran Data Native

Parameter	Type	Required	Default value	Example	Description
Type	string	Yes	/	processor_desensitize_native	Jenis plugin. Nilainya tetap processor_desensitize_native.
SourceKey	string	Yes	/	content	Nama field sumber.
Method	string	Yes	/	const	Metode penyamaran data. Nilai yang valid meliputi: const: Mengganti konten sensitif dengan string konstan. md5: Mengganti konten sensitif dengan nilai MD5-nya.
ReplacingString	string	No. Parameter ini wajib saat Method diatur ke const.	/	******	String konstan yang digunakan untuk mengganti konten sensitif.
ContentPatternBeforeReplacedString	string	Yes	/	'password:'	Ekspresi reguler untuk awalan konten sensitif.
ReplacedContentPattern	string	Yes	/	[^']*	Ekspresi reguler untuk konten sensitif.
ReplacingAll	bool	No	true	true	Menentukan apakah akan mengganti semua konten sensitif yang cocok.

Plugin Prosesor Ekstensi

Ambil Field

Pola Ekspresi Reguler

Parameter	Type	Required	Default value	Example	Description
Type	string	Yes	/	processor_regex	Jenis plugin. Nilainya tetap processor_regex.
SourceKey	string	Yes	/	content	Nama field sumber.
Regex	string	Yes	/	(\d+-\d+-\d+)\s+(.*)	Ekspresi reguler. Gunakan tanda kurung `()` untuk menganotasi field yang akan diambil.
Keys	[string]	Yes	/	["ip", "time", "method"]	Menentukan nama field untuk konten yang diambil, seperti ["ip", "time", "method"].
NoKeyError	boolean	No	false	false	Menentukan apakah sistem melaporkan error jika field sumber tidak ada dalam log mentah. true: Sistem melaporkan error. false (default): Sistem tidak melaporkan error.
NoMatchError	boolean	No	false	false	Menentukan apakah sistem melaporkan error jika ekspresi reguler tidak cocok dengan nilai field sumber. true: Sistem melaporkan error. false (default): Sistem tidak melaporkan error.
KeepSource	boolean	No	false	false	Menentukan apakah akan menyimpan field sumber dalam log yang telah diurai. true: Menyimpan field sumber. false (default): Tidak menyimpan field sumber.
FullMatch	boolean	No	true	true	Menentukan apakah akan mengambil nilai field hanya saat ditemukan kecocokan penuh. true (default): Nilai field diambil hanya jika semua field yang Anda atur dalam parameter Keys cocok dengan nilai field sumber berdasarkan ekspresi reguler dalam parameter Regex. false: Nilai field diambil bahkan jika hanya ditemukan kecocokan parsial.
KeepSourceIfParseError	boolean	No	true	false	Menentukan apakah akan menyimpan field sumber dalam log jika penguraian gagal. true (default): Menyimpan field sumber. false: Tidak menyimpan field sumber.

Mode Delimiter

Parameter	Type	Required	Default Value	Example	Description
Type	string	Yes	N/A	processor_anchor	Jenis plug-in. Nilainya tetap processor_anchor.
SourceKey	string	Yes	N/A	content	Nama field sumber.
Anchors	array	Yes	N/A		Daftar item anchor.
Start	string	Yes	Empty	time	Kata kunci awal. Jika parameter ini kosong, cocok dengan awal string.
Stop	string	Yes	Empty	\t	Kata kunci akhir. Jika parameter ini kosong, cocok dengan akhir string.
FieldName	string	Yes	Empty	time	Nama field untuk konten yang diekstraksi.
FieldType	string	Yes	Empty	string	Tipe field. Nilai yang valid adalah string dan json.
ExpandJson	boolean	No	false	false	Menentukan apakah akan memperluas field JSON. true: Memperluas field. false (default): Tidak memperluas field.
ExpandConnector	string	No	_	_	Konektor yang digunakan untuk ekspansi JSON. Nilai default adalah underscore (_).
MaxExpandDepth	integer	No	0	0	Kedalaman maksimum untuk ekspansi JSON. Nilai default adalah 0, yang berarti tidak ada batasan.
NoAnchorError	boolean	No	false	false	Menentukan apakah akan melaporkan error jika item anchor tidak ditemukan. true: Laporkan error. false (default): Jangan laporkan error.
NoKeyError	boolean	No	false	false	Menentukan apakah akan melaporkan error jika field sumber yang ditentukan tidak ada dalam log mentah. true: Laporkan error. false (default): Jangan laporkan error.
KeepSource	boolean	No	false	false	Menentukan apakah akan menyimpan field sumber dalam log yang telah diurai. true: Simpan field sumber. false (default): Jangan simpan field sumber.

Pola CSV

Parameter	Type	Required	Default value	Example	Description
Type	string	Yes	None	processor_csv	Jenis plugin. Atur ini ke processor_csv.
SourceKey	String	Yes	None	csv	Nama field sumber.
SplitKeys	String array	Yes	None	["date", "ip", "content"]	Tentukan nama field untuk konten yang diekstraksi, seperti ["date", "ip", "content"]. Penting Jika jumlah field yang akan dibagi lebih sedikit daripada jumlah field yang ditentukan dalam parameter SplitKeys, field berlebih dalam SplitKeys diabaikan.
PreserveOthers	Boolean	No	false	false	Menentukan apakah akan menyimpan konten tersisa saat data sumber berisi lebih banyak field daripada yang ditentukan dalam parameter SplitKeys. true: Simpan konten tersisa. false (default): Jangan simpan konten tersisa.
ExpandOthers	Boolean	No	false	false	Menentukan apakah akan mengurai konten tersisa. true: Uraikan konten. Gunakan parameter ExpandKeyPrefix untuk menentukan awalan untuk nama field tambahan. false (default): Jangan uraikan konten. Jika PreserveOthers diatur ke true dan ExpandOthers diatur ke false, konten tersisa disimpan dalam field _decode_preserve_. Catatan Jika konten field tambahan tidak dalam format CSV standar, normalisasi sebelum penyimpanan.
ExpandKeyPrefix	String	No			Awalan untuk nama field tambahan. Misalnya, jika Anda mengatur parameter ini ke `expand_`, nama fieldnya adalah expand_1, expand_2, dan seterusnya.
TrimLeadingSpace	Boolean	No	false	false	Menentukan apakah akan mengabaikan spasi awal dalam nilai field. true: Abaikan spasi awal. false (default): Jangan abaikan spasi awal.
SplitSep	String	No	,	,	Pemisah. Nilai default adalah koma (,).
KeepSource	Boolean	No	false	false	Menentukan apakah akan menyimpan field sumber dalam log yang telah diurai. true: Simpan field sumber. false (default): Jangan simpan field sumber.
NoKeyError	Boolean	No	false	false	Menentukan apakah akan melaporkan error jika field sumber yang ditentukan tidak ada dalam log mentah. true: Laporkan error. false (default): Jangan laporkan error.

Pola Pemisah Karakter Tunggal

Parameter	Type	Required	Default value	Example	Description
Type	string	Yes	/	processor_split_char	Jenis plugin. Nilainya harus processor_split_char.
SourceKey	String	Yes			Nama field sumber.
SplitSep	String	Yes			Pemisah. Ini harus berupa satu karakter. Karakter non-printable, seperti \u0001, dapat digunakan.
SplitKeys	String array	Yes		["ip", "time", "method"]	Tentukan nama field untuk konten yang diekstraksi. Misalnya, ["ip", "time", "method"].
PreserveOthers	Boolean	No	false	false	Menentukan apakah akan menyimpan field tersisa saat jumlah field yang dibagi lebih besar daripada jumlah kunci dalam SplitKeys. true: Simpan field tersisa. false (default): Jangan simpan field tersisa.
QuoteFlag	Boolean	No	false	false	Menentukan apakah akan menggunakan karakter kutipan. true: Gunakan karakter kutipan. false (default): Jangan gunakan karakter kutipan.
Quote	String	No	/	\u0001	Karakter kutipan. Ini harus berupa satu karakter. Karakter non-printable, seperti \u0001, dapat digunakan. Parameter ini hanya berlaku saat QuoteFlag diatur ke true.
NoKeyError	Boolean	No	false	false	Menentukan apakah akan melaporkan error jika field sumber yang ditentukan tidak ada dalam log mentah. true: Laporkan error. false (default): Jangan laporkan error.
NoMatchError	Boolean	No	false	false	Menentukan apakah akan melaporkan error jika pemisah yang ditentukan tidak cocok dengan pemisah dalam log. true: Laporkan error. false (default): Jangan laporkan error.
KeepSource	Boolean	No	false	false	Menentukan apakah akan menyimpan field sumber dalam log yang telah diurai. true: Simpan field sumber. false (default): Jangan simpan field sumber.

Pola Pemisah Multi-Karakter

Parameter	Type	Required	Default value	Example	Description
Type	string	Yes	/	processor_split_string	Jenis plugin. Parameter ini tetap `processor_split_string`.
SourceKey	String	Yes			Nama field sumber.
SplitSep	String	Yes			Pemisah. Ini harus berupa satu karakter. Anda dapat mengatur parameter ini ke karakter non-printable, seperti `\u0001`.
SplitKeys	String array	Yes		["key1","key2"]	Nama field untuk konten yang diekstraksi, seperti `["key1","key2"]`. Catatan Jika jumlah field yang akan dibagi lebih sedikit daripada jumlah kunci dalam parameter `SplitKeys`, kunci tambahan diabaikan.
PreserveOthers	Boolean	No	false	false	Menentukan apakah akan menyimpan field tersisa saat jumlah field yang dibagi lebih besar daripada jumlah kunci dalam parameter `SplitKeys`. `true`: Simpan field tersisa. `false` (default): Jangan simpan field tersisa.
ExpandOthers	Boolean	No	false	false	Menentukan apakah akan memperluas field tersisa menjadi pasangan kunci-nilai terpisah. Parameter ini hanya berlaku saat `PreserveOthers` diatur ke `true`. `true`: Perluas field. `false` (default): Jangan perluas field.
ExpandKeyPrefix	String	No	/	expand_	Awalan untuk nama field tersisa. Misalnya, jika Anda mengatur parameter ini ke `expand_`, nama fieldnya adalah `expand_1`, `expand_2`, dan seterusnya.
NoKeyError	Boolean	No	false	false	Menentukan apakah akan melaporkan error jika field sumber yang ditentukan dalam `SourceKey` tidak ada dalam log mentah. `true`: Laporkan error. `false` (default): Jangan laporkan error.
NoMatchError	Boolean	No	false	false	Menentukan apakah akan melaporkan error jika konten log tidak dapat dibagi oleh pemisah yang ditentukan dalam `SplitSep`. `true`: Laporkan error. `false` (default): Jangan laporkan error.
KeepSource	Boolean	No	false	false	Menentukan apakah akan menyimpan field sumber dalam log yang telah diurai. `true`: Simpan field sumber. `false` (default): Jangan simpan field sumber.

Pola Pasangan Kunci-Nilai

Parameter	Type	Required	Default Value	Example	Description
Type	string	Yes	/	processor_split_key_value	Jenis plug-in. Atur ini ke processor_split_key_value.
SourceKey	string	Yes			Nama field sumber.
Delimiter	string	No	\t	\t	Pemisah antara pasangan kunci-nilai. Nilai default adalah karakter tab `\t`.
Separator	string	No	:	:	Pemisah antara kunci dan nilai dalam pasangan kunci-nilai. Nilai default adalah titik dua (:).
KeepSource	Boolean	No	false	false	Menentukan apakah akan menyimpan field sumber dalam log setelah penguraian. true: Menyimpan field sumber. false (default): Tidak menyimpan field sumber.
ErrIfSourceKeyNotFound	Boolean	No	true	false	Menentukan apakah akan melaporkan error jika field sumber tidak ditemukan dalam log mentah. true (default): Melaporkan error. false: Tidak melaporkan error.
DiscardWhenSeparatorNotFound	Boolean	No	false	false	Menentukan apakah akan membuang pasangan kunci-nilai jika pemisah tidak ditemukan. true: Membuang pasangan. false (default): Tidak membuang pasangan.
ErrIfSeparatorNotFound	Boolean	No	true	false	Menentukan apakah akan melaporkan error jika pemisah yang ditentukan tidak ditemukan. true (default): Melaporkan error. false: Tidak melaporkan error.
ErrIfKeyIsEmpty	Boolean	No	true	false	Menentukan apakah akan melaporkan error jika kunci kosong setelah pemisahan. true (default): Melaporkan error. false: Tidak melaporkan error.
Quote	String	No			Karakter kutipan. Jika nilai diapit oleh karakter kutipan yang ditentukan, konten di dalam tanda kutip diekstraksi sebagai nilai. Parameter ini mendukung beberapa karakter. Secara default, fitur ini dinonaktifkan. Penting * Untuk menggunakan tanda kutip ganda (") sebagai karakter kutipan, Anda harus meng-escape-nya dengan backslash (\\). Saat backslash digunakan dengan karakter kutipan di dalam nilai yang dikutip, backslash tersebut disertakan sebagai bagian dari nilai output.

Pola Grok

Parameter	Type	Required	Default value	Example	Description
Type	string	Yes	/	processor_grok	Jenis plugin. Nilainya tetap processor_grok.
CustomPatternDir	String array	No			Folder tempat file pola Grok kustom berada. Plugin processor_grok membaca semua file dalam folder tersebut. Jika Anda tidak menambahkan parameter ini, file pola Grok kustom tidak diimpor. Penting Setelah memperbarui file pola Grok kustom, restart Logtail agar perubahan diterapkan.
CustomPatterns	Map	No			Pola GROK kustom. Kunci adalah nama aturan dan nilai adalah ekspresi Grok. Untuk informasi selengkapnya tentang ekspresi default yang didukung, lihat processor_grok. Jika ekspresi yang Anda butuhkan tidak ada di tautan tersebut, masukkan ekspresi Grok kustom di Match. Jika Anda tidak menambahkan parameter ini, pola GROK kustom tidak digunakan.
SourceKey	String	No	content	content	Nama field sumber. Nilai default adalah field content.
Match	String array	Yes			Array ekspresi Grok. Plugin processor_grok mencocokkan log terhadap ekspresi dalam daftar ini dari atas ke bawah. Plugin mengembalikan hasil dari kecocokan pertama yang berhasil. Catatan Mengonfigurasi beberapa ekspresi Grok dapat memengaruhi performa. Untuk performa terbaik, gunakan tidak lebih dari lima ekspresi.
TimeoutMilliSeconds	Long	No		0	Waktu maksimum untuk mencoba mengambil field menggunakan ekspresi Grok, dalam milidetik. Jika Anda tidak menambahkan parameter ini atau mengaturnya ke 0, tidak ada timeout.
IgnoreParseFailure	Boolean	No	true	true	Menentukan apakah akan mengabaikan log yang gagal diurai. true (default): Mengabaikan log. false: Menghapus log.
KeepSource	Boolean	No	true	true	Menentukan apakah akan menyimpan field sumber setelah penguraian berhasil. true (default): Menyimpan field sumber. false: Membuang field sumber.
NoKeyError	Boolean	No	false	true	Menentukan apakah sistem melaporkan error jika field sumber yang Anda tentukan tidak ada dalam log mentah. true: Melaporkan error. false (default): Tidak melaporkan error.
NoMatchError	Boolean	No	true	true	Menentukan apakah sistem melaporkan error jika tidak ada ekspresi yang diatur dalam parameter Match yang cocok dengan log. true (default): Melaporkan error. false: Tidak melaporkan error.
TimeoutError	Boolean	No	true	true	Menentukan apakah sistem melaporkan error jika kecocokan timeout. true (default): Melaporkan error. false: Tidak melaporkan error.

Tambahkan Field

Parameter	Type	Required	Default	Example	Description
Type	string	Yes	/	processor_add_fields	Jenis plugin. Nilainya harus processor_add_fields.
Fields	Map	Yes			Nama dan nilai field yang akan ditambahkan. Tentukan field sebagai pasangan kunci-nilai. Beberapa field dapat ditambahkan.
IgnoreIfExist	Boolean	No	false	false	Menentukan apakah akan mengabaikan field baru jika field dengan nama yang sama sudah ada. true: Mengabaikan field baru. false (Default): Menimpa field yang ada dengan field baru.

Buang Field

Parameter	Type	Required	Default value	Example	Description
Type	string	Yes	/	processor_drop	Jenis plug-in. Nilainya tetap processor_drop.
DropKeys	String array	Yes			Field yang akan dibuang. Anda dapat menentukan beberapa field.

Ganti Nama Field

Parameter	Type	Required	Default value	Example	Description
Type	string	Yes	/	processor_rename	Jenis plugin. Nilainya tetap processor_rename.
NoKeyError	Boolean	No	false	false	Menentukan apakah akan melaporkan error jika field sumber tidak ditemukan dalam log. true: Laporkan error. false: Jangan laporkan error. Ini adalah nilai default.
SourceKeys	String array	Yes			Field sumber yang akan diganti namanya.
DestKeys	String array	Yes			Nama baru untuk field tersebut.

Paket Field

Parameter	Type	Required	Default value	Example	Description
Type	string	Yes	/	processor_packjson	Jenis plugin. Nilai ini tetap processor_packjson.
SourceKeys	String array	Yes			Field mentah yang akan dipaketkan.
DestKey	String	No			Field tujuan untuk data yang dipaketkan.
KeepSource	Boolean	No	true	true	Menentukan apakah akan menyimpan field mentah dalam log setelah penguraian. true (default): Menyimpan field mentah. false: Membuang field mentah.
AlarmIfIncomplete	Boolean	No	true	true	Menentukan apakah akan melaporkan error jika field mentah yang ditentukan tidak ada dalam log mentah. true (default): Melaporkan error. false: Tidak melaporkan error.

Perluas Field JSON

Parameter	Type	Required	Default value	Example	Description
Type	string	Yes	/	processor_json	Jenis plug-in. Nilai ini tetap processor_json.
SourceKey	String	Yes			Nama field sumber yang akan diurai.
NoKeyError	Boolean	No	true	true	Menentukan apakah akan melaporkan error jika field sumber yang ditentukan tidak ada dalam log mentah. true (default): Melaporkan error. false: Tidak melaporkan error.
ExpandDepth	Int	No	0	1	Kedalaman ekspansi untuk objek JSON. Nilai default adalah 0, yang berarti tidak ada batasan. Nilai 1 menunjukkan level saat ini, dan seterusnya.
ExpandConnector	String	No	_	_	Konektor yang digunakan untuk menggabungkan nama field selama ekspansi JSON. Nilai default adalah underscore (_).
Prefix	String	No			Awalan yang akan ditambahkan ke nama field yang diperluas.
KeepSource	Boolean	No	true	true	Menentukan apakah akan menyimpan field sumber dalam log setelah diurai. true (default): Menyimpan field sumber. false: Membuang field sumber.
UseSourceKeyAsPrefix	Boolean	No			Menentukan apakah akan menggunakan nama field sumber sebagai awalan untuk semua nama field yang diperluas.
KeepSourceIfParseError	Boolean	No	true	true	Menentukan apakah akan menyimpan log mentah jika penguraian gagal. true (default): Menyimpan log mentah. false: Membuang log mentah.
ExpandArray	Boolean	No	false	false	Menentukan apakah akan memperluas array. Parameter ini didukung di Logtail 1.8.0 dan versi yang lebih baru. false (default): Tidak memperluas array. true: Memperluas array. Misalnya, `{"k":["1","2"]}` diperluas menjadi `{"k[0]":"1","k[1]":"2"}`.

Filter Log

Parameter	Type	Required	Default Value	Example	Description
Type	string	Yes	/	processor_filter_regex	Jenis plugin. Nilainya tetap processor_filter_regex.
Include	JSON Object	No			Kunci adalah field log dan nilai adalah ekspresi reguler. Operator logika AND diterapkan antara pasangan kunci-nilai. Log dikumpulkan hanya jika semua field yang ditentukan cocok dengan ekspresi reguler yang sesuai.
Exclude	JSON Object	No			Kunci adalah field log dan nilai adalah ekspresi reguler. Operator logika OR diterapkan antara pasangan kunci-nilai. Log dibuang jika ada field yang ditentukan cocok dengan ekspresi reguler yang sesuai.

Ambil Waktu Log

Parameter	Type	Required	Default value	Example	Description
Type	string	Yes	/	processor_gotime	Jenis plugin. Nilainya tetap processor_gotime.
SourceKey	String	Yes			Nama field sumber.
SourceFormat	String	Yes			Format waktu sumber.
SourceLocation	Int	Yes			Zona waktu waktu sumber. Jika parameter ini dibiarkan kosong, zona waktu host atau kontainer tempat Logtail berjalan digunakan.
DestKey	String	Yes			Field tujuan untuk data yang diurai.
DestFormat	String	Yes			Format waktu yang diurai.
DestLocation	Int	No			Zona waktu waktu yang diurai. Jika parameter ini dibiarkan kosong, zona waktu lokal digunakan.
SetTime	Boolean	No	true	true	Menentukan apakah akan menggunakan waktu yang diurai sebagai waktu log. true (default): Gunakan waktu yang diurai sebagai waktu log. false: Jangan gunakan waktu yang diurai sebagai waktu log.
KeepSource	Boolean	No	true	true	Menentukan apakah akan menyimpan field sumber dalam log setelah diurai. true (default): Simpan field sumber. false: Jangan simpan field sumber.
NoKeyError	Boolean	No	true	true	Menentukan apakah akan melaporkan error jika field sumber yang ditentukan tidak ditemukan dalam log mentah. true (default): Laporkan error. false: Jangan laporkan error.
AlarmIfFail	Boolean	No	true	true	Menentukan apakah akan melaporkan error jika penguraian waktu log gagal. true (default): Laporkan error. false: Jangan laporkan error.

Transformasi Alamat IP

Parameter	Type	Required	Default value	Example	Description
Type	string	Yes	/	processor_geoip	Jenis plugin. Nilai ini tetap processor_geoip.
SourceKey	String	Yes			Nama field sumber yang berisi alamat IP yang akan ditransformasi.
DBPath	String	Yes		/user/data/GeoLite2-City_20180102/GeoLite2-City.mmdb	Jalur lengkap database GeoIP. Misalnya, /user/data/GeoLite2-City_20180102/GeoLite2-City.mmdb.
NoKeyError	Boolean	No	false	false	Menentukan apakah akan melaporkan error jika field sumber tidak ada dalam log mentah. true: Melaporkan error. false (default): Tidak melaporkan error.
NoMatchError	Boolean	No	true	true	Menentukan apakah akan melaporkan error jika alamat IP tidak valid atau tidak ditemukan dalam database. true (default): Melaporkan error. false: Tidak melaporkan error.
KeepSource	Boolean	No	true	true	Menentukan apakah akan menyimpan field sumber dalam log setelah penguraian. true (default): Menyimpan field sumber. false: Tidak menyimpan field sumber.
Language	String	No	zh-CN	zh-CN	Properti bahasa. Nilai default adalah zh-CN. Penting Pastikan database GeoIP Anda mencakup bahasa yang ditentukan.

Penyamaran Data

Parameter	Type	Required	Default value	Example	Description
Type	string	Yes	/	processor_desensitize	Jenis plugin. Nilainya tetap processor_desensitize.
SourceKey	string	Yes			Nama field log.
Method	string	Yes		const	Metode desensitisasi. Nilai yang valid: const: Mengganti konten sensitif dengan string yang ditentukan. Gunakan parameter ReplaceString untuk menentukan string tersebut. md5: Mengganti konten sensitif dengan hash MD5-nya.
Match	string	No	full	full	Metode untuk mengidentifikasi konten sensitif. Nilai yang valid: full (default): Mengganti seluruh nilai field target. regex: Menggunakan ekspresi reguler untuk mengidentifikasi konten sensitif.
ReplaceString	string	No			String yang menggantikan konten sensitif. Parameter ini wajib jika Anda mengatur Method ke const.
RegexBegin	string	No			Ekspresi reguler yang cocok dengan awalan konten sensitif. Parameter ini wajib jika Anda mengatur Match ke regex.
RegexContent	string	No			Ekspresi reguler yang cocok dengan konten sensitif. Parameter ini wajib jika Anda mengatur Match ke regex.

Pemetaan Nilai Field

Parameter	Type	Required	Default value	Example	Description
Type	string	Yes	/	processor_dict_map	Jenis plugin. Nilai ini tetap processor_dict_map.
SourceKey	String	Yes			Nama field sumber.
MapDict	Map	No			Kamus pemetaan. Gunakan parameter ini untuk mengonfigurasi kamus pemetaan kecil. File kamus CSV lokal tidak diperlukan. Penting Jika Anda mengatur parameter DictFilePath, pengaturan dalam parameter MapDict tidak berlaku.
DictFilePath	String	No			File kamus dalam format CSV. File ini menggunakan koma (,) sebagai pemisah dan tanda kutip ganda (") untuk mengapit referensi field.
DestKey	String	No			Nama field tujuan.
HandleMissing	Boolean	No	false	false	Menentukan apakah akan memproses log mentah jika field tujuan tidak ada. true: Proses log. Sistem mengisi field dengan nilai parameter Missing. false (default): Jangan proses log.
Missing	String	No	Unknown	Unknown	Nilai yang digunakan untuk field tujuan jika tidak ada dalam log mentah. Nilai default adalah Unknown. Parameter ini hanya berlaku saat HandleMissing diatur ke `true`.
MaxDictSize	Int	No	1000	1000	Ukuran maksimum kamus pemetaan. Nilai default adalah 1000, yang berarti Anda dapat menyimpan hingga 1000 aturan pemetaan. Untuk membatasi memori server yang digunakan oleh plugin, kurangi nilai ini.
Mode	String	No	overwrite	overwrite	Tindakan yang diambil jika field tujuan sudah ada dalam log mentah. overwrite (default): Menimpa field asli. fill: Tidak menimpa field asli.

Enkripsi Field

Parameter	Type	Required	Default value	Example	Description
Type	string	Yes	/	processor_encrypt	Jenis plugin. Nilainya tetap processor_encrypt.
SourceKey	String array	Yes			Nama field sumber.
EncryptionParameters	Object	Yes			Konfigurasi untuk kunci enkripsi.
Key	String	Yes			Kunci enkripsi. Nilainya harus berupa string heksadesimal 64 karakter.
IV	String	No	00000000000000000000000000000000		Vektor inisialisasi (IV) untuk enkripsi. Nilainya harus berupa string heksadesimal 32 karakter. Nilai default adalah `00000000000000000000000000000000`.
KeyFilePath	Boolean	No			Jalur ke file yang berisi parameter enkripsi. Jika parameter ini tidak diatur, sistem menggunakan jalur dari File Path dalam Pengaturan Input konfigurasi Logtail.
KeepSourceValueIfError	String	No	false	false	Menentukan apakah akan menyimpan nilai field asli jika enkripsi gagal. `true`: Menyimpan nilai asli. `false` (default): Tidak menyimpan nilai asli. Jika enkripsi gagal, nilai field diganti dengan `ENCRYPT_ERROR`.

Penggantian String

Parameter	Type	Required	Default value	Example	Description
Type	string	Yes	/	processor_string_replace	Jenis plugin. Nilainya tetap processor_string_replace.
SourceKey	String	Yes			Nama field sumber.
Method	String	Yes			Menentukan metode pencocokan. Nilai yang valid: `const`: Mengganti konten dengan string. `regex`: Mengganti konten menggunakan ekspresi reguler. `unquote`: Menghapus karakter escape.
Match	String	No			Konten yang dicocokkan. Jika `Method` diatur ke `const`, masukkan string yang akan diganti. Semua string yang cocok diganti. Jika `Method` diatur ke `regex`, masukkan ekspresi reguler untuk mencocokkan konten yang akan diganti. Semua string yang cocok diganti. Anda juga dapat menggunakan grup ekspresi reguler untuk mencocokkan grup tertentu. Jika `Method` diatur ke `unquote`, parameter ini tidak diperlukan.
ReplaceString	String	No			String yang digunakan untuk penggantian. Nilai default adalah "". Jika `Method` diatur ke `const`, masukkan string untuk mengganti konten asli. Jika `Method` diatur ke `regex`, masukkan string untuk mengganti konten asli. Penggantian berdasarkan grup ekspresi reguler didukung. Jika `Method` diatur ke `unquote`, parameter ini tidak diperlukan.
DestKey	String	No			Menentukan field baru untuk konten yang diganti. Secara default, tidak ada field baru yang ditambahkan.

Enkoding dan Dekoding Data

Parameter	Type	Required	Default value	Example	Description
Type	string	Yes	/	processor_base64_encoding	Jenis plugin. Parameter ini tetap processor_base64_encoding.
SourceKey	String	Yes			Nama field sumber.
NewKey	String	Yes			Nama field yang menyimpan hasil encoding.
NoKeyError	Boolean	No	false	false	Menentukan apakah akan melaporkan error jika field sumber tidak ada dalam log mentah. true: Melaporkan error. false (default): Tidak melaporkan error.

Log ke Metrik

Parameter	Type	Required	Default value	Example	Description
Type	string	Yes	/	processor_log_to_sls_metric	Jenis plugin. Nilainya tetap processor_log_to_sls_metric.
MetricTimeKey	String	No			Menentukan field waktu dalam log. Field ini dipetakan ke field `__time_nano__` dalam data deret waktu. Secara default, nilai field `__time__` digunakan. Pastikan field yang ditentukan adalah stempel waktu UNIX yang valid. Satuan yang didukung meliputi detik (10 digit), milidetik (13 digit), mikrodetik (16 digit), dan nanodetik (19 digit).
MetricLabelKeys	[]String	Yes			Menentukan daftar kunci untuk field `__labels__`. Kunci harus mengikuti ekspresi reguler `^[a-zA-Z_][a-zA-Z0-9_]*$`. Nilainya tidak boleh berisi tanda pipa vertikal (\|) atau `#$#`. Untuk informasi selengkapnya, lihat Time series data (Metric). Jangan tambahkan field `__labels__` ke parameter MetricLabelKeys. Jika log asli berisi field `__labels__`, nilainya ditambahkan ke field `__labels__` yang baru.
MetricValues	Map	Yes			Menentukan nama metrik dan nilai metrik. Nama metrik sesuai dengan field `__name__` dan harus mengikuti ekspresi reguler `^[a-zA-Z_:][a-zA-Z0-9_:]*$`. Nilai metrik sesuai dengan field `__value__` dan harus bertipe Double. Untuk informasi selengkapnya, lihat Time series data (Metric).
CustomMetricLabels	Map	No			Field `__labels__` kustom. Kunci harus mengikuti ekspresi reguler `^[a-zA-Z_][a-zA-Z0-9_]*$`. Nilainya tidak boleh berisi tanda pipa vertikal (\|) atau `#$#`. Untuk informasi selengkapnya, lihat Time series data (Metric).
IgnoreError	Boolean	No			Menentukan apakah akan mengeluarkan log error jika tidak ada log yang cocok. Nilai default adalah false, yang berarti tidak ada log error yang dikeluarkan.

Log ke Jejak

Parameter	Type	Required	Default Value	Example	Description
Type	string	Yes	/	processor_otel_trace	Jenis plug-in. Parameter ini tetap processor_otel_trace.
SourceKey	String	Yes			Nama field sumber.
Format	String	Yes		json	Format setelah transformasi. Nilai yang valid: protobuf, json, dan protojson.
NoKeyError	Boolean	No	false	true	Menentukan apakah akan melaporkan error jika field sumber tidak ada dalam log. Nilai default adalah false.
TraceIDNeedDecode	Boolean	No			Menentukan apakah akan mendekode TraceID dari Base64. Nilai default adalah false. Jika Anda mengatur Format ke protojson dan TraceID di-encode Base64, atur TraceIDNeedDecode ke true. Jika tidak, transformasi gagal.
SpanIDNeedDecode	Boolean	No			Menentukan apakah akan mendekode SpanID dari Base64. Nilai default adalah false. Jika Anda mengatur Format ke protojson dan SpanID di-encode Base64, atur SpanIDNeedDecode ke true. Jika tidak, transformasi gagal.
ParentSpanIDNeedDecode	Boolean	No			Menentukan apakah akan mendekode ParentSpanID dari Base64. Nilai default adalah false. Jika Anda mengatur Format ke protojson dan ParentSpanID di-encode Base64, atur ParentSpanIDNeedDecode ke true. Jika tidak, transformasi gagal.

Plugin Output

Plugin Output SLS

Parameter	Type	Required	Default Value	Example	Description
Type	string	Yes	/	flusher_sls	Jenis plugin. Nilai ini tetap flusher_sls.
Logstore	string	Yes	/	test-logstore	Nama 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.