로그 필터링

Query and filter your structured logs using a custom query language with operators and boolean expressions.

읽는 시간 1분

최근 업데이트: 한 달 전

로깅 서비스는 구조화된 로그를 쉽게 필터링할 수 있도록 커스텀 쿼리 언어를 지원합니다. 이 섹션에서는 쿼리 언어의 구문과 사용법을 안내하고, 시작에 도움이 되는 몇 가지 예시를 제공합니다.

기본 구문 및 연산자

필터 쿼리는 하나 이상의 조건으로 구성됩니다. 조건의 기본 구문은 다음 요소로 구성됩니다.

구성 요소	조건
Field	필터링할 필드(예: `severityText` , `body` , 또는 `logAttributes` )입니다.
Operator	지원되는 연산자 중 하나입니다. 아래의 연산자 표를 참고하십시오.
Value	해당 필드와 비교할 값입니다.

아래 표에서 지원되는 연산자의 목록을 참고하십시오.

부울 표현식을 사용하고 괄호로 그룹화하여 복잡한 필터 쿼리를 만들 수 있습니다. 이렇게 하면 여러 조건을 조합하여 정확한 필터를 생성할 수 있습니다.

부울 표현식	의미
`AND` 또는 `&&`	양쪽의 조건이 모두 참이어야 합니다.
`OR` 또는 `\|\|`	양쪽의 조건 중 하나 이상이 참이어야 합니다.
그룹화	괄호 ‘(’, ‘)’를 사용하여 표현식을 그룹화하여 평가 순서를 제어할 수 있습니다.

쿼리 작성을 간소화하기 위해 라인 피드도

AND

부울로 변환됩니다. 즉, 모든 조건이 일치하기를 원한다면 한 줄에 조건을 하나씩 작성하면 됩니다.

특정 심각도 레벨의 모든 로그를 선택합니다.


severityText = "ERROR"

Cloud Code에서 특정 심각도 레벨을 초과하는 모든 로그를 선택합니다. 줄바꿈은 AND로 취급됩니다.


resourceAttributes.service.name = "cloud-code"severityNumber >= 12

메시지에 특정 단어가 포함된 로그를 제외합니다.


body !~= "healthcheck"

심각도 앨리어스를 사용하여 여러 조건과 그룹화를 조합합니다.


(logAttributes.event.name = "example-event" AND body ~= "timeout") OR (logAttributes.custom.counter > 9000 AND severity = "WARN")

다음은 필터 쿼리 언어에 해당하는 참고 사항입니다.