보고서

개요

보고서 서식 작성 및 생성 기능은 정기적인 데이터 보고, 분석 결과 요약, 그리고 의사결정 지원 자료를 손쉽게 생성하는 데 활용됩니다.

사용자는 미리 정의된 보고서 서식을 통해 원하는 형태의 보고서를 손쉽게 제작할 수 있습니다. 쿼리문을 활용하여 데이터를 가공한 뒤, 해당 데이터를 기반으로 테이블, 차트, 텍스트 등의 요소를 배치하여 보고서 서식을 구성할 수 있습니다.

이 기능을 통해 반복적인 보고 작업을 자동화하고, 일관된 형식의 분석 결과를 신속하게 공유할 수 있습니다.

보고서 서식 목록 조회/검색

분석 > 보고서에서 보고서 서식 목록을 조회하거나 검색할 수 있습니다.

• 그룹: 보고서의 분류 그룹(분류 그룹은 좌측 트리 그룹에서 조회/검색 가능)
• 이름: 보고서의 이름
• 설명: 보고서에 대한 설명
• 소유자: 보고서 서식을 추가한 계정
• 수정일: 보고서가 마지막으로 수정된 날짜(yyyy-MM-dd 형식)
• 보기: 보고서 서식을 지정한 날짜 기준으로 조회합니다. 보고서 서식 관리(REPORT_TEMPLATE_EDIT) 권한이 있는 경우에만 표시됩니다.

보고서 목록에서 특정 보고서를 찾으려면 도구 모음에 있는 검색 도구를 사용하세요. 검색 도구는 입력한 단어가 보고서의 이름, 설명에 포함된 보고서를 찾아서 보여줍니다. 검색 도구는 대소문자를 구분하지 않습니다.

보고서 서식 생성

보고서 서식을 생성하려면,

1. 보고서 목록의 도구 모음에서 추가를 클릭하세요.
2. 공통 설정 및 항목 설정을 완료한 후 저장을 클릭하세요.

공통 설정

공통 설정 섹션에서 보고서의 기본 정보를 설정하세요.

• 이름: 보고서의 이름(필수, 최대 50자)
• 설명: 보고서에 대한 설명(최대 2,000자)

항목 설정

보고서 서식을 구성하는 항목을 추가하세요. 항목을 추가하려면 각 항목 우측의 항목 추가를 클릭하거나, 항목이 없을 경우 화면 중앙에 표시되는 항목 추가를 클릭하세요.

• 유형: 항목의 유형
  • 단락: 보고서 서식에 텍스트 형태의 내용을 삽입하려면 단락을 선택하세요. 쿼리 결과의 line 필드 값을 문단 텍스트로 표시합니다. 레코드가 여러 개일 경우, 각 문단이 연속적으로 출력됩니다.
  • 표: 보고서 서식에 표 형태의 내용을 삽입하려면 표를 선택하세요. 쿼리 결과를 표 형태로 표시합니다. 출력 순서는 쿼리 결과 창에서 조회되는 열 순서와 동일하며, fields나 order 커맨드로 지정된 순서대로 열이 출력됩니다.
  • 그래프: 보고서 서식에 차트를 삽입하려면 그래프를 선택하세요.
    • 차트는 쿼리 결과에 따라 독립 변수 필드(X축)와 종속 변수 필드(Y축)를 자동으로 인식해 생성됩니다.
      • 독립 변수 필드: 차트의 기준 필드(날짜, 문자열, IP 주소 유형 필드)
      • 종속 변수 필드: 독립 변수에 대해 표시할 값 필드(정수, 실수 유형 필드)
    • 쿼리 결과에서 독립 변수가 될 수 있는 필드는 반드시 1개만 존재해야 하며, 종속 변수로 지정 가능한 컬럼은 1개 이상 있어야 합니다.
    • 단, 파이 차트의 경우 종속 변수 필드는 반드시 1개이어야 합니다.
  • 메모: 보고서 서식에 메모 형태의 내용을 삽입하려면 메모를 선택하세요. 쿼리 결과의 line 필드 값을 외곽선 박스 안의 메모 텍스트로 표시합니다. 레코드가 여러 개일 경우, 각 메모가 연속적으로 출력됩니다.
