검색

Prev Next

Classic/VPC 환경에서 이용 가능합니다.

검색에서는 데이터 소스(프로젝트 또는 그룹)에 대한 시간대별 로그 수집 개수를 그래프와 상세 로그를 확인하고 루씬 쿼리로 로그를 검색하는 방법을 안내합니다.

검색 화면

Web App의 검색 메뉴의 기본적인 설명은 다음과 같습니다.
elsa2-search_screen_ko

영역 설명
① 데이터 소스 프로젝트 또는 그룹 검색 및 선택
  • 그룹은 1개만 선택 가능
  • 프로젝트는 30개까지 선택 가능
  • 프로젝트와 그룹은 동시 선택 불가
  • 여러 프로젝트를 검색하려면 그룹을 설정(권장)
② 상태 로그 레벨(logLevel) 필드의 집계 확인
③ 집계 임의의 로그 필드에 대한 집계 확인
  • 임의의 필드 10개까지 추가 집계 가능
  • i-elsa2-edit: 신규 집계 추가, 수정 및 재설정 가능
④ 검색 기간 설정 로그를 검색할 시간 범위 설정
  • 캘린더로 직접 기간을 설정하거나 More 클릭해 예제에서 설정 가능
  • 이전/자동갱신/다음 시간 이동: 좌우 화살표를 클릭하면 현재 설정된 기간 이전 또는 다음 시간으로 이동. 자동 갱신 버튼을 클릭하면 주기적으로 새로 고침하여 로그를 갱신
⑤ 알람 불러오기 미리 설정된 알람 항목(쿼리)으로 로그 검색(알람 관리 참고)
⑥ 저장된 검색 불러오기 미리 저장된 쿼리 항목으로 로그 검색(쿼리 관리 참고)
⑦ 검색창 루씬 쿼리를 입력하여 로그를 검색(Apache Lucene 참고)
  • i-elsa2-save: 검색창에 입력한 쿼리를 알람 또는 쿼리로 저장. 단, 알람은 데이터 소스가 단일 프로젝트일 때만 가능.
⑧ 로그 상태 차트 로그 검색 결과의 시간별 로그 레벨 집계를 차트로 표시
  • 차트 표시 시간 간격을 선택하거나 차트 감추기/보이기 가능
  • 차트의 특정 영역을 마우스로 드래그하여 시간 범위 재설정 가능
⑨ 로그 목록 검색된 로그의 내용이 목록으로 표시
  • 로그를 클릭하면 상세 보기 가능
    • 필드명에 마우스 포인터를 올렸을 때 표시되는 [집계 추가] 또는 [열 추가] 버튼 클릭해 해당 필드를 집계 또는 컬럼에 추가 가능
    • 로그 텍스트에 마우스 포인터를 올렸을 때 표시되는 영역으로 로그 텍스트가 부분 일치 또는 완전 일치하는 필드 검색 가능. 필드와 완전 일치하는 경우에는 마우스 포인터를 로그 텍스트에 올렸을 때 정확히 일치라는 툴팁이 표시됨
    • 로그 텍스트가 완전히 일치하는 필드만 검색하려면 마우스 포인터를 올렸을 때 표시되는 정확히 일치 툴팁을 클릭
  • i-elsa2-context_search(컨텍스트 검색): 해당 로그를 발생시킨 호스트에서의 이전/이후 로그 검색
    • [± 1 분]/[± 5 분]/[± 10 분] 버튼: 해당 로그 발생 전후로 선택한 시간 범위의 로그 표시
  • 첫 번째 컬럼의 사각형은 로그 레벨을 색상별로 나타낸 것이며, 사각형 내부에 벌레 모양의 아이콘이 있는 경우 해당 로그는 크래시 덤프 데이터를 포함하고 있음을 의미. 색상별 로그 레벨은 상태 또는 차트 영역에서 확인 가능
  • 모두 펼치기: 모든 로그 내용을 펼친 상태로 표시
  • 모두 접기: 모든 로그 내용을 접은 상태로 표시
  • 다운로드: 로그(JSON, CSV) 또는 크래시 덤프 다운로드(로그 다운로드 참고)
  • 전체화면: 로그 화면을 전체 화면으로 확대 표시
참고

로그 검색 기간 설정 시 하루 이상의 넓은 범위의 검색은 느릴 수 있기 때문에 좁은 범위의 시간에서 검색 필터를 적용하고, 그 이후에 넓은 범위로 기간을 설정하면 조금 더 원활하게 로그를 검색할 수 있습니다.

로그 검색

