Simple Log Service:CreateLogtailPipelineConfig

Konfigurasi global

Parameter	Tipe	Wajib	Nilai default	Contoh	Deskripsi
TopicType	string	Tidak	None	filepath	Tipe topik. Nilai yang valid:* filepath: mengekstrak informasi dari jalur file log sebagai topik. Nilai ini hanya valid ketika plugin input adalah input_file. * machine_group_topic: menggunakan topik grup mesin tempat konfigurasi diterapkan. * custom: topik kustom. Untuk informasi selengkapnya, lihat Topik log.
TopicFormat	string	Tidak. Parameter ini wajib jika Anda menetapkan TopicType ke filepath atau custom.	/	/var/log/(.*).log	Format topik.
EnableTimestampNanosecond	bool	Tidak	false	false	Menentukan apakah akan mengaktifkan presisi nanodetik untuk stempel waktu.
PipelineMetaTagKey	object	Tidak	None	{"HOST_NAME":"hostname"}	Penting Parameter ini hanya didukung oleh LoongCollector 3.0.10 dan yang lebih baru. Mengontrol tag yang terkait dengan informasi LoongCollector. Kuncinya adalah nama parameter tag, dan nilainya adalah nama field dari tag dalam log. Jika Anda menetapkan nilai ke default, nilai default digunakan. Jika Anda menetapkan nilai ke string kosong, tag dihapus. Tag berikut dapat dikonfigurasi:* HOST_NAME: nama host. Tag ini ditambahkan secara default. Nilai defaultnya adalah "__hostname__". * AGENT_TAG: pengidentifikasi kustom. Tag ini ditambahkan secara default. Nilai defaultnya adalah "__user_defined_id__". * HOST_ID: ID host. Tag ini tidak ditambahkan secara default. Nilai defaultnya adalah "__host_id__". * CLOUD_PROVIDER: Tag ini tidak ditambahkan secara default. Nilai defaultnya adalah "__cloud_provider__".

Plugin input

Plugin input file

