Page tree
Skip to end of metadata
Go to start of metadata


i-MATRIX 보고서 오류 시 i-CHECK를 이용해 로그를 취합할 수 있습니다.

1. i-CHECK 개요

i-CHECK 프로그램을 활용하여 클라이언트 로그, 서버 로그 확인 및 환경 진단이 가능합니다.

2. 실행 방법

구분설명
클라이언트 폴더

Discription

Client의 Program Files(x86)하위 제품 설치 위치에서 i-CHECK.exe 파일을 실행합니다.

Ex) C:\Program Files (x86)\BIMatrix\iMatrixBin7

해당 프로그램의 [바로 가기]를 만들면 빠르게 실행할 수 있습니다.

i-MATRIX 디자이너

Discription

i-MATRIX 디자이너 창의 i-MATRIX 메뉴에서 Log Tracer를 클릭하여 실행합니다.


3. 로그인

비밀번호 : matrix

비밀번호를 입력하고 로그인 버튼을 클릭합니다.

다국어를 지원합니다. (한국어, 영어, 일본어)

4. i-MATRIX 6.2.201.xxx 이전 버전에서 사용 방법

  • 신규 i-CHECK 적용 위치

    • Client의 Program Files(x86)하위 제품 설치 위치에서 실행시켜주십시오. (혹은 Newtonsoft.Json.dll 파일과 동일한 위치)
  • 신규 i-CHECK 적용 파일

    • i-CHECK.exe : 신규 i-CHECK 파일추가 (제품버전. 6.2.300.XXX)
    • BIMATRIX.MATRIX6.Core.dll : 신규 Core파일 교체 (제품버전. 6.2.201.XXX) - 신규 i-CHECK에 로그를 쌓기 위해 필요합니다.
  • 적용 방법
    • 신규 i-CHECK 적용 파일을 신규 i-CHECK 적용 위치에 추가 및 교체 한 후 i-CHECK를 실행 또는 재실행 합니다.




i-AUD 보고서 오류 로그를 별도로 확인할 수 있습니다.

1. Log Viewer 개요

Log Viewer는 Sql, Server, Client 탭으로 나뉘며, 각 탭에서 서버 내의 보고서 실행 중 쿼리 조회 상태서버 로그 그리고 사용자 인터페이스와 관련된 로그 정보를 확인할 수 있습니다.

2. 실행 방법

i-AUD Designer의 편집 그룹 > Log Viewer


3. SQL Log Viewer 탭 화면 구성

SQL 탭을 통해 실시간 실행되는 쿼리 결과 및 쿼리에 바인딩 된 파라미터 확인, 오류 발생 시의 오류 메세지 확인 등 자세한 정보를 확인 할 수 있습니다.

4. Server Log Viewer 탭 화면 구성


Server 탭은 관리자 포털의 '시스템 로그 보기' 화면에서 제공하는 조회 기능과 동일한 기능을 제공합니다.

하지만, 기존 관리자 포털에서 제공하는 '삭제', '설정', '다운로드' 기능은 제공하지 않습니다.

시스템 로그 관련 가이드

관련 가이드로 이동하기 : 상세 로그 수집 (서버 로그)

5. Client Log Viewer 탭 화면 구성


Client 탭에서는 사용자 인터페이스와 관련된 다양한 로그 정보를 제공합니다.

로그 타입 별 아이콘 구분



구분상세 구분상세 설명
Log Viewer 창

로그를 조회합니다.

i-AUD 디자이너를 종료해도 띄어진 창은 유지됩니다.

조회 버튼

로그 조회를 갱신합니다.

데이터 그리드로그 시작 시간

쿼리를 조회하기 시작한 시간입니다

DB 별칭쿼리를 실행한 DB 명입니다.
레포트명 / 데이터소스명쿼리를 실행한 레포트와 데이터소스 명입니다.
※ 레포트명이 " - "로 표출되는 경우 : 저장하지 않은 레포트에서 조회 또는 META / META VIEW에서 조회한 경우
※ 데이터소스명이 " - "로 표출되는 경우 : 서버스크립트로 조회 또는 META에서 조회한 경우
레코드수데이터셋의 레코드 수량입니다,
결과

쿼리 조회의 Success / Fail 여부를 나타냅니다. ( / )

SQLSQL

조회한 쿼리문을 확인할 수 있습니다.

텍스트박스 형식이기 때문에 쿼리를 복사할 수 있습니다.

Error

결과가 Fail 인 행을 볼 때, Error Message를 출력합니다.

Discription

 설명 펼치기

 

쿼리 조회 결과가 Fail인 항목(Row) 선택 시 우측 하단에 해당 오류 메시지 표시


제약사항

로그를 보여주지 않는 경우는 다음과 같다.

  • i-MATRIX에서 쿼리를 조회한 경우
  • 실행계획(DB Upload)을 이용해 쿼리를 조회하거나 실행한 경우

로그 출력 개수 는 50건으로 제한 한다.


i-AUD 보고서 오류 시 디버깅이 가능합니다.

1. 디버그 모드

i-AUD Designer에서 디버그 모드를 설정하여 개발자 도구를 통해 소스 코드를 디버깅할 수 있습니다.