• 차트: 유형이 그래프인 경우 차트 종류를 선택하세요. 선택 가능한 차트 종류는 다음과 같습니다.
  • 라인: 시간에 따른 변화를 선으로 표시합니다.
  • 가로 막대: 데이터를 가로 방향 막대로 표시합니다.
  • 세로 막대: 데이터를 세로 방향 막대로 표시합니다.
  • 누적 영역: 여러 시리즈를 영역으로 누적하여 표시합니다.
  • 파이: 전체에 대한 비율을 원형으로 표시합니다.
  • 누적 가로 막대: 여러 시리즈를 가로 막대에 누적하여 표시합니다.
  • 누적 세로 막대: 여러 시리즈를 세로 막대에 누적하여 표시합니다.
• 차트 설정: 유형이 그래프인 경우 차트 표시 옵션을 선택하세요. 차트 종류에 따라 사용 가능한 옵션이 다릅니다.
  • 로그 스케일: Y축 눈금을 로그 스케일로 표시합니다. 라인, 가로 막대, 세로 막대, 누적 영역, 누적 가로 막대, 누적 세로 막대 차트에서 사용 가능합니다.
  • 백분율: 각 데이터를 전체 대비 백분율로 표시합니다. 라인, 가로 막대, 세로 막대, 누적 영역, 누적 가로 막대, 누적 세로 막대 차트에서 사용 가능합니다.
  • 도넛: 파이 차트를 도넛 형태로 표시합니다. 파이 차트에서만 사용 가능합니다.
  • 라벨: 각 데이터 포인트에 값 레이블을 표시합니다. 가로 막대, 세로 막대, 누적 가로 막대, 누적 세로 막대, 파이 차트에서 사용 가능합니다.
• 제목: 항목의 제목. 보고서 양식의 소제목으로 표시되며, 필요에 따라 생략할 수 있습니다.
• 쿼리: 항목에 표시할 데이터를 쿼리문으로 작성하세요.(필수, 최대 10,000자)
  • $("from") 및 $("to") 매개변수를 활용하여 특정 기간에 대한 데이터를 처리할 수 있도록 쿼리를 구성하세요. 보고서 생성 시점에 쿼리 매개변수 from, to를 통해 보고서 생성 대상 기간을 지정할 수 있습니다.
  • 쿼리문 작성 후, 테스트를 클릭하면 쿼리 실행 결과를 새 창에서 확인할 수 있습니다. 쿼리문을 작성해야 테스트가 활성화됩니다.

도구 모음

보고서 서식 추가 시 항목의 도구 모음을 사용하여 항목별 관리를 용이하게 할 수 있습니다.

왼쪽부터 서식 도구는 다음과 같습니다.

• 항목 추가: 새 항목을 아래에 추가합니다.
• 표시/숨김: 보고서 생성 시 항목의 표시/숨김 여부를 선택할 수 있습니다.
• 항목 순서 이동: 항목의 순서를 위/아래로 변경할 수 있습니다.
• 삭제: 항목을 삭제합니다.

보고서 서식 수정

보고서 서식을 수정하려면,

1. 보고서 서식 목록에서 수정할 보고서 서식의 이름을 클릭하세요.
2. 보고서 서식 수정에서 보고서 서식의 공통 설정, 항목 설정을 수정하고 저장을 클릭하세요. 보고서 서식을 수정하지 않으려면 패널 상단의 닫기()를 클릭하세요.

보고서 생성 및 조회

웹 콘솔에서 보고서 조회

추가한 보고서 서식으로 원하는 시간대의 데이터를 보고서 형식으로 조회할 수 있습니다.

1. 보고서 서식 목록에서 원하는 보고서 서식 항목의 보기를 클릭하세요.

   

2. 보고서 조회 화면 상단에서 보고서 생성을 원하는 날짜를 설정한 후 실행을 클릭하세요. 보고서를 생성하여 미리보기 화면에 보여줍니다.

   

3. 보고서 생성 완료 후 화면 오른쪽 상단의 다운로드를 클릭하여 원하는 형식(Word 문서, 한글 문서, 웹 문서, PDF)을 선택하면 로컬 PC에 다운로드 할 수 있습니다.

   

