Іздеу сұрауларының тілі

Іздеу сұрауларының тілі мыналарға мүмкіндік береді:

бір немесе бірнеше сүзгілеу өрнегі бойынша іздеу жасауға;
логикалық операциялар мен салыстыру операцияларын қолдануға.

Логтарды сүзгілеу үшін іздеу жолағындағы сүзгі параметрлерін пайдаланыңыз.

Параметр	Сипаттама
`event_id`	Оқиғаның бірегей идентификаторы
`timestamp`	Оқиғаның пайда болу уақыты, RFC3339. Мысал: 2006-01-02T15:04:05Z07:00
`action`	Оқиға түрі
`request_id`	Сұрау идентификаторы, Cloud Logging-пен байланыстыру үшін қолданылады
`severity`	Оқиғаның маңыздылық деңгейі. Қолжетімді мәндер: `DEFAULT`,`DEBUG`, `INFO`, `NOTICE`, `WARNING`, `ERROR`, `CRITICAL`, `ALERT`, `EMERGENCY`
`message`	Адамға түсінікті оқиға сипаттамасы
`source.id`	Оқиға көзінің идентификаторы
`source.address`	Оқиға көзінің IP мекенжайы
`subject.user_id`	Субъектінің идентификаторы — әрекеттерімен оқиға байланыстырылған пайдаланушы
`subject.address`	Пайдаланушының IP мекенжайы
`subject.project_id`	OpenStack-тағы жоба идентификаторы
`subject.metadata`	Пайдаланушыны анықтайтын қосымша метадеректер. Мысалы: `subject.metadata.email` — пайдаланушының поштасы
`resource.id`	OpenStack-тағы ресурс идентификаторы немесе соған ұқсас
`resource.type`	Ресурс түрі
`resource.metadata`	Ресурсты анықтайтын қосымша метадеректер. Мысалы: `resource.metadata.service_id` — сервис атауы (`DBaaS`); `resource.metadata.group_id` — қосалқы сервис атауы (`Redis`); `resource.metadata.stream_id` — ресурс орналасқан объектінің атауы (`DB_id`)
`status.code`	Операцияны орындау күйінің коды. Мысалы, HTTP коды немесе gRPC коды
`status.message`	Операцияны орындау күйінің сипаттамасы
`labels`	Оқиғаларды іздеуге болатын белгілер

Параметр

Сипаттама

event_id

Оқиғаның бірегей идентификаторы

timestamp

Оқиғаның пайда болу уақыты, RFC3339.

Мысал: 2006-01-02T15:04:05Z07:00

action

Оқиға түрі

request_id

Сұрау идентификаторы, Cloud Logging-пен байланыстыру үшін қолданылады

severity

Оқиғаның маңыздылық деңгейі. Қолжетімді мәндер: DEFAULT,DEBUG, INFO, NOTICE, WARNING, ERROR, CRITICAL, ALERT, EMERGENCY

message

Адамға түсінікті оқиға сипаттамасы

source.id

Оқиға көзінің идентификаторы

source.address

Оқиға көзінің IP мекенжайы

subject.user_id

Субъектінің идентификаторы — әрекеттерімен оқиға байланыстырылған пайдаланушы

subject.address

Пайдаланушының IP мекенжайы

subject.project_id

OpenStack-тағы жоба идентификаторы

subject.metadata

Пайдаланушыны анықтайтын қосымша метадеректер.

Мысалы: subject.metadata.email — пайдаланушының поштасы

resource.id

OpenStack-тағы ресурс идентификаторы немесе соған ұқсас

resource.type

Ресурс түрі

resource.metadata

Ресурсты анықтайтын қосымша метадеректер.

Мысалы:

resource.metadata.service_id — сервис атауы (DBaaS);
resource.metadata.group_id — қосалқы сервис атауы (Redis);
resource.metadata.stream_id — ресурс орналасқан объектінің атауы (DB_id)

status.code

Операцияны орындау күйінің коды.

Мысалы, HTTP коды немесе gRPC коды

status.message

Операцияны орындау күйінің сипаттамасы

labels

Оқиғаларды іздеуге болатын белгілер

Журналдағы жазбалар тізімін сүзгілеу үшін іздеу жолағында <ИМЯ_ПАРАМЕТРА>/<ЗНАЧЕНИЕ_ПАРАМЕТРА> жұптарын пайдаланыңыз.

Іздеу ерекшеліктері

Іздеу жолындағы ", ' және ＼ таңбалары ＼ көмегімен экрандалады.
Мәнді тырнақшаға алмауға болады, егер ол:
- латын әліпбиінің әрпінен басталып, тек латын әліпбиінің әріптерін, цифрларды және астын сызу таңбаларын қамтыса;
- таңбасыз бүтін сан болса.
Уақыт мәндерінің пішімі: RFC3339.
Ендірілген объектілердегі барлық мәндер жолдар ретінде қарастырылады және лексикографиялық тәртіппен салыстырылады.
:, =, <> операторларының көмегімен массив-параметрлер бойынша іздеу қолдау көрсетіледі.