사용 방법

  1. 작업 중이던 i-AUD 보고서를 저장합니다.
  2. 설정 버튼 클릭하여 설정 창을 실행합니다.
  3. 디버그 모드를 체크하고 확인 버튼을 클릭합니다.
  4. 작업 중이던 디자이너의 창을 새로고침(F5)합니다.

    주의사항

    페이지를 새로고침(F5)해야 반영됩니다.

  5. 웹 브라우저 개발자 도구(F12)를 실행합니다.

  6. 보고서를 실행합니다.

  7. 스크립트 코드에 자동으로 중단점이 생성되며 추가로 중단점을 삽입하여 디버깅을 할 수 있습니다.


참고사항

소스 디버그 모드는 제품 개발자용 기능이기 때문에 보고서 제작 중 사용하지 않습니다.



2. Script Editor 디버그 문구 삽입

Script Editor에서 디버깅을 할 위치에 디버깅 문구를 삽입하여 개발자 도구를 통해 소스 코드를 디버깅할 수 있습니다.


사용 방법

  1. Script Editor에서 소스를 디버깅할 위치에 debugger 문구를 삽입합니다.
  2. Script Editor를 저장합니다.
  3. 웹 브라우저 개발자 도구(F12)를 실행합니다.
  4. 보고서를 실행하여 디버깅하고자 하는 동작을 실행합니다.
  5. 문구를 삽입한 위치에 중단점이 생성되며 추가로 중단점을 삽입하여 디버깅을 할 수 있습니다.


서버 로그는 아래와 같이 취합이 가능합니다.

Page No.  79412638

작성자 :  고대훈 / 검수자 :  


관리자 페이지에서 서버 로그 파일을 다운로드 받을 수 있습니다.

Step 1. 로그 모드 설정 변경

  1. 관리자 페이지에 접속합니다.

  2. [시스템관리] > [시스템 로그 보기]를 실행합니다.

  3. 설정 버튼을 클릭하여 로그 모드 설정 창을 실행합니다.

  4. Log Mode를 [Debug], Core Mode를 [예]로 설정하고 확인 버튼을 클릭하여 적용합니다.

    Description

    • 로그 모드 설정 정보

      항목

      내용
      Log Mode

      서버에 저장하는 로그 파일의 유형을 설정합니다.

      1) None : 로그 파일을 저장하지 않음

      2) Information : 기본 동작 로그 저장

      3) Debug : "Information"을 포함한 디버그용 자세한 로그를 저장

      * 오류 내용은 ‘Information'과 'Debug’ 모두 저장됩니다.

      Safer Mode

      1) 예 : 라이센스 오류 메시지를 확인하려는 경우

      2) 아니오 : 일반적인 디버그 모드로 설정

      * 이 기능은 로그 모드가 "Debug"인 경우에만 사용할 수 있습니다.

      Core Mode

      1) 예 : 클라이언트에서 보내는 SQL에 대해 자세히 확인하려는 경우

      2) 아니오 : 일반적인 디버그 모드로 설정

      * 이 기능은 로그 모드가 "Debug"인 경우에만 사용할 수 있습니다.

      Log Backup

      로그 파일 생성 옵션을 설정합니다.

      1) Always : 로그 파일 크기 제한을 초과할 때마다 로그 파일의 백업을 만듭니다.

      2) Daily : 날짜 별 로그 파일 백업을 만듭니다. 1일 로그 파일의 크기가 로그 파일 크기 제한을 초과하면 최신 로그에서 최대 크기만큼 저장합니다.

      3) One time : 로그 파일 크기 제한을 초과하면 백업을 만듭니다. 그러나 백업 파일 하나로 새 백업 파일이 생성될 때 이전에 생성된 백업 파일이 남아 있다면 삭제됩니다.

      Log File Limit Size

      로그 파일의 저장 크기를 설정합니다. (기본 : 3MB)

      로그 파일 크기 제한을 초과하면 새 로그 파일이 생성됩니다. 기존 로그 파일은 백업됩니다.

      보존 기간

      파일의 저장 기간을 설정합니다.

      하위 버전과의 호환 처리를 위해 필요하며 이 버전에서는 사용할 수 없습니다.

      * 값을 0으로 설정하거나 기간 단위를 "Unlimits"로 설정할 수 있습니다.

      에러 로그 파일 분리오류 발생 시 로그 파일을 분리하여 별도 파일을 만들 것인지 설정합니다.

      재 시작 시 자동 반영

      1) 예 : Admin 서버를 다시 시작할 때 로그 모드의 설정을 유지합니다.

      2) 아니오 : Admin 서버를 다시 시작할 때 로그 모드의 설정을 초기화합니다.


Step 2. 오류 현상 재연 및 서버 로그 수집

  1. 포탈에 접속하여 오류 현상을 재연합니다.
  2. 관리자 페이지에 접속합니다.
  3. [시스템관리]  >  [시스템 로그 보기]에서 [다운로드] 버튼을 클릭하여 로그 파일을 PC에 다운로드 합니다.

    참고사항

    로그 파일 다운로드는 서버에 저장된 전체 로그가 zip 파일로 압축되어 동시에 다운로드 됩니다.

  4. Step 1에서 설정한 로그 모드를 information으로 변경하여 로그 모드 설정을 원복합니다.



참고사항

Information / Debug 모드 차이점

로그 파일InformationDebug
AUD.log

Matrix.log



관련 문서



  • No labels