Decorators (чимэглэгч) гэж юу вэ, хэрхэн тохируулах вэ?

Decorators (чимэглэгч) нь хайлтын үед мессежийн талбарыг автоматаар өөрчилдөг бөгөөд диск дээрх анхны мессежийг өөрчлөхгүй. Decorators нь талбар доторх өгөгдлийг илүү ойлгомжтой болгох, талбарын утгыг нэгтгэх, мессежийн талаар нэмэлт мэдээлэлтэй шинэ талбар нэмэх зэрэгт ялангуяа хэрэгтэй. Decorators нь stream (урсгал) тус бүр дээр тохируулагддаг (default stream-ийг оруулаад) тул нэг мессежийг олон stream-д, олон янзаар харуулах боломжтой.

Decorators-ын хийсэн өөрчлөлт хадгалагддаггүй тул чимэглэсэн утгаар хайх, эсвэл тэдгээрт field analyzers ашиглах боломжгүй. Харин эдгээр боломжийг чимэглээгүй анхны талбар дээр ашиглаж болно.

Decorators нь stream-ийн түвшинд үйлчилдэг бөгөөд тухайн stream-д хандах эрхтэй бүх хэрэглэгч хуваалцдаг. Иймээс бүх хэрэглэгч ижил үр дүнг харж, decorators-ын давуу талыг ашигладаг.

Security Data Lake нь хэд хэдэн decorators-ыг бэлнээр нь агуулдаг. Мөн pipelines-ээс шинээр нэмэх эсвэл plugin болгон өөрөө бичиж болно.

Decorators-ыг System > Configurations хэсгээс тохируулна. Decorators хэсэгт stream-ийг сонговол тухайн stream-тэй холбоотой бүх decorators-ын тойм харагдана.

Stream-д шинэ default decorators нэмэхийн тулд Update товчийг дарна. Нээгдсэн цонхонд stream-ийг тодорхойлох, эсвэл decorator-ын төрлийг тодорхойлох гэсэн хоёр сонголт байна. Decorator үүсгэсний дараа тохиргоог дуусгахын тулд Save дарна.

Нэг хайлтын үр дүнд хэд хэдэн decorators ашиглаж байгаа бол цонхны decorators-ын жагсаалтад чирж буулгах замаар тэдгээрийн ажиллах дарааллыг хүссэн үедээ өөрчилж болно.

Идэвхтэй Decorators-ыг харах

Message table widget нь бүх идэвхтэй decorators-ын тоймыг харуулдаг. Streams хуудаснаас stream сонгож stream хайлтын хуудсыг нээхэд widget урьдчилан тохируулагдсан байх бөгөөд холбогдох хайлтын үр дүнг харуулна. Message table widget-ийг засахад идэвхтэй бүх decorators-ын тойм бүхий цонх нээгдэнэ. Та энд decorators нэмж болох ч эдгээр нь хадгалагдахгүй бөгөөд stream-тэй холбогдохгүй. Тодорхой message table-д зориулж decorator хадгалах бол Dashboards эсвэл Saved Searches дотроо хадгална.

Syslog Severity Mapper

Syslog severity mapper decorator нь syslog мессежийн тоон syslog түвшинг хүн уншихад ойлгомжтой мөр болгон хөрвүүлдэг. Жишээлбэл, лог доторх level талбарт decorator ашигласнаар syslog түвшин 4 нь Warning (4) болно.

Syslog severity mapper decorator ашиглахын тулд дараах мэдээллийг өгнө:

• Source field : Тоон syslog түвшинг агуулсан талбар
• Target field : Хүн уншихад ойлгомжтой мөрийг хадгалах талбар. Хайлтын үр дүн дэх тоон утгыг солих бол source field-тэй ижил талбарыг сонгож болно.

Format String

Format string decorator нь хэд хэдэн талбарыг нэг болгон нэгтгэх энгийн арга юм. Мөн Elasticsearch-д хадгалагдсан үр дүнг өөрчлөхгүйгээр талбарын агуулгыг өөрчлөхөд ашиглаж болно.

Format string decorator ашиглахын тулд дараах мэдээллийг өгнө:

• Format string : Үр дүнгийн мөрийг форматлах загвар. Мессеж доторх талбарыг ${}-д хийж өгнө. Жишээлбэл, ${source} нь source талбарын агуулгыг үр дүнгийн мөрөнд нэмнэ.
• Target field : Үр дүнгийн утгыг хадгалах талбар.
• Require all fields (заавал биш): Бусад бүх талбар байгаа тохиолдолд л мөрийг форматлахыг хүсвэл энэ нүдийг тэмдэглэнэ.

Жишээлбэл, Request to ${controller}#${action} finished in ${took_ms}ms with code ${http_response_code} гэсэн format string нь Request to PostsController#show finished in 57ms with code 200 гэсэн текст үүсгэж, хайлтын үр дүн дэх мессежийн аль нэг талбарт харуулж болно.

Pipeline Decorator

Pipeline decorator нь мессежийг одоо байгаа processing pipeline-аар боловсруулж чимэглэх боломж олгодог. Энгийн processing pipeline-аас ялгаатай нь pipeline-ын мессежид хийсэн өөрчлөлт хадгалагддаггүй. Харин pipeline-ыг хайлтын үед мессежийн харагдах байдлыг өөрчлөхөд ашигладаг.

Pipeline decorator ашиглахын тулд урьдчилан үүсгэсэн pipeline байх шаардлагатай.

Pipeline үүсгэсний дараа хэдэн ч stream дээр ашиглах decorator нэмж болно. Үүсгэх үйл явц нь бусад төрлийн decorator-тай адил:

1. 1System > Configurations хэсэгт очно.
2. 2Decorators Configuration доорх Update дээр дарна.
3. 3Төрлийг (энэ тохиолдолд Pipeline Processor Decorator) сонгоно.
4. 4Түүний хажууд байгаа Apply товчийг дарна.

Pipeline-аа сонгоод Save дарна. Ингэснээр шинэ pipeline decorator бэлэн боллоо.

Нэмэлт боломжууд

Одоо байгаа decorators таны хэрэгцээнд хүрэлцэхгүй бол Security Data Lake marketplace-аас хайх, эсвэл өөрөө decorator бичиж болно.