Салыстыру операторлары

Оператор	Сипаттама	Мысал
`=`	Тең	`message="ИСКОМЫЙ_ТЕКСТ"`
`<>`	Тең емес	`message<>"ИСКОМЫЙ_ТЕКСТ"`
`>`	Артық	`severity > DEBUG`
`<`	Аз	`severity < DEBUG`
`>=`	Артық немесе тең	`timestamp >= "2023-04-10T10:20:00Z"`
`<=`	Аз немесе тең	`timestamp <= "2023-04-10T10:20:00Z"`
`:`	Қамтиды	`message: "ИСКОМЫЙ_ТЕКСТ"`

Оператор

Сипаттама

Мысал

=

Тең

message="ИСКОМЫЙ_ТЕКСТ"

<>

Тең емес

message<>"ИСКОМЫЙ_ТЕКСТ"

>

Артық

severity > DEBUG

<

Аз

severity < DEBUG

>=

Артық немесе тең

timestamp >= "2023-04-10T10:20:00Z"

<=

Аз немесе тең

timestamp <= "2023-04-10T10:20:00Z"

:

Қамтиды

message: "ИСКОМЫЙ_ТЕКСТ"

Логикалық операторлар

Бір сүзгіде бірнеше шартты логикалық операторлардың көмегімен біріктіруге болады.

Оператор	Сипаттама	Мысал
`AND`	Барлық шарттарды қанағаттандырады	`service_id=databases AND severity=ERROR`
`OR`	Кемінде бір шартты қанағаттандырады	`severity=ERROR OR status.code=500`
`NOT`	Осы шартты қанағаттандырмайды	`NOT message: hello`
`EXIST`	Жазба осы параметрді қамтиды	`subject.metadata.email EXIST`

Оператор

Сипаттама

Мысал

AND

Барлық шарттарды қанағаттандырады

service_id=databases AND severity=ERROR

OR

Кемінде бір шартты қанағаттандырады

severity=ERROR OR status.code=500

NOT

Осы шартты қанағаттандырмайды

NOT message: hello

EXIST

Жазба осы параметрді қамтиды

subject.metadata.email EXIST

Есептеу тәртібі

Белгілі бір есептеу тәртібін беру үшін жақшаларды пайдаланыңыз, мысалы:


ПАРАМЕТР_1: "ЗНАЧЕНИЕ_1" AND (ПАРАМЕТР_2 = "ЗНАЧЕНИЕ_2" OR ПАРАМЕТР_3 "ЗНАЧЕНИЕ_3")

Бұл мысалда ПАРАМЕТР_1 параметрі "ЗНАЧЕНИЕ_1" ішкіжолын қамтитын және екі шарттың кемінде бірі орындалатын жазбалар табылады:

ПАРАМЕТР_2 параметрінің мәні "ЗНАЧЕНИЕ_2" мәніне тең.
ПАРАМЕТР_3 параметрінің мәні лексикографиялық мағынада "ЗНАЧЕНИЕ_3" мәнінен кіші.

Өрнек мысалдары

Өрнек	Іздеу нәтижесі
`source.id=iam AND (subject.address="127.0.0.1" OR status.code=500)`	`127.0.0.1` IP мекенжайы бар пайдаланушымен болған немесе 500 қате кодын тудырған IAM сервисінің барлық оқиғалары
`severity=CRITICAL AND subject.metadata.email: "@example.ru"`	`example.ru` пошта домені бар пайдаланушыларда болған барлық сыни оқиғалар
`timestamp > "2023-06-02T15:04:05Z03:00" AND source.address="127.0.0.1" AND resource.metadata.stream_id="2278584446"`	`127.0.0.1` IP мекенжайы бойынша `2278584446` атауы бар объектіде 2023 жылғы 2 маусымда 15:04:05-тен кейін болған барлық оқиғалар. Уақыт UTC+3 уақыт белдеуі үшін көрсетілген

Өрнек

Іздеу нәтижесі

source.id=iam AND (subject.address="127.0.0.1" OR status.code=500)

127.0.0.1 IP мекенжайы бар пайдаланушымен болған немесе 500 қате кодын тудырған IAM сервисінің барлық оқиғалары

severity=CRITICAL AND subject.metadata.email: "@example.ru"

example.ru пошта домені бар пайдаланушыларда болған барлық сыни оқиғалар

timestamp > "2023-06-02T15:04:05Z03:00" AND source.address="127.0.0.1" AND resource.metadata.stream_id="2278584446"

127.0.0.1 IP мекенжайы бойынша 2278584446 атауы бар объектіде 2023 жылғы 2 маусымда 15:04:05-тен кейін болған барлық оқиғалар. Уақыт UTC+3 уақыт белдеуі үшін көрсетілген

Іздеу сұрауларының тілі

Іздеу ерекшеліктері

Салыстыру операторлары

Логикалық операторлар

Есептеу тәртібі

Өрнек мысалдары

Мақала пайдалы болды ма?

Мақала пайдалы болды ма?