Documentation
Table of Contents
Корелациони објекат
Следећи објекти су директно повезани са correlation API-јем.
Корелација
Објекат корелације има следећа својства.
| Property | Type | Description |
|---|---|---|
| correlationid | ID | ID корелације. Property behavior: - само за читање - обавезно за операције ажурирања |
| name | string | Назив корелације. Property behavior: - потребно за операције креирања |
| name | string | Опис корелације. |
| status | integer | Да ли је корелација омогућена или онемогућена. Могуће вредности: 0 - (подразумевано) омогућено; 1 - онемогућено. |
Корелационe операције
Објекат операције корелације дефинише операцију која ће се извршити када се изврши корелација. Има следећа својства.
| Property | Type | Description |
|---|---|---|
| type | integer | Тип операције. Могуће вредности: 0 - затвори старе догађаје; 1 - затвори нови догађај. Property behavior: - обавезно |
Филтер корелације
Објекат корелационог филтера дефинише скуп услова који морају бити испуњени да би се извршиле конфигурисане корелационе операције. Има следећа својства.
| Property | Type | Description |
|---|---|---|
| conditions | array | Скуп filter conditions који се користи за филтрирање резултата. Услови ће бити сортирани по редоследу њиховог постављања у формулу. Property behavior: - обавезно |
| evaltype | integer | Метод евалуације филтера услова. Могуће вредности: 0 - и/или; 1 - и; 2 - или; 3 - прилагођени израз. Property behavior: - обавезно |
| eval_formula | string | Генерисани израз који ће се користити за процену услова филтера. Израз садржи ID-ијеве који реферишу на специфичне услове филтера преко formulaidособине. Вредност eval_formula је једнака вредности formula за филтере са прилагођеним изразом.Property behavior: - * само за читање* |
| formula | string | Кориснички дефинисан израз који се користити за процену услова филтера са прилагођеним изразом. Израз мора садржати ID-ијеве који реферишу на специфичне услове филтера преко formulaid. ID-ијеви који се користе у изразу морају тачно да одговарају онима дефинисаним у условима филтера: ниједан услов не може остати неискоришћен или изостављен.Property behavior: - обавезно ако је evaltype подешен на "прилагођени израз" |
Услов филтера корелације
Објекат услова корелационог филтера дефинише одређени услов који мора бити проверен пре покретања корелационих операција.
| Property | Type | Description |
|---|---|---|
| type | integer | Тип услова. Могуће вредности: 0 – стара ознака догађаја; 1 – нова ознака догађаја; 2 – нова група домаћина догађаја; 3 - пар ознака догађаја; 4 - стара вредност ознаке догађаја; 5 - нова вредност ознаке догађаја. Property behavior: - обавезно |
| tag | string | Ознака догађаја (стара или нова). Property behavior: - обавезно ако је type подешен на "стара ознака догађаја", "нова ознака догађаја", "вредност старе ознаке догађаја" или "вредност нове ознаке догађаја" |
| groupid | ID | ID групе домаћина. Property behavior: - обавезно ако је type подешен на "нова група домаћина догађаја" |
| oldtag | string | Стара ознака догађаја. Property behavior: - обавезно ако је type подешен на "пар ознака догађаја " |
| newtag | string | Стара ознака догађаја. Property behavior: - обавезно ако је type подешен на "пар ознака догађаја " |
| value | string | Вредност ознаке догађаја (стара или нова). Property behavior: - обавезно ако је подешен type на "вредност старе ознаке догађаја" или "вредност нове ознаке догађаја" |
| formulaid | string | Произвољни јединствени ID који се користи за референцирање услова у прилагођеном изразу. Може да садржи само велика слова. ID мора да дефинише корисник када мења услове филтера, али ће бити генерисан изнова када их накнадно захтева. |
| operator | integer | Оператор услова. Property behavior: - обавезно ако је type подешен на "нова група домаћина догађаја ", "стара вредност ознаке догађаја" или "вредност нове ознаке догађаја" |
Да бисте боље разумели како да користите филтере са различитим типовима израза, погледајте примере на correlation.get и correlation.create страницама метода.
Следећи оператори и вредности су подржани за сваки тип услова.
|Condition|Condition name|Supported operators|Expected value| |--------|--------------|-------------------|---- ----------| |2|Host group|=, <>|ID групе домаћина.| |4|Old event tag value|=, <>, like, not like|string| |5|New event tag value|=, <>, like, not like|string|