Deklarasi Alur

Gunakan deklarasi alur untuk menyambungkan sumber (lihat Deklarasi Sumber) ke sink (lihat Deklarasi Sink) di Amazon Kinesis Agent for Microsoft Windows. Sebuah deklarasi alur dinyatakan sebagai objek JSON. Setelah Kinesis Agent for Windows mulai berjalan, log, peristiwa, atau metrik akan dikumpulkan dari sumber untuk alur tertentu. Item-item tersebut kemudian dialirkan ke berbagai layanan AWS menggunakan sink yang dikaitkan dengan alur itu.

Berikut ini adalah contoh deklarasi alur:

{
   "Id": "MyAppLogToCloudWatchLogs", 
   "SourceRef": "MyAppLog", 
   "SinkRef": "MyCloudWatchLogsSink" 
}

Mengonfigurasi Alur

Semua deklarasi alur dapat berisi pasangan kunci-nilai berikut:

Id

Menentukan nama alur (diperlukan). Nama ini harus unik dalam file konfigurasi.

Type

Menentukan tipe transformasi (jika ada) yang diterapkan oleh alur sembari data log ditransfer dari sumber ke sink. Satu-satunya nilai yang didukung adalah RegexFilterPipe. Nilai ini memungkinkan filter ekspresi reguler pada representasi tekstual yang mendasari catatan log. Menggunakan filter dapat mengurangi biaya transmisi dan penyimpanan dengan hanya mengirimkan catatan log yang relevan ke alur data berikutnya. Pasangan kunci-nilai ini opsional. Nilai default ini untuk mengatur agar tidak ada transformasi.

FilterPattern

Menentukan ekspresi reguler untuk alur RegexFilterPipe yang digunakan untuk memfilter catatan log yang dikumpulkan oleh sumber sebelum ditransfer ke sink. Catatan log ditransfer oleh alur tipe RegexFilterPipe ketika ekspresi regulernya cocok dengan representasi tekstual yang mendasari catatan. Catatan log terstruktur yang dihasilkan, misalnya, ketika menggunakan pasangan kunci-nilai ExtractionPattern dalam deklarasi DirectorySource, masih dapat difilter menggunakan mekanisme RegexFilterPipe. Hal ini karena mekanisme ini beroperasi pada representasi tekstual asli sebelum penguraian. Pasangan kunci-nilai ini bersifat opsional, tetapi harus disediakan jika alur menentukan tipe RegexFilterPipe.

Berikut ini adalah contoh deklarasi alur RegexFilterPipe:

{
	"Id": "MyAppLog2ToFirehose",
	"Type": "RegexFilterPipe",
	"SourceRef": "MyAppLog2",
	"SinkRef": "MyFirehose",
	"FilterPattern": "^(10|11),.*",
	"IgnoreCase": false,
	"Negate": false
}

SourceRef

Menentukan nama (nilai pasangan kunci-nilai Id) deklarasi sumber yang mendefinisikan sumber yang mengumpulkan data log, peristiwa, dan metrik untuk alur (diperlukan).

SinkRef

Menentukan nama (nilai pasangan kunci-nilai Id) deklarasi sink yang mendefinisikan sink yang menerima data log, peristiwa, dan metrik untuk alur (diperlukan).

IgnoreCase

Opsional. Setujui nilai true atau false. Ketika diatur ke true, Regex akan mencocokkan catatan dengan memerhatikan huruf besar-kecil.

Negate

Opsional. Setujui nilai true atau false. Ketika diatur ke true, alur akan meneruskan catatan yang tidak cocok dengan ekspresi biasa.

Untuk contoh file konfigurasi lengkap yang menggunakan tipe alur RegexFilterPipe, lihat Menggunakan Alur.

Mengonfigurasi Alur Metrik Kinesis Agent for Windows

Ada sumber metrik bawaan bernama _KinesisTapMetricsSource yang menghasilkan metrik tentang Kinesis Agent for Windows. Jika terdapat deklarasi sink CloudWatch dengan Id MyCloudWatchSink, contoh deklarasi alur berikut mentransfer metrik yang dihasilkan Kinesis Agent for Windows ke sink tersebut:

{
   "Id": "KinesisAgentMetricsToCloudWatch",
   "SourceRef": "_KinesisTapMetricsSource",
   "SinkRef": "MyCloudWatchSink"
}

Untuk informasi selengkapnya tentang sumber metrik bawaan Kinesis Agent for Windows, lihat Sumber Metrik Bawaan Kinesis Agent for Windows.

Jika file konfigurasi juga mengalirkan metrik pengukur performa Windows, kami sarankan Anda menggunakan alur dan sink terpisah alih-alih menggunakan sink yang sama untuk metrik Kinesis Agent for Windows dan metrik pengukur performa Windows.