Pipelines (Pipeline-ууд) — 7-р хэсэг: функцүүдийн жагсаалт (route_to_stream – years)

← Үндсэн хуудас

Энэ хэсэгт pipeline дүрэмд ашиглах функцүүдийн жагсаалтын үргэлжлэл (route_to_stream-аас years хүртэл) орно. Мөр бүр: функцийн нэр — ангилал; тайлбар; бичих хэлбэр (синтакс).

• route_to_stream — Message Handling; мессежийг өгөгдсөн stream-д онооно. «Хуулах» байдлаар ажиллах тул мессежийг одоогийн stream-ээс хасахгүй. message-ийг заагаагүй бол одоо боловсруулагдаж буй мессежийг ашиглана. Ингэснээр тухайн stream-тэй холбогдсон pipeline-уудад мессеж шалгагдана (хэрэв тэр stream энэ мессежид аль хэдийн боловсруулагдаагүй бол). remove_from_default нь true бол мессежийг үндсэн «All messages» stream-ээс мөн хасна; энэ нь одоогийн pipeline боловсруулалтаа дуусгасны дараа хүчин төгөлдөр болно. Энэ дүрэм pipeline-ийн дараагийн шатуудыг мессежид хэрэглэхээс сэргийлэхгүй. Stream-ийг name эсвэл id-аар нь хайж болно. Жишээг үзнэ үү; route_to_stream(id: string | name: string, [message: Message], [remove_from_default: boolean])
• seconds — Date/Time; value секундийн урттай хугацаа үүсгэнэ. Мөн үзэх: is_period, period; seconds(value: long)
• select_jsonpath — Map; өгөгдсөн paths-ийг json мод дээр үнэлж, гарсан утгуудын map-ийг буцаана. Мөн үзэх: is_json, parse_json; select_jsonpath(json: JsonNode, paths: Map<string, string>)
• set_associated_assets — Asset Enrichment; холбогдох asset-ийн мэдээллийг нэмнэ; set_associated_assets([message]) : Void
• set_field — Message Handling; өгөгдсөн field-д шинэ утга ононо. field-ийн нэр хүчинтэй байх ёстой бөгөөд цэг (.) агуулж болохгүй. Нэрийн эхэн, төгсгөлийн хоосон зайг тайрна; тэмдэгт мөрийн утгын хоосон зайг мөн тайрна. Заавал биш prefix, suffix параметрүүд нэмэгдэх талбарын нэрийн өмнөх, хойно залгах хэсгийг заана. Заавал биш clean_field параметр нь талбарын нэрэнд хүчингүй тэмдэгт байвал доогуур зураасаар сольно. message-ийг заагаагүй бол одоо боловсруулагдаж буй мессежийг ашиглана. Утга байхгүй (null эсвэл алдаа гарсан) үед default-ыг ашиглана. Мөн үзэх: set_fields; set_field(field: string, value: any, [prefix: string], [suffix: string], [message: Message], [default: any, [clean_field: boolean])
• set_fields — Message Handling; өгөгдсөн мессежийн field дотор бүх нэр-утгын хосыг ононо. Энэ нь set_field-тэй адил ажилладаг хялбар функц юм. select_jsonpath, regex зэрэг функцийн үр дүнг, ялангуяа түлхүүрийн нэр нь регуляр илэрхийллийн үр дүн байх үед, боловсруулж буй мессежид оноход тустай. Заавал биш prefix, suffix параметрүүд нэмэгдэх талбарын нэрийн өмнөх, хойно залгах хэсгийг заана. Заавал биш clean_fields параметр нь талбарын нэрэнд хүчингүй тэмдэгт байвал доогуур зураасаар сольно. message-ийг заагаагүй бол одоо боловсруулагдаж буй мессежийг ашиглана. Мөн үзэх: set_field, to_map, grok, key_value; set_fields(fields: Map<string, any>, [prefix: string], [suffix: string], [message: Message], [clean_fields: boolean)
• sha1 — Encoding; value-ийн арван зургаатын (hex) кодчилсон SHA1 дайджестыг үүсгэнэ; sha1(value: string)
• sha256 — Encoding; value-ийн арван зургаатын (hex) кодчилсон SHA256 дайджестыг үүсгэнэ; sha256(value: string)
• sha512 — Encoding; value-ийн арван зургаатын (hex) кодчилсон SHA512 дайджестыг үүсгэнэ; sha512(value: string)
• spamhaus_lookup_ip — Lookup; IP хаягийг Spamhaus DROP болон EDROP жагсаалттай тулгана; spamhaus_lookup_ip(ip_address) : GenericLookupResult
• split — String; тэмдэгт мөрийг өгөгдсөн загвартай таарсан хэсгүүдээр нь хуваана. Java синтакс ашиглана; split(pattern: string, value: string, [limit: int])
• starts_with — String; value нь prefix-ээр эхэлж байгаа эсэхийг шалгана (хүсвэл том, жижиг үсгийг үл хамаарна). Жишээг үзнэ үү; starts_with(value: string, prefix: string, [ignore_case: boolean])
• string_array_add — String; өгөгдсөн тэмдэгт мөр (эсвэл тэмдэгт мөрийн массив) value-г өгөгдсөн тэмдэгт мөрийн массивт нэмнэ. Оролтын массив болон утга/утгын массивыг тэмдэгт мөр болгон хөрвүүлнэ. Жишээг үзнэ үү; string_array_add(elements, value, [only_unique]) : list
• string_entropy — String; өгөгдсөн тэмдэгт мөрийн тэмдэгтүүдийн тархалтын Шэннон энтропийг тооцоолно; string_entropy (value: string, [default: double])
• substring — String; value-ийн start байрлалаас (0-ээс эхэлсэн индекс) эхлээд, хүсвэл end байрлал хүртэлх хэсгийг буцаана. Хоёр байрлал сөрөг байж болох бөгөөд value-ийн төгсгөлөөс тоолно гэсэн үг. Жишээг үзнэ үү; substring(value: string, start: long, [end: long])
• swapcase — String; String-ийн том болон гарчгийн үсгийг жижиг, жижиг үсгийг том болгон солино; swapcase(value: string)
• syslog_facility — Conversion; value дахь syslog facility дугаарыг тэмдэгт мөр хэлбэрт хөрвүүлнэ; syslog_facility(value: any)
• syslog_level — Conversion; value дахь syslog severity дугаарыг тэмдэгт мөр хэлбэрт хөрвүүлнэ; syslog_level(value: any)
• threat_intel_lookup_domain — Lookup; домэйн нэрийг OTX-ээс бусад идэвхжүүлсэн бүх threat intel эх сурвалжтай тулгана; threat_intel_lookup_domain(domain_name, prefix) : GlobalLookupResult
• threat_intel_lookup_ip — Lookup; IP хаягийг OTX-ээс бусад идэвхжүүлсэн бүх threat intel эх сурвалжтай тулгана; threat_intel_lookup_ip(ip_address, prefix) : GlobalLookupResult
• to_bool — Conversion; нэг параметрийг түүний тэмдэгт мөр утгаар нь Boolean утга болгон хөрвүүлнэ; to_bool(value: any)
• to_date — Conversion; value-г огноо болгон хөрвүүлнэ. Цагийн бүс (timezone) өгөөгүй бол UTC гэж үзнэ. Мөн үзэх: is_date; to_date(value: any, [timezone: string])
• to_double — Conversion; эхний параметрийг давхар нарийвчлалтай (double) бутархай тоо болгон хөрвүүлнэ; to_double(value: any, [default: double])
• to_ip — Conversion; өгөгдсөн ip тэмдэгт мөрийг IpAddress объект болгон хөрвүүлнэ. Мөн үзэх: cidr_match; to_ip(ip: string)
• to_long — Conversion; эхний параметрийг урт бүхэл (long) тоо болгон хөрвүүлнэ; to_long(value: any, [default: long])
• to_map — Conversion; map-тэй төстэй утгыг хүчинтэй map болгон хөрвүүлнэ. to_map функц одоогоор зөвхөн задалсан JSON модыг map болгон хөрвүүлж, set_fields-тэй хамт ашиглах боломжийг олгоно. Мөн үзэх: set_fields, parse_json; Жишээг үзнэ үү; to_map(value: any)
• to_string — Conversion; эхний параметрийг тэмдэгт мөр хэлбэрт хөрвүүлнэ; to_string(value: any, [default: string])
• to_url — Conversion; өгөгдсөн url-ийг хүчинтэй URL болгон хөрвүүлнэ; to_url(url: any, [default: string])
• tor_lookup — Lookup; IP хаягийг мэдэгдэж буй Tor гарцын зангилаатай (exit node) тулгаж, Tor сүлжээнээс ирсэн холболтыг илрүүлнэ; tor_lookup(ip_address) : GenericLookupResult
• traffic_accounting_size — Message Handling; бүх нэмэлт талбарыг оролцуулсан мессежийн нийт хэмжээг тооцоолно. Мессеж лицензийн хэрэглээнд хэр тооцогдохыг тодорхойлох утга нь мөн энэ юм. Жишээг үзнэ үү; traffic_accounting_size [(message)]: long
• uncapitalize — String; тэмдэгт мөрийн эхний үсгийг жижиг болгоно; uncapitalize(value: string)
• uppercase — String; тэмдэгт мөрийг том үсэг болгоно. Хэлний код (IETF BCP 47 language tag) өгөөгүй бол en гэж үзнэ; uppercase(value: string, [locale: string])
• urldecode — String; application/x-www-form-urlencoded тэмдэгт мөрийг заасан кодчиллын схемээр тайлна; url decode (value:string, [charset:string])
• urlencode — String; тэмдэгт мөрийг заасан кодчиллын схемээр application/x-www-form-urlencoded хэлбэрт хөрвүүлнэ. Хүчинтэй charset нь жишээ нь UTF-8, US-ASCII гэх мэт. Анхдагч нь UTF-8; url encode (value, [charset])
• user_asset_lookup — Asset Enrichment; нэг хэрэглэгчийн asset-ийг хайна. Оролтын параметртэй хэд хэдэн asset таарвал зөвхөн нэгийг буцаана; user_asset_lookup(lookup_type, value) : Map
• watchlist_add — Watchlist; төрлөөр нь заасан watchlist-д утга нэмнэ. Амжилттай бол true, амжилтгүй бол false буцаана; watchlist буруу тохируулагдсан бол алдаа (exception) үүсгэнэ; watchlist_add(type, value) : Boolean
• watchlist_contains — Watchlist; төрлөөр нь заасан watchlist-ээс утгыг хайна. Амжилттай бол true, амжилтгүй бол false буцаана; watchlist буруу тохируулагдсан бол алдаа (exception) үүсгэнэ; watchlist_contains(type, value) : Boolean
• watchlist_remove — Watchlist; төрлөөр нь заасан watchlist-ээс утгыг хасна. Амжилттай бол true, амжилтгүй бол false буцаана; watchlist буруу тохируулагдсан бол алдаа (exception) үүсгэнэ; watchlist_remove(type, value) : Boolean
• weeks — Date/Time; value долоо хоногийн урттай хугацаа үүсгэнэ. Мөн үзэх: is_period, period; weeks(value: long)
• whois_lookup_ip — Lookup; IP хаягийн WHOIS мэдээллийг авна; whois_lookup_ip(ip_address, prefix) : WhoisIpLookupResult
• years — Date/Time; value жилийн урттай хугацаа үүсгэнэ. Мөн үзэх: is_period, period; years(value: long)