로그 필터링
Query and filter your structured logs using a custom query language with operators and boolean expressions.
읽는 시간 1분최근 업데이트: 7달 전
로깅 서비스는 구조화된 로그를 쉽게 필터링할 수 있도록 커스텀 쿼리 언어를 지원합니다. 이 섹션에서는 쿼리 언어의 구문과 사용법을 안내하고, 시작에 도움이 되는 몇 가지 예시를 제공합니다.
기본 구문 및 연산자
필터 쿼리는 하나 이상의 조건으로 구성됩니다. 조건의 기본 구문은 다음 요소로 구성됩니다.구성 요소 | 조건 |
|---|---|
| Field | 필터링할 필드(예: |
| Operator | 지원되는 연산자 중 하나입니다. 아래의 연산자 표를 참고하십시오. |
| Value | 해당 필드와 비교할 값입니다. |
연산자 | 의미 |
|---|---|
| 같음 |
| 같지 않음 |
| 포함( |
| 포함하지 않음( |
| 초과 |
| 미만 |
| 이하 |
| 이상 |
부울 표현식 및 그룹화
부울 표현식을 사용하고 괄호로 그룹화하여 복잡한 필터 쿼리를 만들 수 있습니다. 이렇게 하면 여러 조건을 조합하여 정확한 필터를 생성할 수 있습니다.부울 표현식 | 의미 |
|---|---|
| 양쪽의 조건이 모두 참이어야 합니다. |
| 양쪽의 조건 중 하나 이상이 참이어야 합니다. |
| 그룹화 | 괄호 ‘(’, ‘)’를 사용하여 표현식을 그룹화하여 평가 순서를 제어할 수 있습니다. |
AND필터 쿼리 예시
특정 심각도 레벨의 모든 로그를 선택합니다.Cloud Code에서 특정 심각도 레벨을 초과하는 모든 로그를 선택합니다. 줄바꿈은 AND로 취급됩니다.severityText = "ERROR"
메시지에 특정 단어가 포함된 로그를 제외합니다.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")
참고
다음은 필터 쿼리 언어에 해당하는 참고 사항입니다.- 필드는 편의상
severityText로 앨리어스가 지정됩니다.severity - 퍼지 일치 연산자(
=, !=)는필드에만 지원됩니다.body - 키는 대소문자를 구분합니다.
logAttributes - 값은 문자열로 자동 전환됩니다.
logAttributes