로그 필터 설정

로그 필터 설정은 사용자가 지정한 필터 조건에 해당하는 로그만 저장하는 기능입니다. 사용자가 필요한 로그만 저장하여 비용을 절감할 수 있습니다.

노트

권한

로그 편집 권한이 있는 사용자만 설정할 수 있습니다.

로그 필터 설정 추가하기

새로운 필터 설정을 추가하는 방법입니다. 로그 필터 설정 시 필터 이름, 라이브 테일 표시 여부, 카테고리, 필터 조건은 필수 입력 항목입니다.

로그 필터 설정에서 저장하지 않는 로그도 라이브 테일 표시 여부 토글을 활성화하면 라이브 테일에서 확인할 수 있습니다.

주의

카테고리별로 하나의 필터만 설정할 수 있습니다.

1. 로그 > 로그 설정 > 로그 필터 설정 탭으로 이동하세요.

2. 로그 필터 설정을 위해 + 추가하기 버튼을 클릭하세요.

3. 로그 필터 설정 추가에서 필터 이름, 라이브 테일 표시 여부, 카테고리, 필터 조건을 입력하세요.

   • 필터 이름: 필터를 식별할 수 있는 이름

   • 라이브 테일 표시 여부: 저장 여부와 관계없이 라이브 테일에 표시 여부 선택

   • 카테고리: 필터가 적용될 로그 카테고리 (복수 선택 가능)

   • 필터 조건: 필터 조건에 저장할 로그의 조건

   노트

   필터 조건 설정 시, 자세한 내용은 WhaTap log search query 문법를 참고하세요.

   • 예시
     • 포함: oid : 123
       • oid가 123인 로그만 수집합니다.
     • 불포함: not oid : 123
       • oid가 123이 아닌 로그만 수집합니다.
     • 전체 포함: 필터 조건 미입력
     • 전체 불포함: not content : *

4. 추가 버튼을 클릭하면 등록 결과 미리보기에서 각 필터 설정을 확인하고 수정할 수 있습니다.

5. 확인이 완료되었다면 적용 버튼을 클릭해 로그 필터 설정을 적용합니다.

시뮬레이션

사용자가 입력한 카테고리와 필터 조건으로 로그를 미리 검색하여, 로그 필터 설정을 적용하기 전에 결과를 확인할 수 있습니다.

시뮬레이션 버튼을 클릭하면 로그 필터 설정이 적용된 로그 검색 화면이 나타납니다.

로그 필터 설정 수정하기

등록한 로그 필터는 필요에 따라 수정 아이콘을 클릭해 수정할 수 있습니다. 로그 필터 설정 수정에서 기존에 입력한 값이 표시되며, 원하는 항목을 변경한 뒤 적용하면 됩니다.

주의

로그 필터 설정을 수정할 때, 하나의 카테고리만 선택할 수 있습니다.

로그 필터 설정 삭제하기

등록한 필터는 삭제 아이콘을 클릭해 삭제할 수 있습니다. 삭제 후 반드시 저장 버튼을 클릭하세요.

주의

변경 사항을 저장하지 않으면 필터가 삭제되지 않습니다.

로그 필터 설정 JSON 가져오기/내보내기

로그 필터 설정은 JSON 형식으로 Import/Export 할 수 있습니다. 다른 프로젝트로 동일한 로그 필터 설정을 쉽게 적용할 수 있습니다. 다른 프로젝트로 로그 필터 설정 내용을 그대로 옮기고 싶은 경우 유용하게 사용할 수 있습니다.

JSON 내보내기

1. 화면 오른쪽 위의 버튼을 클릭하세요.

2. JSON 내보내기 창이 열리면, 내보내기 버튼을 클릭하세요.

3. 로그 필터 설정 내용이 JSON 형식의 파일로 다운로드됩니다.

JSON 가져오기

1. 화면 오른쪽 위의 버튼을 클릭하세요.

2. 가져올 JSON 형식의 파일을 선택하세요.

3. JSON 가져오기 창에서 목록에 추가하기 또는 덮어쓰기 버튼을 클릭해 로그 필터 설정을 가져옵니다.

4. 저장 버튼을 클릭해 변경 사항을 반영합니다.

유효성 검사 조건

설정 내용 저장 시 유효성 검사 내용은 다음과 같습니다.

• type: GENERAL만 지원

• category: 필수값으로 string 타입 지원

• condition

  • language: jsonDsl, lucene만 지원
  • description: 유효하지 않은 필터 조건이면 저장 불가

• showLiveTail: boolean 타입만 지원

• name: 필수값으로 string 타입 지원