쿼리 기반 보고서 생성 및 조회

또 다른 방법으로 sonar-send-report를 이용해 리포트를 생성하고 메일로 받아볼 수 있습니다. 예약된 쿼리를 이용해 주기적으로 보고서를 생성하고 메일로 받아보도록 활용해보세요.

sonar-send-report 명령을 사용하려면 보고서 서식의 GUID를 알아두어야 합니다. 보고서 서식 목록에서 보고서의 이름을 클릭하면 웹 브라우저의 주소 표시줄에서 GUID를 확인할 수 있습니다.

보고서 서식 삭제

보고서 서식을 삭제하려면,

1. 보고서 서식 목록에서 삭제할 보고서 서식의 정보가 있는 행의 체크박스를 선택하세요.
2. 도구 모음에서 삭제를 클릭하세요.
3. 보고서 서식 삭제 창에서 삭제할 보고서 서식 정보를 확인하고 삭제를 클릭하세요. 보고서 서식을 삭제하지 않으려면 취소를 클릭하세요.

보고서 그룹 관리

보고서 그룹은 등록한 보고서 서식을 관리하고 분류하기 위해 사용됩니다.

보고서 서식 그룹 추가

보고서 그룹을 추가하려면,

1. 분석 > 보고서에서 보고서 그룹 목록 위에 있는 를 클릭하세요.

2. 보고서 서식 그룹 추가 대화상자에서 보고서 서식 그룹 정보를 입력하고 확인을 클릭하세요. 보고서 서식 그룹을 추가하지 않으려면 취소를 클릭하세요.

   

   • 이름(필수): 보고서 서식 그룹의 이름(최대 50자)
   • 설명: 보고서 서식 그룹에 대한 설명(최대 2,000자)
   • 상위 그룹: 상위 그룹을 지정하지 않으면 추가하는 그룹이 최상위 그룹이 됩니다.

보고서 서식 그룹 수정

보고서 서식 그룹을 수정하려면,

1. 분석 > 보고서에 있는 보고서 서식 그룹 목록에서 수정할 보고서 서식 그룹을 클릭하세요.
2. 보고서 서식 그룹 목록 위에 있는 을 클릭하세요.
3. 보고서 서식 그룹 편집 대화상자에서 수정할 사항을 반영하고 확인을 클릭하세요. 보고서 서식 그룹을 수정하지 않으려면 취소를 클릭하세요.

보고서 서식 그룹 삭제

보고서 서식 그룹을 삭제하려면,

1. 분석 > 보고서에 있는 보고서 서식 그룹 목록에서 삭제할 보고서 서식 그룹을 클릭하세요.
2. 보고서 서식 그룹 목록 위에 있는 를 클릭하세요.
3. 보고서 서식 그룹 삭제 대화상자에서 삭제할 보고서 서식 그룹이 맞는지 확인하고 삭제를 클릭하세요. 보고서 서식 그룹을 삭제하지 않으려면 취소를 클릭하세요.
   • 하위 그룹 모두 제거를 체크하면 하위 그룹이 모두 삭제되며, 해당 그룹에 속해있던 보고서 서식은 상위 그룹으로 이동됩니다. 상위 그룹이 없는 보고서 서식은 보고서 서식 목록에서 그룹이 미분류로 표시됩니다.
   • 하위 그룹 모두 제거를 체크하지 않고 그룹을 삭제하는 경우, 하위 그룹과 해당 그룹에 포함된 보고서 서식은 모두 상위 그룹으로 이동됩니다.

보고서 서식 그룹 이동

보고서 서식 목록에서 특정 보고서 서식의 그룹을 이동하려면,

1. 보고서 서식 목록에서 보고서 서식 그룹을 변경할 보고서 서식의 정보가 있는 행의 체크박스를 선택하세요.
2. 도구 모음에서 이동을 클릭하세요.
3. 보고서 서식 이동 대화상자에서 보고서 서식이 이동할 그룹을 선택하고 확인을 클릭하세요. 이동시키지 않으려면 취소를 클릭하세요.