쿼리 | 로그프레소 소나 사용자 인터페이스 설명서

쿼리

개요

분석 > 쿼리 메뉴에서는 로그프레소 쿼리문을 직접 작성하고 실행해 데이터를 조회하거나 분석할 수 있습니다. 쿼리 문법과 명령어 자체에 대한 자세한 내용은 로그프레소 쿼리 설명서를 참고하세요.

현재 v5 쿼리 화면은 좌측 테이블 선택 영역과 우측 탭 기반 작업 영역으로 나뉩니다. 테이블을 먼저 선택해 쿼리 작성의 출발점을 잡을 수도 있고, 최근 실행한 쿼리를 다시 불러와 같은 분석을 반복할 수도 있습니다.

쿼리 메뉴는 보안관제 실무에서 다음과 같은 목적에 자주 사용됩니다.

원본 로그나 정규화된 데이터를 직접 검색할 때
탐지 규칙이나 피벗 분석 전에 쿼리를 먼저 검증할 때
저장된 쿼리 결과나 데이터셋을 다시 불러와 후속 분석을 이어갈 때

화면 구성

쿼리 화면은 크게 좌측 테이블 트리와 우측 탭 작업 영역으로 구성됩니다.

테이블 트리

좌측 패널에는 테이블 그룹과 테이블 트리가 표시됩니다.

트리에서 테이블을 하나 이상 선택할 수 있습니다.
상단의 테이블 입력 버튼을 누르면 현재 선택한 테이블이 쿼리 작성에 반영됩니다.
사이드바 접기 버튼으로 좌측 패널을 접었다가 다시 펼칠 수 있습니다.

쿼리 탭

우측 상단에는 탭 네비게이션이 표시됩니다.

기본 탭 외에 새 탭을 추가해 여러 쿼리를 동시에 작업할 수 있습니다.
각 탭은 독립적으로 실행 상태와 결과를 유지합니다.
탭 우측 닫기 버튼으로 개별 탭을 닫을 수 있습니다.

쿼리 입력기와 실행 영역

현재 선택된 탭에서는 상단에 쿼리 입력기가, 하단에는 결과 영역이 표시됩니다.

실행: 현재 입력한 쿼리를 실행합니다.
취소: 실행 중인 쿼리를 중단합니다.
초기화: 수정한 쿼리문을 되돌립니다.
쿼리 수행 정보 보기: 실행 시간과 단계별 상태 패널을 열거나 닫습니다.

Note

쿼리 탭은 다른 메뉴로 이동했다가 다시 돌아와도 유지될 수 있습니다. 실행 중이던 쿼리도 같은 탭 문맥에서 이어집니다.

쿼리문 입력

쿼리 입력창에서는 여러 줄 쿼리 편집과 실행 단축키를 지원합니다.

파이프(|)를 기준으로 명령어를 연결해 쿼리를 작성합니다.
입력창은 길이에 따라 여러 줄로 확장됩니다.
#으로 시작하는 줄은 주석으로 처리됩니다.
Shift + Enter 또는 Ctrl + Enter로 쿼리를 실행할 수 있습니다.
자동 줄 바꿈 기능을 사용하면 긴 쿼리를 보기 쉽게 정리할 수 있습니다.

자동 완성

쿼리 입력창은 명령어와 옵션 자동 완성을 지원합니다.

자동 완성 목록은 다음 단축키로 열 수 있습니다.
- 공통: Ctrl + Space
- Windows: Ctrl + Shift + Space (대안)
- macOS: Cmd + Space (대안)
입력한 접두어와 일치하는 명령어나 옵션이 하나뿐이면 바로 자동 입력될 수 있습니다.

Note

macOS의 Cmd + Space는 기본적으로 Spotlight 검색에 할당되어 있어 자동 완성 단축키와 충돌합니다. 로그프레소 소나의 단축키는 변경할 수 없으므로, 시스템 설정 → 키보드 → 키보드 단축키 → Spotlight에서 Spotlight 단축키를 다른 키로 바꾸세요. 또는 충돌을 피하려면 Ctrl + Space를 사용하세요.