Parameter	Tipe	Wajib	Nilai default	Contoh	Deskripsi
Type	string	Ya	/	input_file	Tipe plugin. Tetapkan nilainya ke input_file.
FilePaths	[string]	Ya	/	["/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. Karakter wildcard tanda bintang ganda () hanya dapat muncul sekali dan hanya dapat digunakan sebelum nama file.
MaxDirSearchDepth	uint	Tidak	0	0	Kedalaman maksimum direktori yang cocok dengan karakter wildcard tanda bintang ganda () dalam jalur file. Parameter ini hanya valid ketika jalur file berisi karakter wildcard tanda bintang ganda (). Nilai yang valid: 0 hingga 1000.
ExcludeFilePaths	[string]	Tidak	None	["/home/admin/*.log"]	Daftar hitam jalur file. Jalur harus berupa jalur absolut. Karakter wildcard (*) didukung.
ExcludeFiles	[string]	Tidak	None	["app*.log", "password"]	Daftar hitam nama file. Karakter wildcard (*) didukung.
ExcludeDirs	[string]	Tidak	None	["/home/admin/dir1", "/home/admin/dir2*"]	Daftar hitam direktori. Jalur harus berupa jalur absolut. Karakter wildcard (*) didukung.
FileEncoding	string	Tidak	utf8	utf8	Format encoding file. Nilai yang valid: utf8 dan gbk.
TailSizeKB	uint	Tidak	1024	1024	Ukuran data yang akan dikumpulkan dari akhir file ketika 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	Tidak	None	/	Opsi agregasi log multiline.
Multiline.Mode	string	Tidak	custom	custom	Mode agregasi log multiline. Nilai yang valid: custom dan JSON.
Multiline.StartPattern	string	Wajib jika Multiline.Mode ditetapkan ke custom	None	\d+-\d+-\d+.*	Ekspresi reguler untuk mencocokkan baris pertama dari log multiline.
EnableContainerDiscovery	bool	Tidak	false	true	Menentukan apakah akan mengaktifkan penemuan kontainer. Parameter ini hanya valid ketika Logtail berjalan dalam mode DaemonSet dan jalur pengumpulan adalah jalur di dalam kontainer.
ContainerFilters	object	Tidak	None	/	Opsi penyaringan kontainer. Beberapa opsi digabungkan menggunakan operator AND. Parameter ini hanya valid jika Anda menetapkan EnableContainerDiscovery ke true.
ContainerFilters.K8sNamespaceRegex	string	Tidak	None	default	Untuk kontainer di lingkungan Kubernetes, menentukan namespace dari pod tempat kontainer yang akan dikumpulkan berada. Jika Anda tidak menentukan parameter ini, semua kontainer dikumpulkan. Ekspresi reguler didukung.
ContainerFilters.K8sPodRegex	string	Tidak	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	Tidak	None	/	Untuk kontainer di lingkungan Kubernetes, menentukan label dari 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 nilainya 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 dicocokkan.
ContainerFilters.ExcludeK8sLabel	map	Tidak	None	/	Untuk kontainer di lingkungan Kubernetes, menentukan label dari 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 nilainya 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 dicocokkan.
ContainerFilters.K8sContainerRegex	string	Tidak	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	Tidak	None	/	Variabel lingkungan dari 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 nilainya 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 dicocokkan.
ContainerFilters.ExcludeEnv	map	Tidak	None	/	Variabel lingkungan dari 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 nilainya 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 dicocokkan.
ContainerFilters.IncludeContainerLabel	map	Tidak	None	/	Label dari kontainer yang akan dikumpulkan. Beberapa kondisi digabungkan menggunakan operator OR. Jika Anda tidak menentukan parameter ini, nilai default kosong, yang menunjukkan bahwa semua kontainer dikumpulkan. Ekspresi reguler didukung. Kunci dalam map adalah nama label kontainer, dan nilainya 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 dicocokkan.
ContainerFilters.ExcludeContainerLabel	map	Tidak	None	/	Label dari kontainer yang akan dikecualikan. Beberapa kondisi digabungkan menggunakan operator OR. Jika Anda tidak menentukan parameter ini, nilai default kosong, yang menunjukkan bahwa semua kontainer dikumpulkan. Ekspresi reguler didukung. Kunci dalam map adalah nama label kontainer, dan nilainya 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 dicocokkan.
ExternalK8sLabelTag	map	Tidak	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 nilainya adalah nama tag yang sesuai. Misalnya, jika Anda menambahkan app: k8s_label_app ke map dan sebuah pod berisi label app=serviceA, informasi 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	Tidak	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 nilainya 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 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	Tidak	false	true	Menentukan apakah akan mengaktifkan pratinjau metadata kontainer.
AppendingLogPositionMeta	bool	Tidak	false	false	Menentukan apakah akan menambahkan metadata file tempat log berada. Metadata mencakup field tag:inode dan field file_offset.
AllowingIncludedByMultiConfigs	bool	Tidak	false	false	Menentukan apakah akan mengizinkan konfigurasi saat ini mengumpulkan file yang dicocokkan oleh konfigurasi lain.
Tags	object	Tidak	None	{"FileInodeTagKey":"inode"}	Penting Parameter ini hanya didukung oleh LoongCollector 3.0.10 dan yang lebih baru. Mengontrol tag yang terkait dengan pengumpulan file. Kuncinya adalah nama parameter tag, dan nilainya adalah nama field dari tag dalam log. Jika Anda menetapkan nilai ke default, nilai default digunakan. Jika Anda menetapkan nilai ke string kosong, tag dihapus. Tag berikut dapat dikonfigurasi:* FileInodeTagKey: inode dari file. Tag ini tidak ditambahkan secara default. Nilai defaultnya adalah "__inode__". * FilePathTagKey: jalur file. Tag ini ditambahkan secara default. Nilai defaultnya adalah "__path__".Parameter berikut hanya valid jika Anda menetapkan parameter EnableContainerDiscovery ke true.* K8sNamespaceTagKey: namespace dari kontainer tempat file berada. Tag ini ditambahkan secara default. Nilai defaultnya adalah "_namespace_". * K8sPodNameTagKey: nama pod tempat file berada. Tag ini ditambahkan secara default. Nilai defaultnya adalah "_pod_name_". * K8sPodUidTagKey: UID dari pod tempat file berada. Tag ini ditambahkan secara default. Nilai defaultnya adalah "_pod_uid_". * ContainerNameTagKey: nama kontainer tempat file berada. Tag ini ditambahkan secara default. Nilai defaultnya adalah "_container_name_". * ContainerIpTagKey: alamat IP dari kontainer tempat file berada. Tag ini ditambahkan secara default. Nilai defaultnya adalah "_container_ip_". * ContainerImageNameTagKey: image dari kontainer tempat file berada. Tag ini ditambahkan secara default. Nilai defaultnya adalah "_image_name_".
FileOffsetKey	string	Tidak	None	_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 defaultnya adalah file_offset. Jika Anda menetapkan nilai ke default, nilai default digunakan. Jika Anda menetapkan nilai ke string kosong, tag dihapus. Jika parameter AppendingLogPositionMeta dan parameter Tags.FileInodeTagKey atau FileOffsetKey ditentukan pada saat yang sama, parameter AppendingLogPositionMeta diabaikan.

Stdout kontainer (legacy)

Parameter	Tipe	Wajib	Nilai default	Contoh	Deskripsi
Type	string	Ya	/	service_docker_stdout	Tipe plugin. Tetapkan nilainya ke service_docker_stdout.
Stdout	Boolean	Tidak	true	true	Menentukan apakah akan mengumpulkan stdout.
Stderr	Boolean	Tidak	true	true	Menentukan apakah akan mengumpulkan stderr.
StartLogMaxOffset	Integer	Tidak	128×1024	131072	Panjang data historis yang akan dikumpulkan untuk pertama kalinya. Satuan: byte. Kami merekomendasikan agar Anda menetapkan parameter ini ke nilai antara 131072 dan 1048576.
IncludeLabel	Map, di mana LabelKey dan LabelValue bertipe String	Tidak	None		Daftar putih label kontainer. Parameter ini menentukan kontainer dari mana Anda ingin mengumpulkan log. Secara default, parameter ini dibiarkan kosong, yang menunjukkan bahwa output standar dari 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. Kecocokan ditemukan hanya jika LabelValue identik dengan nilai label kontainer. Jika nilai dimulai dengan ^ dan diakhiri dengan $, nilai digunakan untuk pencocokan ekspresi reguler. Misalnya, jika Anda menetapkan LabelKey ke io.kubernetes.container.name dan LabelValue ke `^(nginx
ExcludeLabel	Map, di mana LabelKey dan LabelValue bertipe String	Tidak	None		Daftar hitam label kontainer. Parameter ini menentukan kontainer yang ingin Anda kecualikan. Secara default, parameter ini dibiarkan kosong, yang menunjukkan bahwa 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. Kecocokan ditemukan hanya jika LabelValue identik dengan nilai label kontainer. Jika nilai dimulai dengan ^ dan diakhiri dengan $, nilai digunakan untuk pencocokan ekspresi reguler. Misalnya, jika Anda menetapkan LabelKey ke io.kubernetes.container.name dan LabelValue ke `^(nginx
IncludeEnv	Map, di mana EnvKey dan EnvValue bertipe String	Tidak	None		Daftar putih variabel lingkungan. Parameter ini menentukan kontainer dari mana Anda ingin mengumpulkan log. Secara default, parameter ini dibiarkan kosong, yang menunjukkan bahwa output standar dari 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. Kecocokan ditemukan hanya jika EnvValue identik dengan nilai variabel lingkungan. Jika nilai dimulai dengan ^ dan diakhiri dengan $, nilai digunakan untuk pencocokan ekspresi reguler. Misalnya, jika Anda menetapkan EnvKey ke NGINX_SERVICE_PORT dan EnvValue ke `^(80
ExcludeEnv	Map, di mana EnvKey dan EnvValue bertipe String	Tidak	None		Daftar hitam variabel lingkungan. Parameter ini menentukan kontainer yang ingin Anda kecualikan. Secara default, parameter ini dibiarkan kosong, yang menunjukkan bahwa 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. Kecocokan ditemukan hanya jika EnvValue identik dengan nilai variabel lingkungan. Jika nilai dimulai dengan ^ dan diakhiri dengan $, nilai digunakan untuk pencocokan ekspresi reguler. Misalnya, jika Anda menetapkan EnvKey ke NGINX_SERVICE_PORT dan EnvValue ke `^(80
IncludeK8sLabel	Map, di mana LabelKey dan LabelValue bertipe String	Tidak	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 Kubernetesnya berisi LabelKey dicocokkan. - Jika LabelValue tidak kosong, hanya kontainer yang label Kubernetesnya berisi LabelKey=LabelValue yang dicocokkan. Secara default, LabelValue digunakan untuk pencocokan string. Kecocokan ditemukan hanya jika LabelValue identik dengan nilai label Kubernetes. Jika nilai dimulai dengan ^ dan diakhiri dengan $, nilai digunakan untuk pencocokan ekspresi reguler. Misalnya, jika Anda menetapkan LabelKey ke app dan LabelValue ke `^(test1
ExcludeK8sLabel	Map, di mana LabelKey dan LabelValue bertipe String	Tidak	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 Kubernetesnya berisi LabelKey dikecualikan. - Jika LabelValue tidak kosong, hanya kontainer yang label Kubernetesnya berisi LabelKey=LabelValue yang dikecualikan. Secara default, LabelValue digunakan untuk pencocokan string. Kecocokan ditemukan hanya jika LabelValue identik dengan nilai label Kubernetes. Jika nilai dimulai dengan ^ dan diakhiri dengan $, nilai digunakan untuk pencocokan ekspresi reguler. Misalnya, jika Anda menetapkan LabelKey ke app dan LabelValue ke `^(test1
K8sNamespaceRegex	String	Tidak	None	^(default	nginx)$
K8sPodRegex	String	Tidak	None	^(nginx-log-demo.*)$	Nama pod yang menjadi dasar Anda mengumpulkan log dari kontainer. Ekspresi reguler didukung. Misalnya, jika Anda menetapkan parameter ini ke ^(nginx-log-demo.*)$, semua kontainer di pod yang namanya dimulai dengan nginx-log-demo dicocokkan.
K8sContainerRegex	String	Tidak	None	^(container-test)$	Nama kontainer yang menjadi dasar Anda mengumpulkan log. Nama kontainer Kubernetes didefinisikan dalam spec.containers. Ekspresi reguler didukung. Misalnya, jika Anda menetapkan parameter ini ke ^(container-test)$, semua kontainer bernama container-test dicocokkan.

Parameter pemrosesan data

Parameter	Tipe	Wajib	Nilai default	Contoh	Deskripsi
BeginLineRegex	String	Tidak	None		Ekspresi reguler untuk mencocokkan baris pertama dari sebuah log. Jika Anda membiarkan parameter ini kosong, mode baris tunggal digunakan. Jika awal baris cocok dengan ekspresi reguler, baris tersebut dianggap sebagai baris pertama dari log baru. Jika tidak, baris tersebut ditambahkan ke log sebelumnya.
BeginLineCheckLength	Integer	Tidak	None		Panjang maksimum untuk pencocokan baris pertama. Satuan: byte. Nilai defaultnya adalah 10 × 1024 byte. Jika ekspresi reguler untuk pencocokan baris pertama dapat dicocokkan dalam N byte pertama, kami merekomendasikan agar Anda menetapkan parameter ini untuk meningkatkan efisiensi pencocokan.
BeginLineTimeoutMs	Integer	Tidak	None		Periode waktu habis untuk pencocokan baris pertama. Satuan: milidetik. Nilai defaultnya 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	Tidak	None		Panjang maksimum sebuah log. Nilai defaultnya adalah 0. Satuan: byte. Nilai defaultnya adalah 512 × 1024 byte. Jika panjang log melebihi nilai yang ditentukan, sistem berhenti mencari baris pertama dan langsung mengunggah log.
ExternalK8sLabelTag	Map, di mana LabelKey dan LabelValue bertipe String	Tidak	None		Tag label Kubernetes (didefinisikan dalam template.metadata). Setelah Anda mengonfigurasi parameter ini, iLogtail menambahkan field terkait label Kubernetes ke log. Misalnya, jika Anda menetapkan 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, di mana EnvKey dan EnvValue bertipe String	Tidak	None		Tag variabel lingkungan kontainer. Setelah Anda mengonfigurasi parameter ini, iLogtail menambahkan field terkait variabel lingkungan kontainer ke log. Misalnya, jika Anda menetapkan 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

Variabel lingkungan	Tipe	Wajib	Nilai default	Contoh	Deskripsi
ALIYUN_LOG_ENV_TAGS	String	Tidak	None		Tag variabel lingkungan global. Setelah Anda mengonfigurasi parameter ini, iLogtail menambahkan field yang terkait dengan variabel lingkungan kontainer tempat iLogtail berada ke log. Pisahkan beberapa nama variabel lingkungan dengan garis vertikal (`

Stdout kontainer (versi baru)

Parameter	Tipe	Wajib	Nilai default	Contoh	Deskripsi
Type	string	Ya	/	input_container_stdio	Tipe plugin. Tetapkan nilainya ke input_container_stdio.
IgnoringStdout	Boolean	Tidak	false	false	Menentukan apakah akan mengabaikan stdout. false menunjukkan bahwa stdout dikumpulkan. true menunjukkan bahwa stdout tidak dikumpulkan.
IgnoringStderr	Boolean	Tidak	false	false	Menentukan apakah akan mengabaikan stderr. false menunjukkan bahwa stderr dikumpulkan. true menunjukkan bahwa stderr tidak dikumpulkan.
TailSizeKB	Integer (uint)	Tidak	1024	2048	Ukuran data yang akan dikumpulkan dari akhir file ketika 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	Tidak	false	true	Menentukan apakah akan mengizinkan konfigurasi saat ini mengumpulkan log stdout dari kontainer yang dicocokkan oleh konfigurasi lain. Nilai default false mencegah pengumpulan duplikat oleh beberapa konfigurasi.
ContainerFilters	Object	Tidak	None	Lihat tabel Opsi penyaringan kontainer (ContainerFilters) di bawah	Opsi penyaringan kontainer. Beberapa opsi digabungkan menggunakan operator AND.
ExternalK8sLabelTag	Map, di mana LabelKey/LabelValue adalah String	Tidak	None	{"app":"k8s_label_app"}	Untuk skenario Kubernetes: mengambil nilai dari label pod dan menambahkannya ke log sebagai tag. Kunci dari map adalah nama label pod, dan nilainya adalah nama field log (nama tag). Jika sebuah pod tidak memiliki label yang ditentukan, field kosong ditambahkan.
ExternalEnvTag	Map, di mana EnvKey/EnvValue adalah String	Tidak	None	{"VERSION":"env_version"}	Untuk skenario kontainer: mengambil nilai dari variabel lingkungan kontainer dan menambahkannya ke log sebagai tag. Kunci dari map adalah nama variabel lingkungan, dan nilainya adalah nama field log (nama tag). Jika sebuah kontainer tidak memiliki variabel lingkungan yang ditentukan, field kosong ditambahkan.
Multiline	Object	Tidak	None	Lihat tabel Opsi agregasi multiline (Multiline) di bawah	Opsi agregasi multiline.

Opsi penyaringan kontainer (ContainerFilters)

Parameter	Tipe	Wajib	Nilai default	Contoh	Deskripsi
IncludeK8sLabel	Map, di mana LabelKey/LabelValue adalah String	Tidak	None	{"app":"^(test1	test2)$"}
ExcludeK8sLabel	Map, di mana LabelKey/LabelValue adalah String	Tidak	None	{"env":"^(test.*)$"}	Daftar hitam label Kubernetes (didefinisikan dalam metadata.labels dari sebuah pod). Parameter ini menentukan kontainer yang ingin Anda kecualikan. Secara default, parameter ini dibiarkan kosong, yang menunjukkan bahwa tidak ada kontainer yang dikecualikan. - Jika LabelValue kosong, kontainer yang label Kubernetesnya berisi LabelKey dikecualikan. - Jika LabelValue tidak kosong, hanya kontainer yang label Kubernetesnya berisi LabelKey=LabelValue yang dikecualikan. Secara default, LabelValue digunakan untuk pencocokan string. Kecocokan ditemukan hanya jika LabelValue identik dengan nilai label Kubernetes. Jika nilai dimulai dengan ^ dan diakhiri dengan $, nilai digunakan untuk pencocokan ekspresi reguler. Beberapa daftar hitam digabungkan menggunakan operator OR. Sebuah kontainer dikecualikan jika label Kubernetesnya memenuhi kondisi dalam salah satu daftar hitam.
IncludeEnv	Map, di mana EnvKey/EnvValue adalah String	Tidak	None	{"NGINX_SERVICE_PORT":"^(80	6379)$"}
ExcludeEnv	Map, di mana EnvKey/EnvValue adalah String	Tidak	None	{"POD_NAMESPACE":"kube-system"}	Daftar hitam variabel lingkungan. Parameter ini menentukan kontainer yang ingin Anda kecualikan. Secara default, parameter ini dibiarkan kosong, yang menunjukkan bahwa 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. Kecocokan ditemukan hanya jika EnvValue identik dengan nilai variabel lingkungan. Jika nilai dimulai dengan ^ dan diakhiri dengan $, nilai digunakan untuk pencocokan ekspresi reguler. Beberapa daftar hitam digabungkan menggunakan operator OR. Sebuah kontainer dikecualikan jika variabel lingkungannya memenuhi kondisi dalam salah satu pasangan kunci-nilai.
IncludeContainerLabel	Map, di mana LabelKey/LabelValue adalah String	Tidak	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 menunjukkan bahwa output standar dari 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. Kecocokan ditemukan hanya jika LabelValue identik dengan nilai label kontainer. Jika nilai dimulai dengan ^ dan diakhiri dengan $, nilai digunakan untuk pencocokan ekspresi reguler. Beberapa daftar putih digabungkan menggunakan operator OR. Sebuah kontainer dicocokkan jika labelnya memenuhi kondisi dalam salah satu daftar putih.
ExcludeContainerLabel	Map, di mana LabelKey/LabelValue adalah String	Tidak	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 menunjukkan bahwa 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. Kecocokan ditemukan hanya jika LabelValue identik dengan nilai label kontainer. Jika nilai dimulai dengan ^ dan diakhiri dengan $, nilai digunakan untuk pencocokan ekspresi reguler. Beberapa daftar hitam digabungkan menggunakan operator OR. Sebuah kontainer dikecualikan jika labelnya memenuhi kondisi dalam salah satu daftar hitam.

Opsi agregasi multiline (Multiline)

Parameter	Tipe	Wajib	Nilai default	Contoh	Deskripsi
Mode	String	Tidak	custom	custom	Mode agregasi multiline. Nilai yang valid: custom dan JSON. Jika Anda menetapkan parameter ini ke JSON, log dibaca dan digabungkan dalam format JSON.
StartPattern	String	Tidak (wajib dalam mode custom)	None	\d+-\d+-\d+.*	Ekspresi reguler untuk baris pertama dari sebuah log. Kecocokan menunjukkan awal log baru.
UnmatchedContentTreatment	String	Tidak	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 baris tunggal).

Plugin input MySQL

Parameter	Tipe	Wajib	Nilai default	Contoh	Deskripsi
Type	string	Ya	/	service_mysql	Tipe plugin. Tetapkan nilainya ke service_mysql.
Address	string	Tidak	127.0.0.1:3306	rm-*.mysql.rds.aliyuncs.com	Alamat database MySQL.
User	string	Tidak	root	root	Nama pengguna yang digunakan untuk login ke database MySQL.
Password	string	Tidak	None		Kata sandi dari pengguna yang digunakan untuk login ke database MySQL. Untuk tujuan keamanan, Anda dapat menetapkan nama pengguna dan kata sandi ke xxx. Setelah konfigurasi pengumpulan disinkronkan ke mesin on-premises Anda, temukan konfigurasi dalam file /usr/local/ilogtail/user_log_config.json dan ubah. Untuk informasi selengkapnya, lihat Ubah konfigurasi lokal. Penting Jika Anda mengubah parameter ini di konsol, konfigurasi lokal akan ditimpa setelah sinkronisasi.
DataBase	string	Tidak	/	project_database	Nama database.
DialTimeOutMs	int	Tidak	5000	5000	Periode waktu habis untuk koneksi ke database MySQL. Satuan: md.
ReadTimeOutMs	int	Tidak	5000	5000	Periode waktu habis untuk membaca hasil query MySQL. Satuan: md.
StateMent	string	Tidak	/		Pernyataan SELECT. Jika Anda menetapkan 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 menetapkan 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 diganti dengan ID yang sesuai dengan checkpoint.
Limit	bool	Tidak	false	true	Menentukan apakah akan menggunakan LIMIT untuk paging.* true: menggunakan LIMIT untuk paging. * false (default): tidak menggunakan LIMIT untuk paging.Kami merekomendasikan agar Anda menggunakan LIMIT untuk paging. Jika Anda menetapkan Limit ke true, sistem secara otomatis menambahkan klausa LIMIT ke pernyataan SELECT selama query SQL.
PageSize	int	Tidak	/	10	Jumlah entri yang akan dikembalikan pada setiap halaman. Parameter ini wajib jika Anda menetapkan Limit ke true.
MaxSyncSize	int	Tidak	0	0	Jumlah maksimum catatan yang akan disinkronkan dalam satu waktu. Nilai defaultnya adalah 0, yang menunjukkan bahwa tidak ada batasan yang diberlakukan.
CheckPoint	bool	Tidak	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	Tidak	None	1	Nama kolom checkpoint. Parameter ini wajib jika Anda menetapkan CheckPoint ke true. Peringatan Nilai dalam kolom ini harus inkremental. Jika tidak, data mungkin gagal dikumpulkan. Nilai maksimum dalam setiap hasil query digunakan sebagai input untuk query berikutnya.
CheckPointColumnType	string	Tidak	None	int	Tipe data dari kolom checkpoint. Nilai yang valid: int dan time. Tipe int disimpan sebagai int64. Tipe time mendukung tipe date, datetime, dan time dari MySQL. Parameter ini wajib jika Anda menetapkan CheckPoint ke true.
CheckPointStart	string	Tidak	None		Nilai awal dari kolom checkpoint. Parameter ini wajib jika Anda menetapkan CheckPoint ke true.
CheckPointSavePerPage	bool	Tidak	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	Tidak	60000	60000	Interval sinkronisasi. Nilai defaultnya adalah 60.000. Satuan: md.

Plugin input HTTP

Parameter	Tipe	Wajib	Nilai default	Contoh	Deskripsi
Type	string	Ya	/	metric_http	Tipe plugin. Tetapkan nilainya ke metric_http.
Address	string	Ya	/		Daftar URL. Penting URL harus dimulai dengan http atau https.
IntervalMs	int	Ya	/	10	Interval antara permintaan. Satuan: md.
Method	string	Tidak	GET	GET	Metode permintaan. Nilai harus dalam huruf besar.
Body	string	Tidak	None		Konten dari body HTTP.
Headers	map	Tidak	None	{"key":"value"}	Konten dari header HTTP. Misalnya, {"key":"value"}. Ganti konten dengan nilai aktual.
PerAddressSleepMs	int	Tidak	100	100	Interval antara permintaan untuk setiap URL dalam daftar Addresses. Satuan: md.
ResponseTimeoutMs	int	Tidak	5000	5000	Periode waktu habis permintaan. Satuan: md.
IncludeBody	bool	Tidak	false	true	Menentukan apakah akan mengumpulkan body permintaan. Nilai defaultnya adalah false. Jika Anda menetapkan parameter ini ke true, konten body permintaan disimpan dalam kunci bernama content.
FollowRedirects	bool	Tidak	false	false	Menentukan apakah akan menangani pengalihan secara otomatis.
InsecureSkipVerify	bool	Tidak	false	false	Menentukan apakah akan melewati pemeriksaan keamanan HTTPS.
ResponseStringMatch	string	Tidak	/		Melakukan pemeriksaan ekspresi reguler pada konten body yang dikembalikan. Hasil pemeriksaan disimpan dalam kunci bernama response_match. Jika kecocokan ditemukan, nilainya adalah yes. Jika tidak ada kecocokan yang ditemukan, nilainya adalah no.

Plugin input Syslog

Parameter	Tipe	Wajib	Nilai default	Contoh	Deskripsi
Type	string	Ya	/	service_syslog	Tipe plugin. Tetapkan nilainya ke service_syslog.
Address	string	Tidak	tcp://127.0.0.1:9999		Protokol, alamat, dan port yang didengarkan Logtail. Logtail mendengarkan pada protokol, alamat, dan port yang ditentukan dan memperoleh 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 penerusan yang ditentukan dalam file konfigurasi rsyslog. * Jika server tempat Logtail diinstal memiliki beberapa alamat IP yang dapat menerima log, Anda dapat menetapkan alamat ke 0.0.0.0. Ini menunjukkan bahwa Logtail mendengarkan pada semua alamat IP server.
ParseProtocol	string	Tidak	None	rfc3164	Protokol yang digunakan untuk mengurai log. Nilai defaultnya kosong, yang menunjukkan bahwa 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 parsing yang sesuai berdasarkan konten log.
IgnoreParseFailure	bool	Tidak	true	true	Operasi yang harus dilakukan setelah parsing gagal. Jika Anda tidak mengonfigurasi parameter ini, nilai default true digunakan, yang menunjukkan bahwa parsing dibatalkan dan field konten yang dikembalikan langsung diisi. Jika Anda menetapkan parameter ini ke false, log dibuang jika parsing gagal.

Plugin input Systemd Journal

Parameter	Tipe	Wajib	Nilai default	Contoh	Deskripsi
Type	string	Ya	/	service_journal	Tipe plugin. Tetapkan nilainya ke service_journal.
JournalPaths	[string]	Ya	None	/var/log/journal	Jalur log Journal. Kami merekomendasikan agar Anda menetapkan parameter ini ke direktori tempat log Journal disimpan.
SeekPosition	string	Tidak	tail	tail	Metode pengumpulan awal. Nilai yang valid: head dan tail.* head: mengumpulkan semua data. * tail: mengumpulkan hanya data baru setelah konfigurasi pengumpulan Logtail diterapkan.
Kernel	bool	Tidak	true	true	Menentukan apakah akan mengumpulkan log kernel.
Units	[string]	Tidak	None	""	Daftar unit yang akan dikumpulkan. Secara default, parameter ini dibiarkan kosong, yang menunjukkan bahwa semua unit dikumpulkan.
ParseSyslogFacility	bool	Tidak	false	false	Menentukan apakah akan mengurai field facility dari log syslog. Jika Anda tidak mengonfigurasi parameter ini, field tidak diurai.
ParsePriority	bool	Tidak	false	false	Menentukan apakah akan mengurai field Priority. Jika Anda tidak mengonfigurasi parameter ini, field tidak diurai. Jika Anda menetapkan 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	Tidak	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. Perbedaan waktu untuk pengumpulan log real-time umumnya dalam 3 detik.

Plugin input SQL Server

Parameter	Tipe	Wajib	Nilai default	Contoh	Deskripsi
Type	string	Ya	/	service_mssql	Tipe plugin. Tetapkan nilainya ke service_mssql.
Address	string	Tidak	127.0.0.1:1433	rm-*.sqlserver.rds.aliyuncs.com	Alamat database SQL Server.
User	string	Tidak	root	root	Nama pengguna yang digunakan untuk login ke database SQL Server.
Password	string	Tidak	None		Kata sandi dari pengguna yang digunakan untuk login ke database SQL Server. Untuk tujuan keamanan, Anda dapat menetapkan nama pengguna dan kata sandi ke xxx. Setelah konfigurasi pengumpulan disinkronkan ke mesin on-premises Anda, temukan konfigurasi dalam file /usr/local/ilogtail/user_log_config.json dan ubah. Untuk informasi selengkapnya, lihat Ubah konfigurasi lokal. Penting Jika Anda mengubah parameter ini di konsol, konfigurasi lokal akan ditimpa setelah sinkronisasi.
DataBase	string	Tidak	/	project_database	Nama database.
DialTimeOutMs	int	Tidak	5000	5000	Periode waktu habis untuk koneksi ke database SQL Server. Satuan: md.
ReadTimeOutMs	int	Tidak	5000	5000	Periode waktu habis untuk membaca hasil query SQL Server. Satuan: md.
StateMent	string	Tidak	/		Pernyataan SELECT. Jika Anda menetapkan 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 menetapkan 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 diganti dengan ID yang sesuai dengan checkpoint.
Limit	bool	Tidak	false	true	Menentukan apakah akan menggunakan LIMIT untuk paging.* true: menggunakan LIMIT untuk paging. * false (default): tidak menggunakan LIMIT untuk paging.Kami merekomendasikan agar Anda menggunakan LIMIT untuk paging. Jika Anda menetapkan Limit ke true, sistem secara otomatis menambahkan klausa LIMIT ke pernyataan SELECT selama query SQL.
PageSize	int	Tidak	/	10	Jumlah entri yang akan dikembalikan pada setiap halaman. Parameter ini wajib jika Anda menetapkan Limit ke true.
MaxSyncSize	int	Tidak	0	0	Jumlah maksimum catatan yang akan disinkronkan dalam satu waktu. Nilai defaultnya adalah 0, yang menunjukkan bahwa tidak ada batasan yang diberlakukan.
CheckPoint	bool	Tidak	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	Tidak	None	1	Nama kolom checkpoint. Parameter ini wajib jika Anda menetapkan CheckPoint ke true. Peringatan Nilai dalam kolom ini harus inkremental. Jika tidak, data mungkin gagal dikumpulkan. Nilai maksimum dalam setiap hasil query digunakan sebagai input untuk query berikutnya.
CheckPointColumnType	string	Tidak	None	int	Tipe data dari kolom checkpoint. Nilai yang valid: int dan time. Tipe int disimpan sebagai int64. Tipe time mendukung tipe date, datetime, dan time dari SQL Server. Parameter ini wajib jika Anda menetapkan CheckPoint ke true.
CheckPointStart	string	Tidak	None		Nilai awal dari kolom checkpoint. Parameter ini wajib jika Anda menetapkan CheckPoint ke true.
CheckPointSavePerPage	bool	Tidak	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	Tidak	60000	60000	Interval sinkronisasi. Nilai defaultnya adalah 60.000. Satuan: md.

Plugin input PostgreSQL

Parameter	Tipe	Wajib	Nilai default	Contoh	Deskripsi
Type	string	Ya	/	service_pgsql	Tipe plugin. Tetapkan nilainya ke service_pgsql.
Address	string	Tidak	127.0.0.1:5432	rm-*.pg.rds.aliyuncs.com	Alamat database PostgreSQL.
User	string	Tidak	root	root	Nama pengguna yang digunakan untuk login ke database PostgreSQL.
Password	string	Tidak	None		Kata sandi dari pengguna yang digunakan untuk login ke database PostgreSQL. Untuk tujuan keamanan, Anda dapat menetapkan nama pengguna dan kata sandi ke xxx. Setelah konfigurasi pengumpulan disinkronkan ke mesin on-premises Anda, temukan konfigurasi dalam file /usr/local/ilogtail/user_log_config.json dan ubah. Untuk informasi selengkapnya, lihat Ubah konfigurasi lokal. Penting Jika Anda mengubah parameter ini di konsol, konfigurasi lokal akan ditimpa setelah sinkronisasi.
DataBase	string	Tidak	/	project_database	Nama database PostgreSQL.
DialTimeOutMs	int	Tidak	5000	5000	Waktu habis koneksi untuk database PostgreSQL, dalam milidetik.
ReadTimeOutMs	int	Tidak	5000	5000	Waktu habis untuk membaca hasil query PostgreSQL. Satuan: md.
StateMent	string	Tidak	/		Pernyataan SELECT. Jika CheckPoint ditetapkan ke true, klausa WHERE dalam StateMent harus mencakup kondisi untuk kolom checkpoint. Kolom checkpoint ditentukan oleh parameter CheckPointColumn. Kondisi ini harus menggunakan $1 sebagai placeholder untuk nilai checkpoint. Misalnya: Tetapkan CheckPointColumn ke id dan StateMent ke SELECT * from ... where id > $1
Limit	Boolean	Tidak	false	true	Menentukan apakah akan menggunakan Limit untuk paging.* true: Gunakan Limit. * false (default): Jangan gunakan Limit.Gunakan Limit untuk paging. Jika ditetapkan ke true, sistem secara otomatis menambahkan pernyataan LIMIT ke pernyataan SELECT selama query SQL.
PageSize	int	Tidak	/	10	Ukuran halaman. Parameter ini wajib jika Limit ditetapkan ke true.
MaxSyncSize	int	Tidak	0	0	Jumlah maksimum catatan yang akan disinkronkan setiap kali. Nilai defaultnya adalah 0, yang berarti tidak ada batasan.
CheckPoint	bool	Tidak	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	Tidak	Kosong	1	Nama kolom CheckPoint. Parameter ini wajib ketika CheckPoint ditetapkan ke true. Peringatan Nilai kolom ini harus inkremental. Jika tidak, masalah pengumpulan data dapat terjadi karena nilai maksimum dari setiap query digunakan sebagai input untuk query berikutnya.
CheckPointColumnType	string	Tidak	kosong	int	Tipe data dari kolom CheckPoint. Nilai yang didukung adalah int dan time. Tipe int disimpan sebagai int64. Tipe time mendukung tipe waktu PostgreSQL. Parameter ini wajib ketika parameter CheckPoint ditetapkan ke true.
CheckPointStart	string	Tidak	kosong		Nilai awal dari kolom CheckPoint. Parameter ini wajib ketika CheckPoint ditetapkan ke true.
CheckPointSavePerPage	bool	Tidak	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	Tidak	60000	60000	Interval sinkronisasi. Nilai defaultnya adalah 60000 md.

Plugin input SNMP

Parameter	Tipe	Wajib	Nilai default	Contoh	Deskripsi
Targets	[string]	Ya	/	127.0.0.1	Alamat IP dari grup mesin target.
Port	string	Tidak	161	161	Port yang digunakan oleh protokol SNMP.
Community	string	Tidak	public	public	String komunitas. SNMPv1 dan SNMPv2 menggunakan string komunitas untuk autentikasi.
UserName	string	Tidak	Kosong	root	Nama pengguna. SNMPv3 mendukung autentikasi menggunakan nama pengguna.
AuthenticationProtocol	string	Tidak	NoAuth	NoAuth	Protokol autentikasi. SNMPv3 mendukung autentikasi menggunakan protokol autentikasi.
AuthenticationPassphrase	string	Tidak	Kosong		Frasa sandi autentikasi. Nilai defaultnya kosong. Jika Anda menetapkan AuthenticationProtocol ke MD5 atau SHA, Anda harus menetapkan AuthenticationPassphrase.
PrivacyProtocol	string	Tidak	NoPriv	NoPriv	Protokol privasi. SNMPv3 mendukung autentikasi menggunakan protokol privasi.
PrivacyPassphrase	string	Tidak	Kosong		Frasa sandi protokol privasi. Secara default, sama dengan frasa sandi autentikasi. Jika Anda menetapkan PrivacyProtocol ke DES atau AES, Anda harus menetapkan PrivacyPassphrase.
Timeout	int	Tidak	5	5	Periode waktu habis untuk operasi query, dalam detik.
Version	int	Tidak	2	2	Versi protokol SNMP. Nilai yang valid adalah 1, 2, dan 3.
Transport	string	Tidak	udp	udp	Metode komunikasi SNMP. Nilai yang valid adalah udp dan tcp.
MaxRepetitions	int	Tidak	0	0	Jumlah percobaan ulang setelah query melewati waktu habis.
Oids	[string]	Tidak	Kosong	1	Object Identifier (OID) yang akan ditanyakan pada mesin target.
Fields	[string]	Tidak	Kosong	int	Field yang akan ditanyakan pada mesin target. Plugin mencari field-field ini dalam Management Information Base (MIB) lokal, menerjemahkannya menjadi Object Identifier (OID), dan kemudian menanyakannya.
Tables	[string]	Tidak	Kosong		Tabel yang akan ditanyakan pada mesin target. Plugin menemukan semua field dalam tabel yang ditentukan, mencarinya dalam Management Information Base (MIB) lokal, menerjemahkannya menjadi Object Identifier (OID), dan kemudian menanyakannya.

Plugin pengumpul output skrip

Parameter	Tipe	Wajib	Nilai default	Contoh	Deskripsi
Type	string	Ya	/	input_command	Tipe plugin. Nilainya ditetapkan ke input_command.
ScriptType	string	Ya	Kosong	shell	Tipe konten skrip. Nilai yang valid adalah bash, shell, python2, dan python3.
User	string	Ya	/	public	Nama pengguna yang digunakan untuk menjalankan perintah. Hanya pengguna non-root yang didukung. Catatan * Pastikan nama pengguna yang ditentukan ada pada mesin. Konfigurasikan hak istimewa minimum. Berikan hanya izin rwx untuk folder atau file yang akan dipantau.
ScriptContent	string	Ya	Kosong		Konten skrip. Konten dapat berupa teks biasa atau berenkode Base64. Panjangnya tidak boleh melebihi 512 × 1024 byte.
ContentEncoding	string	Tidak	PlainText	PlainText	Format encoding dari konten skrip. Parameter ini bersifat opsional. Nilai yang valid:* PlainText (Default): Konten skrip adalah teks biasa dan tidak dienkode. * Base64: Konten skrip berenkode Base64.
LineSplitSep	string	Tidak	Kosong		Pemisah yang digunakan untuk memecah output skrip. Jika Anda membiarkan parameter ini kosong, output tidak dipecah dan dikembalikan sebagai satu entri log.
CmdPath	string	Tidak	Kosong	/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	Tidak	3000	3000	Periode waktu habis untuk eksekusi skrip. Satuan: milidetik.
IgnoreError	bool	Tidak	false	false	Menentukan apakah akan mengabaikan log error jika plugin gagal dijalankan. Nilai defaultnya adalah false, yang menunjukkan bahwa error tidak diabaikan.
Environments	[string]	Tidak			Variabel lingkungan. Secara default, nilai os.Environ() digunakan. Jika Anda menetapkan parameter ini, variabel lingkungan yang ditentukan ditambahkan ke nilai os.Environ().
IntervalMs	int	Tidak	5000	5000	Interval pengumpulan data atau eksekusi skrip. Satuan: milidetik.

Plugin prosesor native

Plugin parsing regex native

Parameter	Tipe	Wajib	Nilai default	Contoh	Deskripsi
Type	string	Ya	None	processor_parse_regex_native	Tipe plugin. Nilainya ditetapkan ke processor_parse_regex_native.
SourceKey	string	Ya	None	content	Nama field sumber.
Regex	string	Ya	None	(\d+-\d+-\d+)\s+(.*)	Ekspresi reguler.
Keys	[string]	Ya	None	["time", "msg"]	Daftar field yang diekstrak.
KeepingSourceWhenParseFail	bool	Tidak	false	false	Menentukan apakah akan mempertahankan field sumber jika parsing gagal.
KeepingSourceWhenParseSucceed	bool	Tidak	false	false	Menentukan apakah akan mempertahankan field sumber jika parsing berhasil.
RenamedSourceKey	string	Tidak	Kosong	key	Nama baru untuk field sumber jika dipertahankan. Jika Anda membiarkan parameter ini kosong, field sumber tidak diganti namanya.

Plugin parsing JSON native

Parameter	Tipe	Wajib	Nilai Default	Contoh	Deskripsi
Type	string	Ya	/	processor_parse_json_native	Tipe plugin. Nilainya ditetapkan ke processor_parse_json_native.
SourceKey	string	Ya	/	content	Nama field sumber.
KeepingSourceWhenParseFail	bool	Tidak	false	false	Menentukan apakah akan mempertahankan field sumber jika parsing gagal.
KeepingSourceWhenParseSucceed	bool	Tidak	false	false	Menentukan apakah akan mempertahankan field sumber jika parsing berhasil.
RenamedSourceKey	string	Tidak	kosong	key	Nama field baru untuk field sumber ketika dipertahankan. Jika parameter ini dibiarkan kosong, field sumber tidak diganti namanya.

Plugin parsing separator native

Parameter	Tipe	Wajib	Nilai default	Contoh	Deskripsi
Type	string	Ya	/	processor_parse_delimiter_native	Tipe plugin. Nilainya harus processor_parse_delimiter_native.
SourceKey	string	Ya	/	content	Nama field sumber.
Separator	string	Ya	/	,	Karakter pemisah.
Quote	string	Tidak	"	"	Karakter kutip.
Keys	[string]	Ya	/	["time", "msg"]	Daftar kunci untuk field yang diekstrak.
AllowingShortenedFields	bool	Tidak	true	true	Menentukan apakah akan mengizinkan field yang diekstrak lebih sedikit daripada kunci. Jika ditetapkan ke false, parsing gagal jika jumlah field lebih kecil daripada jumlah kunci.
OverflowedFieldsTreatment	string	Tidak	extend	extend	Perilaku ketika jumlah field yang diekstrak lebih besar daripada jumlah kunci. Nilai yang valid:* extend: Menyimpan field tambahan dan menambahkan masing-masing ke log sebagai field terpisah. Field tambahan diberi nama __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	Tidak	false	false	Menentukan apakah akan mempertahankan field sumber jika parsing gagal.
KeepingSourceWhenParseSucceed	bool	Tidak	false	false	Menentukan apakah akan mempertahankan field sumber jika parsing berhasil.
RenamedSourceKey	string	Tidak	kosong	key	Nama field yang digunakan untuk menyimpan field sumber ketika field sumber dipertahankan. Jika Anda tidak menentukan nama, field sumber tidak diganti namanya.

Plugin parsing Apsara native

Parameter	Tipe	Wajib	Nilai default	Contoh	Deskripsi
Type	string	Ya	/	processor_parse_apsara_native	Tipe plugin. Nilainya ditetapkan ke processor_parse_apsara_native.
SourceKey	string	Ya	/	content	Nama field sumber.
Timezone	string	Tidak	Kosong	GMT+08:00	Zona waktu dari log. Formatnya adalah GMT+HH:MM untuk zona waktu timur atau GMT-HH:MM untuk zona waktu barat.
KeepingSourceWhenParseFail	bool	Tidak	false	false	Menentukan apakah akan mempertahankan field sumber ketika parsing gagal.
KeepingSourceWhenParseSucceed	bool	Tidak	false	false	Menentukan apakah akan mempertahankan field sumber ketika parsing berhasil.
RenamedSourceKey	string	Tidak	Kosong	key	Nama field yang menyimpan field sumber jika field sumber dipertahankan. Jika parameter ini kosong, field sumber tidak diganti namanya.

Plugin parsing waktu native

Parameter	Tipe	Wajib	Nilai default	Contoh	Deskripsi
Type	string	Ya	/	processor_parse_timestamp_native	Tipe plugin. Nilainya harus processor_parse_timestamp_native.
SourceKey	string	Ya	/	content	Nama field sumber.
SourceFormat	string	Ya	/	%Y/%m/%d %H:%M:%S	Format waktu dari log. Untuk informasi selengkapnya, lihat Format waktu.
SourceTimezone	string	Tidak	Kosong	GMT+08:00	Zona waktu dari log. Formatnya adalah GMT+HH:MM untuk zona waktu timur atau GMT-HH:MM untuk zona waktu barat.

Plugin penyaringan native

Parameter	Tipe	Wajib	Contoh	Nilai default	Deskripsi
Type	string	Ya	processor_filter_regex_native	/	Tipe plugin. Nilainya ditetapkan ke processor_filter_regex_native.
Include	map	Ya	/	/	Daftar putih untuk field log. Kuncinya adalah nama field dan nilainya adalah ekspresi reguler. Sebuah log dikumpulkan hanya jika konten field yang ditentukan cocok dengan ekspresi reguler. Jika Anda mendefinisikan beberapa kondisi, sebuah log dikumpulkan hanya jika memenuhi semuanya.

Plugin penyamaran data native

Parameter	Tipe	Wajib	Nilai default	Contoh	Deskripsi
Type	string	Ya	/	processor_desensitize_native	Tipe plugin. Nilainya ditetapkan ke processor_desensitize_native.
SourceKey	string	Ya	/	content	Nama field sumber.
Method	string	Ya	/	const	Metode penyamaran data. Nilai yang valid mencakup yang berikut: const: Mengganti konten sensitif dengan string konstan. md5: Mengganti konten sensitif dengan nilai MD5-nya.
ReplacingString	string	Tidak. Parameter ini wajib ketika Method ditetapkan ke const.	/	******	String konstan yang digunakan untuk mengganti konten sensitif.
ContentPatternBeforeReplacedString	string	Ya	/	'password:'	Ekspresi reguler untuk prefiks dari konten sensitif.
ReplacedContentPattern	string	Ya	/	[^']*	Ekspresi reguler untuk konten sensitif.
ReplacingAll	bool	Tidak	true	true	Menentukan apakah akan mengganti semua konten sensitif yang cocok.

Plugin prosesor ekstensi

Mengambil field

Pola ekspresi reguler

Parameter	Tipe	Wajib	Nilai default	Contoh	Deskripsi
Type	string	Ya	/	processor_regex	Tipe plugin. Ini ditetapkan ke processor_regex.
SourceKey	string	Ya	/	content	Nama field sumber.
Regex	string	Ya	/	(\d+-\d+-\d+)\s+(.*)	Ekspresi reguler. Gunakan tanda kurung () untuk menganotasi field yang akan diambil.
Keys	[string]	Ya	/	["ip", "time", "method"]	Menentukan nama field untuk konten yang diambil, seperti ["ip", "time", "method"].
NoKeyError	boolean	Tidak	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	Tidak	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	Tidak	false	false	Menentukan apakah akan mempertahankan field sumber dalam log yang diurai.* true: Mempertahankan field sumber. * false (default): Tidak mempertahankan field sumber.
FullMatch	boolean	Tidak	true	true	Menentukan apakah akan mengambil nilai field hanya ketika kecocokan penuh ditemukan.* true (default): Nilai field diambil hanya jika semua field yang Anda tetapkan dalam parameter Keys cocok dengan nilai field sumber berdasarkan ekspresi reguler dalam parameter Regex. * false: Nilai field diambil bahkan jika hanya kecocokan parsial yang ditemukan.
KeepSourceIfParseError	boolean	Tidak	true	false	Menentukan apakah akan mempertahankan field sumber dalam log jika parsing gagal.* true (default): Mempertahankan field sumber. * false: Tidak mempertahankan field sumber.

Mode pemisah

Parameter	Tipe	Wajib	Nilai Default	Contoh	Deskripsi
Type	string	Ya	N/A	processor_anchor	Tipe plugin. Ini ditetapkan ke processor_anchor.
SourceKey	string	Ya	N/A	content	Nama field sumber.
Anchors	array	Ya	N/A		Daftar item anchor.
Start	string	Ya	Kosong	time	Kata kunci awal. Jika parameter ini kosong, akan cocok dengan awal string.
Stop	string	Ya	Kosong	\t	Kata kunci akhir. Jika parameter ini kosong, akan cocok dengan akhir string.
FieldName	string	Ya	Kosong	time	Nama field untuk konten yang diekstrak.
FieldType	string	Ya	Kosong	string	Tipe field. Nilai yang valid adalah string dan json.
ExpandJson	boolean	Tidak	false	false	Menentukan apakah akan memperluas field JSON.* true: Memperluas field. * false (default): Tidak memperluas field.
ExpandConnector	string	Tidak	_	_	Konektor yang digunakan untuk perluasan JSON. Nilai defaultnya adalah garis bawah (_).
MaxExpandDepth	integer	Tidak	0	0	Kedalaman maksimum untuk perluasan JSON. Nilai defaultnya adalah 0, yang berarti tidak ada batasan.
NoAnchorError	boolean	Tidak	false	false	Menentukan apakah akan melaporkan error jika item anchor tidak ditemukan.* true: Melaporkan error. * false (default): Tidak melaporkan error.
NoKeyError	boolean	Tidak	false	false	Menentukan apakah akan melaporkan error jika field sumber yang ditentukan tidak ada dalam log mentah.* true: Melaporkan error. * false (default): Tidak melaporkan error.
KeepSource	boolean	Tidak	false	false	Menentukan apakah akan mempertahankan field sumber dalam log yang diurai.* true: Mempertahankan field sumber. * false (default): Tidak mempertahankan field sumber.

Pola CSV

Parameter	Tipe	Wajib	Nilai default	Contoh	Deskripsi
Type	string	Ya	None	processor_csv	Tipe plugin. Tetapkan ini ke processor_csv.
SourceKey	String	Ya	None	csv	Nama field sumber.
SplitKeys	Array string	Ya	None	["date", "ip", "content"]	Tentukan nama field untuk konten yang diekstrak, seperti ["date", "ip", "content"]. Penting Jika jumlah field yang akan dipecah lebih kecil daripada jumlah field yang ditentukan dalam parameter SplitKeys, field berlebih dalam SplitKeys diabaikan.
PreserveOthers	Boolean	Tidak	false	false	Menentukan apakah akan mempertahankan konten yang tersisa ketika data sumber berisi lebih banyak field daripada yang ditentukan dalam parameter SplitKeys.* true: Mempertahankan konten yang tersisa. * false (default): Tidak mempertahankan konten yang tersisa.
ExpandOthers	Boolean	Tidak	false	false	Menentukan apakah akan mengurai konten yang tersisa.* true: Mengurai konten. Gunakan parameter ExpandKeyPrefix untuk menentukan prefiks untuk nama field tambahan. * false (default): Tidak mengurai konten. Jika PreserveOthers ditetapkan ke true dan ExpandOthers ditetapkan ke false, konten yang tersisa disimpan dalam field _decode_preserve_.Catatan Jika konten field tambahan tidak dalam format CSV standar, normalisasikan sebelum penyimpanan.
ExpandKeyPrefix	String	Tidak			Prefiks untuk nama field tambahan. Misalnya, jika Anda menetapkan parameter ini ke expand_, nama field menjadi expand_1, expand_2, dan seterusnya.
TrimLeadingSpace	Boolean	Tidak	false	false	Menentukan apakah akan mengabaikan spasi di awal dalam nilai field.* true: Mengabaikan spasi di awal. * false (default): Tidak mengabaikan spasi di awal.
SplitSep	String	Tidak	,	,	Pemisah. Nilai defaultnya adalah koma (,).
KeepSource	Boolean	Tidak	false	false	Menentukan apakah akan mempertahankan field sumber dalam log yang diurai.* true: Mempertahankan field sumber. * false (default): Tidak mempertahankan field sumber.
NoKeyError	Boolean	Tidak	false	false	Menentukan apakah akan melaporkan error jika field sumber yang ditentukan tidak ada dalam log mentah.* true: Melaporkan error. * false (default): Tidak melaporkan error.

Pola pemisah karakter tunggal

Parameter	Tipe	Wajib	Nilai default	Contoh	Deskripsi
Type	string	Ya	/	processor_split_char	Tipe plugin. Nilainya harus processor_split_char.
SourceKey	String	Ya			Nama field sumber.
SplitSep	String	Ya			Pemisah. Ini harus berupa karakter tunggal. Karakter non-printabel, seperti , dapat digunakan.
SplitKeys	Array string	Ya		["ip", "time", "method"]	Tentukan nama field untuk konten yang diekstrak. Misalnya, ["ip", "time", "method"].
PreserveOthers	Boolean	Tidak	false	false	Menentukan apakah akan mempertahankan field yang tersisa ketika jumlah field yang dipecah lebih besar daripada jumlah kunci dalam SplitKeys.* true: Mempertahankan field yang tersisa. * false (default): Tidak mempertahankan field yang tersisa.
QuoteFlag	Boolean	Tidak	false	false	Menentukan apakah akan menggunakan karakter kutip.* true: Menggunakan karakter kutip. * false (default): Tidak menggunakan karakter kutip.
Quote	String	Tidak	/		Karakter kutip. Ini harus berupa karakter tunggal. Karakter non-printabel, seperti , dapat digunakan. Parameter ini hanya valid ketika QuoteFlag ditetapkan ke true.
NoKeyError	Boolean	Tidak	false	false	Menentukan apakah akan melaporkan error jika field sumber yang ditentukan tidak ada dalam log mentah.* true: Melaporkan error. * false (default): Tidak melaporkan error.
NoMatchError	Boolean	Tidak	false	false	Menentukan apakah akan melaporkan error jika pemisah yang ditentukan tidak cocok dengan pemisah dalam log.* true: Melaporkan error. * false (default): Tidak melaporkan error.
KeepSource	Boolean	Tidak	false	false	Menentukan apakah akan mempertahankan field sumber dalam log yang diurai.* true: Mempertahankan field sumber. * false (default): Tidak mempertahankan field sumber.

Pola pemisah multi-karakter

Parameter	Tipe	Wajib	Nilai default	Contoh	Deskripsi
Type	string	Ya	/	processor_split_string	Tipe plugin. Parameter ini ditetapkan ke processor_split_string.
SourceKey	String	Ya			Nama field sumber.
SplitSep	String	Ya			Pemisah. Ini harus berupa karakter tunggal. Anda dapat menetapkan parameter ini ke karakter non-printabel, seperti .
SplitKeys	Array string	Ya		["key1","key2"]	Nama field untuk konten yang diekstrak, seperti ["key1","key2"]. Catatan Jika jumlah field yang akan dipecah lebih kecil daripada jumlah kunci dalam parameter SplitKeys, kunci tambahan diabaikan.
PreserveOthers	Boolean	Tidak	false	false	Menentukan apakah akan mempertahankan field yang tersisa ketika jumlah field yang dipecah lebih besar daripada jumlah kunci dalam parameter SplitKeys.* `true`: Mempertahankan field yang tersisa. * `false` (default): Tidak mempertahankan field yang tersisa.
ExpandOthers	Boolean	Tidak	false	false	Menentukan apakah akan memperluas field yang tersisa menjadi pasangan kunci-nilai terpisah. Parameter ini hanya berlaku ketika PreserveOthers ditetapkan ke true.* `true`: Memperluas field. * `false` (default): Tidak memperluas field.
ExpandKeyPrefix	String	Tidak	/	expand_	Prefiks untuk nama field yang tersisa. Misalnya, jika Anda menetapkan parameter ini ke expand_, nama field menjadi expand_1, expand_2, dan seterusnya.
NoKeyError	Boolean	Tidak	false	false	Menentukan apakah akan melaporkan error jika field sumber yang ditentukan dalam SourceKey tidak ada dalam log mentah.* `true`: Melaporkan error. * `false` (default): Tidak melaporkan error.
NoMatchError	Boolean	Tidak	false	false	Menentukan apakah akan melaporkan error jika konten log tidak dapat dipecah oleh pemisah yang ditentukan dalam SplitSep.* `true`: Melaporkan error. * `false` (default): Tidak melaporkan error.
KeepSource	Boolean	Tidak	false	false	Menentukan apakah akan mempertahankan field sumber dalam log yang diurai.* `true`: Mempertahankan field sumber. * `false` (default): Tidak mempertahankan field sumber.

Pola pasangan kunci-nilai

Parameter	Tipe	Wajib	Nilai Default	Contoh	Deskripsi
Type	string	Ya	/	processor_split_key_value	Tipe plugin. Tetapkan ini ke processor_split_key_value.
SourceKey	string	Ya			Nama field sumber.
Delimiter	string	Tidak	\t	\t	Pemisah antara pasangan kunci-nilai. Nilai defaultnya adalah karakter tab \t.
Separator	string	Tidak	:	:	Pemisah antara kunci dan nilai dalam pasangan kunci-nilai. Nilai defaultnya adalah titik dua (:).
KeepSource	Boolean	Tidak	false	false	Menentukan apakah akan mempertahankan field sumber dalam log setelah parsing.* true: Mempertahankan field sumber. * false (default): Tidak mempertahankan field sumber.
ErrIfSourceKeyNotFound	Boolean	Tidak	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	Tidak	false	false	Menentukan apakah akan membuang pasangan kunci-nilai jika pemisah tidak ditemukan.* true: Membuang pasangan. * false (default): Tidak membuang pasangan.
ErrIfSeparatorNotFound	Boolean	Tidak	true	false	Menentukan apakah akan melaporkan error jika pemisah yang ditentukan tidak ditemukan.* true (default): Melaporkan error. * false: Tidak melaporkan error.
ErrIfKeyIsEmpty	Boolean	Tidak	true	false	Menentukan apakah akan melaporkan error jika sebuah kunci kosong setelah pemecahan.* true (default): Melaporkan error. * false: Tidak melaporkan error.
Quote	String	Tidak			Karakter kutip. Jika sebuah nilai diapit dalam karakter kutip yang ditentukan, konten di dalam tanda kutip diekstrak sebagai nilai. Parameter ini mendukung beberapa karakter. Secara default, fitur ini dinonaktifkan. Penting * Untuk menggunakan tanda kutip ganda (") sebagai karakter kutip, Anda harus meng-escape-nya dengan backslash (\\). Ketika backslash digunakan dengan karakter kutip di dalam nilai yang dikutip, backslash disertakan sebagai bagian dari nilai output.

Pola Grok

Parameter	Tipe	Wajib	Nilai default	Contoh	Deskripsi
Type	string	Ya	/	processor_grok	Tipe plugin. Ini ditetapkan ke processor_grok.
CustomPatternDir	Array string	Tidak			Folder tempat file pola Grok kustom berada. Plugin processor_grok membaca semua file di folder. Jika Anda tidak menambahkan parameter ini, file pola Grok kustom tidak diimpor. Penting Setelah memperbarui file pola Grok kustom, restart Logtail agar perubahan berlaku.
CustomPatterns	Map	Tidak			Pola GROK kustom. Kuncinya adalah nama aturan dan nilainya adalah ekspresi Grok. Untuk informasi selengkapnya tentang ekspresi default yang didukung, lihat processor_grok. Jika ekspresi yang Anda butuhkan tidak ada di tautan, masukkan ekspresi Grok kustom dalam Match. Jika Anda tidak menambahkan parameter ini, pola GROK kustom tidak digunakan.
SourceKey	String	Tidak	content	content	Nama field sumber. Nilai defaultnya adalah field content.
Match	Array string	Ya			Array ekspresi Grok. Plugin processor_grok mencocokkan log dengan ekspresi dalam daftar ini dari atas ke bawah. Plugin mengembalikan hasil dari kecocokan pertama yang berhasil. Catatan Mengonfigurasi beberapa ekspresi Grok dapat memengaruhi kinerja. Untuk kinerja terbaik, gunakan tidak lebih dari lima ekspresi.
TimeoutMilliSeconds	Long	Tidak		0	Waktu maksimum untuk mencoba mengambil field menggunakan ekspresi Grok, dalam milidetik. Jika Anda tidak menambahkan parameter ini atau menetapkannya ke 0, tidak ada waktu habis yang terjadi.
IgnoreParseFailure	Boolean	Tidak	true	true	Menentukan apakah akan mengabaikan log yang gagal diurai.* true (default): Mengabaikan log. * false: Menghapus log.
KeepSource	Boolean	Tidak	true	true	Menentukan apakah akan mempertahankan field sumber setelah parsing berhasil.* true (default): Mempertahankan field sumber. * false: Membuang field sumber.
NoKeyError	Boolean	Tidak	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	Tidak	true	true	Menentukan apakah sistem melaporkan error jika tidak ada ekspresi yang ditetapkan dalam parameter Match yang cocok dengan log.* true (default): Melaporkan error. * false: Tidak melaporkan error.
TimeoutError	Boolean	Tidak	true	true	Menentukan apakah sistem melaporkan error jika kecocokan melewati waktu habis.* true (default): Melaporkan error. * false: Tidak melaporkan error.

Tambahkan field

Parameter	Tipe	Wajib	Default	Contoh	Deskripsi
Type	string	Ya	/	processor_add_fields	Tipe plugin. Nilainya harus processor_add_fields.
Fields	Map	Ya			Nama dan nilai field yang akan ditambahkan. Tentukan field sebagai pasangan kunci-nilai. Beberapa field dapat ditambahkan.
IgnoreIfExist	Boolean	Tidak	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.

Hapus field

Parameter	Tipe	Wajib	Nilai default	Contoh	Deskripsi
Type	string	Ya	/	processor_drop	Tipe plugin. Nilainya ditetapkan ke processor_drop.
DropKeys	Array string	Ya			Field yang akan dihapus. Anda dapat menentukan beberapa field.

Ganti nama field

Parameter	Tipe	Wajib	Nilai default	Contoh	Deskripsi
Type	string	Ya	/	processor_rename	Tipe plugin. Nilainya ditetapkan ke processor_rename.
NoKeyError	Boolean	Tidak	false	false	Menentukan apakah akan melaporkan error jika field sumber tidak ditemukan dalam log.* true: Melaporkan error. * false: Tidak melaporkan error. Ini adalah nilai default.
SourceKeys	Array string	Ya			Field sumber yang akan diganti namanya.
DestKeys	Array string	Ya			Nama baru untuk field.

Bundel field

Parameter	Tipe	Wajib	Nilai default	Contoh	Deskripsi
Type	string	Ya	/	processor_packjson	Tipe plugin. Nilai ini ditetapkan ke processor_packjson.
SourceKeys	Array string	Ya			Field mentah yang akan dibundel.
DestKey	String	Tidak			Field tujuan untuk data yang dibundel.
KeepSource	Boolean	Tidak	true	true	Menentukan apakah akan mempertahankan field mentah dalam log setelah parsing.* true (default): Mempertahankan field mentah. * false: Membuang field mentah.
AlarmIfIncomplete	Boolean	Tidak	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	Tipe	Wajib	Nilai default	Contoh	Deskripsi
Type	string	Ya	/	processor_json	Tipe plugin. Nilai ini ditetapkan ke processor_json.
SourceKey	String	Ya			Nama field sumber yang akan diurai.
NoKeyError	Boolean	Tidak	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	Tidak	0	1	Kedalaman perluasan untuk objek JSON. Nilai defaultnya adalah 0, yang menunjukkan tidak ada batasan. Nilai 1 menunjukkan level saat ini, dan seterusnya.
ExpandConnector	String	Tidak	_	_	Konektor yang digunakan untuk menggabungkan nama field selama perluasan JSON. Nilai defaultnya adalah garis bawah (_).
Prefix	String	Tidak			Prefiks yang akan ditambahkan ke nama field yang diperluas.
KeepSource	Boolean	Tidak	true	true	Menentukan apakah akan mempertahankan field sumber dalam log setelah diurai.* true (default): Mempertahankan field sumber. * false: Membuang field sumber.
UseSourceKeyAsPrefix	Boolean	Tidak			Menentukan apakah akan menggunakan nama field sumber sebagai prefiks untuk semua nama field yang diperluas.
KeepSourceIfParseError	Boolean	Tidak	true	true	Menentukan apakah akan mempertahankan log mentah jika parsing gagal.* true (default): Mempertahankan log mentah. * false: Membuang log mentah.
ExpandArray	Boolean	Tidak	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"}.

Saring log

Parameter	Tipe	Wajib	Nilai Default	Contoh	Deskripsi
Type	string	Ya	/	processor_filter_regex	Tipe plugin. Nilainya ditetapkan ke processor_filter_regex.
Include	Objek JSON	Tidak			Kuncinya adalah field log dan nilainya adalah ekspresi reguler. AND logis diterapkan di antara pasangan kunci-nilai. Sebuah log dikumpulkan hanya jika semua field yang ditentukan cocok dengan ekspresi reguler yang sesuai.
Exclude	Objek JSON	Tidak			Kuncinya adalah field log dan nilainya adalah ekspresi reguler. OR logis diterapkan di antara pasangan kunci-nilai. Sebuah log dibuang jika ada field yang ditentukan yang cocok dengan ekspresi reguler yang sesuai.

Ambil waktu log

Parameter	Tipe	Wajib	Nilai default	Contoh	Deskripsi
Type	string	Ya	/	processor_gotime	Tipe plugin. Nilainya ditetapkan ke processor_gotime.
SourceKey	String	Ya			Nama field sumber.
SourceFormat	String	Ya			Format waktu sumber.
SourceLocation	Int	Ya			Zona waktu dari waktu sumber. Jika parameter ini dibiarkan kosong, zona waktu host atau kontainer tempat Logtail berjalan digunakan.
DestKey	String	Ya			Field tujuan untuk data yang diurai.
DestFormat	String	Ya			Format waktu yang diurai.
DestLocation	Int	Tidak			Zona waktu dari waktu yang diurai. Jika parameter ini dibiarkan kosong, zona waktu lokal digunakan.
SetTime	Boolean	Tidak	true	true	Menentukan apakah akan menggunakan waktu yang diurai sebagai waktu log.* true (default): Menggunakan waktu yang diurai sebagai waktu log. * false: Tidak menggunakan waktu yang diurai sebagai waktu log.
KeepSource	Boolean	Tidak	true	true	Menentukan apakah akan mempertahankan field sumber dalam log setelah diurai.* true (default): Mempertahankan field sumber. * false: Tidak mempertahankan field sumber.
NoKeyError	Boolean	Tidak	true	true	Menentukan apakah akan melaporkan error jika field sumber yang ditentukan tidak ditemukan dalam log mentah.* true (default): Melaporkan error. * false: Tidak melaporkan error.
AlarmIfFail	Boolean	Tidak	true	true	Menentukan apakah akan melaporkan error jika parsing waktu log gagal.* true (default): Melaporkan error. * false: Tidak melaporkan error.

Transformasi alamat IP

Parameter	Tipe	Wajib	Nilai default	Contoh	Deskripsi
Type	string	Ya	/	processor_geoip	Tipe plugin. Nilai ini ditetapkan ke processor_geoip.
SourceKey	String	Ya			Nama field sumber yang berisi alamat IP yang akan ditransformasikan.
DBPath	String	Ya		/user/data/GeoLite2-City_20180102/GeoLite2-City.mmdb	Jalur lengkap dari database GeoIP. Misalnya, /user/data/GeoLite2-City_20180102/GeoLite2-City.mmdb.
NoKeyError	Boolean	Tidak	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	Tidak	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	Tidak	true	true	Menentukan apakah akan mempertahankan field sumber dalam log setelah parsing.* true (default): Mempertahankan field sumber. * false: Tidak mempertahankan field sumber.
Language	String	Tidak	zh-CN	zh-CN	Properti bahasa. Nilai defaultnya adalah zh-CN. Penting Pastikan database GeoIP Anda menyertakan bahasa yang ditentukan.

Penyamaran data

Parameter	Tipe	Wajib	Nilai default	Contoh	Deskripsi
Type	string	Ya	/	processor_desensitize	Tipe plugin. Nilainya ditetapkan ke processor_desensitize.
SourceKey	string	Ya			Nama field log.
Method	string	Ya		const	Metode penyamaran. Nilai yang valid:* const: Mengganti konten sensitif dengan string yang ditentukan. Gunakan parameter ReplaceString untuk menentukan string. * md5: Mengganti konten sensitif dengan hash MD5-nya.
Match	string	Tidak	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	Tidak			String yang menggantikan konten sensitif. Parameter ini wajib jika Anda menetapkan Method ke const.
RegexBegin	string	Tidak			Ekspresi reguler yang cocok dengan prefiks konten sensitif. Parameter ini wajib jika Anda menetapkan Match ke regex.
RegexContent	string	Tidak			Ekspresi reguler yang cocok dengan konten sensitif. Parameter ini wajib jika Anda menetapkan Match ke regex.

Pemetaan nilai field

Parameter	Tipe	Wajib	Nilai default	Contoh	Deskripsi
Type	string	Ya	/	processor_dict_map	Tipe plugin. Nilai ini ditetapkan ke processor_dict_map.
SourceKey	String	Ya			Nama field sumber.
MapDict	Map	Tidak			Kamus pemetaan. Gunakan parameter ini untuk mengonfigurasi kamus pemetaan kecil. File kamus CSV lokal tidak diperlukan. Penting Jika Anda menetapkan parameter DictFilePath, pengaturan dalam parameter MapDict tidak berlaku.
DictFilePath	String	Tidak			File kamus dalam format CSV. File ini menggunakan koma (,) sebagai pemisah dan tanda kutip ganda (") untuk mengapit referensi field.
DestKey	String	Tidak			Nama field tujuan.
HandleMissing	Boolean	Tidak	false	false	Menentukan apakah akan memproses log mentah jika field tujuan tidak ada.* true: Memproses log. Sistem mengisi field dengan nilai parameter Missing. * false (default): Tidak memproses log.
Missing	String	Tidak	Unknown	Unknown	Nilai yang akan digunakan untuk field tujuan jika tidak ada dalam log mentah. Nilai defaultnya adalah Unknown. Parameter ini hanya berlaku ketika HandleMissing ditetapkan ke true.
MaxDictSize	Int	Tidak	1000	1000	Ukuran maksimum kamus pemetaan. Nilai defaultnya adalah 1000, yang berarti Anda dapat menyimpan hingga 1000 aturan pemetaan. Untuk membatasi memori server yang digunakan oleh plugin, kurangi nilai ini.
Mode	String	Tidak	overwrite	overwrite	Tindakan yang akan diambil jika field tujuan sudah ada dalam log mentah.* overwrite (default): Menimpa field asli. * fill: Tidak menimpa field asli.

Enkripsi field

Parameter	Tipe	Wajib	Nilai default	Contoh	Deskripsi
Type	string	Ya	/	processor_encrypt	Tipe plugin. Nilainya ditetapkan ke processor_encrypt.
SourceKey	Array string	Ya			Nama field sumber.
EncryptionParameters	Object	Ya			Konfigurasi untuk kunci enkripsi.
Key	String	Ya			Kunci enkripsi. Nilainya harus berupa string heksadesimal 64 karakter.
IV	String	Tidak	00000000000000000000000000000000		Initialization vector (IV) untuk enkripsi. Nilainya harus berupa string heksadesimal 32 karakter. Nilai defaultnya adalah 00000000000000000000000000000000.
KeyFilePath	Boolean	Tidak			Jalur ke file yang berisi parameter enkripsi. Jika parameter ini tidak ditetapkan, sistem menggunakan jalur dari File Path dalam Pengaturan Input dari konfigurasi Logtail.
KeepSourceValueIfError	String	Tidak	false	false	Menentukan apakah akan mempertahankan nilai field asli jika enkripsi gagal.* `true`: Mempertahankan nilai asli. * `false` (default): Tidak mempertahankan nilai asli.Jika enkripsi gagal, nilai field diganti dengan ENCRYPT_ERROR.

Penggantian string

Parameter	Tipe	Wajib	Nilai default	Contoh	Deskripsi
Type	string	Ya	/	processor_string_replace	Tipe plugin. Nilainya ditetapkan ke processor_string_replace.
SourceKey	String	Ya			Nama field sumber.
Method	String	Ya			Menentukan metode pencocokan. Nilai yang valid:* const: Mengganti konten dengan string. * regex: Mengganti konten menggunakan ekspresi reguler. * unquote: Menghapus karakter escape.
Match	String	Tidak			Konten yang akan dicocokkan.* Jika Method ditetapkan ke const, masukkan string yang akan diganti. Semua string yang cocok diganti. * Jika Method ditetapkan 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 ditetapkan ke unquote, parameter ini tidak diperlukan.
ReplaceString	String	Tidak			String yang digunakan untuk penggantian. Nilai defaultnya adalah "".* Jika Method ditetapkan ke const, masukkan string untuk mengganti konten asli. * Jika Method ditetapkan ke regex, masukkan string untuk mengganti konten asli. Penggantian berdasarkan grup ekspresi reguler didukung. * Jika Method ditetapkan ke unquote, parameter ini tidak diperlukan.
DestKey	String	Tidak			Menentukan field baru untuk konten yang diganti. Secara default, tidak ada field baru yang ditambahkan.

Encoding dan decoding data

Parameter	Tipe	Wajib	Nilai default	Contoh	Deskripsi
Type	string	Ya	/	processor_base64_encoding	Tipe plugin. Parameter ini ditetapkan ke processor_base64_encoding.
SourceKey	String	Ya			Nama field sumber.
NewKey	String	Ya			Nama field yang menyimpan hasil yang dienkode.
NoKeyError	Boolean	Tidak	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	Tipe	Wajib	Nilai default	Contoh	Deskripsi
Type	string	Ya	/	processor_log_to_sls_metric	Tipe plugin. Nilainya ditetapkan ke processor_log_to_sls_metric.
MetricTimeKey	String	Tidak			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 mencakup detik (10 digit), milidetik (13 digit), mikrodetik (16 digit), dan nanodetik (19 digit).
MetricLabelKeys	[]String	Ya			Menentukan daftar kunci untuk field __labels__. Kunci harus mengikuti ekspresi reguler ^[a-zA-Z_][a-zA-Z0-9_]*$. Nilai tidak boleh berisi garis vertikal (
MetricValues	Map	Ya			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 Data deret waktu (Metric).
CustomMetricLabels	Map	Tidak			Field __labels__ kustom. Kunci harus mengikuti ekspresi reguler ^[a-zA-Z_][a-zA-Z0-9_]*$. Nilai tidak boleh berisi garis vertikal (
IgnoreError	Boolean	Tidak			Menentukan apakah akan mengeluarkan log error jika tidak ada log yang cocok. Nilai defaultnya adalah false, yang berarti tidak ada log error yang dikeluarkan.

Log ke trace

Parameter	Tipe	Wajib	Nilai Default	Contoh	Deskripsi
Type	string	Ya	/	processor_otel_trace	Tipe plugin. Parameter ini ditetapkan ke processor_otel_trace.
SourceKey	String	Ya			Nama field sumber.
Format	String	Ya		json	Format setelah transformasi. Nilai yang valid: protobuf, json, dan protojson.
NoKeyError	Boolean	Tidak	false	true	Menentukan apakah akan melaporkan error jika field sumber tidak ada dalam log. Nilai defaultnya adalah false.
TraceIDNeedDecode	Boolean	Tidak			Menentukan apakah akan mendekode TraceID dari Base64. Nilai defaultnya adalah false. Jika Anda menetapkan Format ke protojson dan TraceID berenkode Base64, tetapkan TraceIDNeedDecode ke true. Jika tidak, transformasi gagal.
SpanIDNeedDecode	Boolean	Tidak			Menentukan apakah akan mendekode SpanID dari Base64. Nilai defaultnya adalah false. Jika Anda menetapkan Format ke protojson dan SpanID berenkode Base64, tetapkan SpanIDNeedDecode ke true. Jika tidak, transformasi gagal.
ParentSpanIDNeedDecode	Boolean	Tidak			Menentukan apakah akan mendekode ParentSpanID dari Base64. Nilai defaultnya adalah false. Jika Anda menetapkan Format ke protojson dan ParentSpanID berenkode Base64, tetapkan ParentSpanIDNeedDecode ke true. Jika tidak, transformasi gagal.

Plugin output

Plugin output SLS

Parameter	Tipe	Wajib	Nilai Default	Contoh	Deskripsi
Type	string	Ya	/	flusher_sls	Tipe plugin. Nilai ini ditetapkan ke flusher_sls.
Logstore	string	Ya	/	test-logstore	Nama Logstore.