Web App의 검색 메뉴에서 Effective Log Search & Analytics 2.0에 수집된 로그를 검색하는 방법은 다음과 같습니다.

  1. Web App에 접속해 주십시오.(Web App 접속 참고)
  2. 검색 메뉴를 클릭해 주십시오.
  3. 데이터 소스 검색창에서 프로젝트 또는 그룹 이름을 입력해 주십시오.
    • 검색 필드를 클릭하면 최근에 검색한 프로젝트 또는 그룹명이 표시됩니다.
    • 검색어 입력 시 검색 결과 창이 나타나 검색어가 포함된 프로젝트 또는 그룹 이름이 표시됩니다.
    • 알람 항목으로 로그를 검색하려면 [알람 불러오기] 버튼을 클릭한 후 알람 불러오기 팝업 창에서 항목을 선택해 주십시오.
    • 저장된 검색 쿼리로 로그를 검색하려면 [저장된 검색 불러오기] 버튼을 클릭한 후 저장된 검색 불러오기 팝업 창에서 항목을 선택해 주십시오.
    • 관리 메뉴의 프로젝트, 그룹, 알람, 저장된 검색 메뉴 화면에서 각 항목에 있는 i-elsa2-search을 클릭해 검색할 수도 있습니다.
  4. 검색 결과 창에서 로그를 검색할 프로젝트 또는 그룹을 선택한 후 검색 결과 창 이외의 영역을 클릭해 주십시오.
    • 프로젝트는 30개까지 설정이 가능하며, 그룹은 1개만 설정할 수 있습니다.
    • 현재 시간을 기준으로 지난 30분동안의 로그 수집 개수에 대한 차트와 상세 로그 항목이 표시됩니다.
  5. 검색창에 루씬 쿼리를 입력하거나 상태 영역, 집계 영역의 항목을 재설정하여 로그를 검색해 주십시오.
    • 루씬 문법에 대한 자세한 내용은 Apache Lucene을 참고해 주십시오.
    참고

    일부 로그 텍스트에 마우스 포인터를 올리면 정확히 일치라는 툴팁이 표시되는 경우가 있습니다. 이 툴팁 기능을 통해 로그 텍스트의 부분 일치가 아니라 정확하게 전체 텍스트가 일치하는 필드만 검색할 수 있습니다.

    • 상태 영역의 이슈 상태를 선택 또는 선택 해제해 원하는 조건으로 설정해 주십시오.
      • 상태: FATAL, ERROR, WARN, INFO, DEBUG
    • 집계 영역의 집계 항목을 선택 또는 선택 해제해 원하는 조건으로 설정해 주십시오.
      • i-elsa2-edit: 집계 항목 선택/선택 해제, 순서 변경, 삭제, 신규 집계 이름 추가, 재설정 가능
  6. 로그 검색 결과를 확인해 주십시오.

로그 다운로드

로그 검색 결과를 다운로드하는 방법은 다음과 같습니다.

  1. Web App에 접속해 주십시오.(Web App 접속 참고)
  2. 검색 메뉴를 클릭해 주십시오.
  3. 로그를 검색 및 필터링해 주십시오.(로그 검색 참조)
  4. 로그 목록에서 [로그 다운로드] 버튼을 클릭한 후 다운로드할 로그 종류를 선택해 주십시오.
    • 로그(JSON/CSV): 조회한 전체 로그를 JSON 또는 CSV 형식으로 다운로드
    • 크래시 덤프: 크래시 덤프 로그를 다운로드
  5. 로그(JSON/CSV)를 다운로드하는 경우, 로그 다운로드 팝업 창에서 다운로드 옵션을 선택해 주십시오.
    • 형식: 파일 형식 선택(CSV, JSON)
    • 개수: 다운로드할 로그 개수
    • 압축: 다운로드할 데이터를 파일 압축 형식으로 다운로드할지 선택
      • 압축 기능을 켜면 로그가 여러 파일로 나뉘어서 저장
      • 압축 기능을 끄면 단일 파일로 저장. 단, 파일 용량 증가로 다운로드 시간 증가.
    • 로그 수/파일: 파일당 저장할 로그 수
    • 필드: 다운로드할 필드 선택(CSV 형식의 경우 필드 선택 필수)
  6. 크래시 덤프를 다운로드하는 경우, 3번 절차에서 [크래시 덤프] 버튼을 누르는 즉시 파일이 다운로드됩니다.
  7. [DOWNLOAD] 버튼을 클릭해 주십시오.
    • 로그를 저장한 파일이 다운로드됩니다.