[i-AUD] Log Viewer 에서 Client Log를 확인할 수 있습니다.

page no. 79420528

📌 개요

Client 로그란?

Client 로그는 i-AUD의 클라이언트(브라우저) 측에서 발생하는 동작·예외를 프레임워크가 자동으로 기록하는 진단·오류 로그입니다. 개발 중 보고서 동작에 문제가 발생했을 때, 어디서 무엇이 잘못되었는지 빠르게 파악할 수 있도록 지원합니다.

중요! 사용자 트래킹 / 감사 로그가 아닙니다

Client 로그는 모든 사용자 액션(클릭·키 입력·스크롤 등)을 추적·적재하는 트래킹 로그가 아닙니다. 프레임워크 내부에서 의미 있는 지점에 한해 자동으로 기록되는 진단·예외 로그입니다.
감사(Audit) 목적의 사용자 액션 추적이 필요한 경우, 보고서 실행 이력 등 별도의 로그 수단을 사용해 주세요.

서버로 자동 업로드되지 않습니다

적재된 Client 로그는 별도 서버로 업로드되지 않습니다. 디자이너에서 띄운 Log Viewer 팝업 창으로만 전달되며, 팝업이 열려 있지 않으면 로그는 그대로 폐기됩니다.

💡 이런 상황에 사용하세요

상황	주요 로그 타입
🐛 보고서 화면에서 컨트롤이 정상 동작하지 않을 때	❌ Error
🔍 서비스 호출(데이터셋·메타·Export) 흐름을 추적할 때	💡 Info 📝 SqlInfo
⏱️ 보고서 다운로드·렌더링 경과 시간을 측정할 때	💡 Info
🧪 보고서 스크립트의 내부 동작을 검증할 때	🐛 Debug
🔗 클라이언트 호출과 서버 SQL 로그(iCheck)를 매칭할 때	📝 SqlInfo

🚪 사용 방법

i-AUD 디자이너 상단 메뉴에서 [편집 그룹] → [Log Viewer] 클릭
새 창으로 Log Viewer가 열리면 상단 탭에서 [Client] 탭 선택
보고서 동작에 따라 발생하는 클라이언트 로그가 실시간 표시됨

로그 표시 범위 제한

Log Viewer를 띄운 디자이너 창에서 발생한 클라이언트 로그만 표시됩니다.

다른 디자이너 창에서 발생한 로그는 보이지 않으며, Log Viewer 창은 디자이너 종료 시 함께 닫힙니다.

🏷️ 로그 타입 (4종)

💡 Info

정상 흐름의 주요 이정표를 기록합니다. 서비스 진입/완료, 보고서 열기·저장 경과 시간, Export 시작·취소, ShowMessageByErrCode 안내, 클립보드 성공/실패 등.

🐛 Debug

진단·내부 흐름 추적용 로그. 다이얼로그 내부 동작, ContextMenu 빈 메뉴 표시 여부, ScriptEditor XML 덤프, Combo 인터벌 reject 등 깊이 있는 디버깅에 사용됩니다.

📌 디버그모드에만 활성

❌ Error

AJAX 통신 실패, 응답이 비정상이거나 비어 있는 경우, 검증 실패, 그리고 모든 컨트롤·서비스 메서드의 catch 블록에서 잡힌 예외(Exception)도 Error 타입으로 적재됩니다. (메시지 + 스택 트레이스 자동 첨부)

📝 SqlInfo

서비스(DataSet/Meta/Export 등)의 AJAX complete 콜백 시점에서만 발생합니다. 클라이언트 호출을 서버측 SQL 로그(iCheck) 와 매칭할 수 있도록 키 전달용으로 사용됩니다.

📌 디버그모드에만 활성

💡 아이콘 표기 차이

Windows 버전(Windows 10 vs 11)이나 브라우저 버전에 따라 위 아이콘이 다르게 보일 수 있습니다. 이는 시스템 폰트의 이모지 렌더링 차이로, 동작에는 영향이 없습니다.

Window 10	Window 11

👨‍💻 개발자 스크립트에서 호출

예시 코드

// 보고서 OnLoad 스크립트
function OnLoad() {
    Matrix.DebugWrite('MyReport.OnLoad', '보고서 로딩 시작');


    try {
        // 사용자 비즈니스 로직
        const result = doSomething();
        Matrix.DebugWrite('MyReport.OnLoad', `중간 결과: ${result}`);
    } catch (e) {
        Matrix.DebugWrite('MyReport.OnLoad', e);
    }
}

주의 사항

변경 사항

변경 전	변경 후	릴리즈 번호
i-AUD의 Log Viewer에서 Sql, Server 로그를 확인할 수 있습니다.	i-AUD의 Log Viewer에서 Sql, Server 에 더해 Client 로그도 확인할 수 있습니다.	7.0.500.20240516-11

기능 정보	API Open	UI Open	Read Only	Not Use	Hidden	Not Recommend	해당 없음
시작 버전 정보	Release No : 7.0.500.20240516-11

공간 바로가기

페이지 트리

📌 개요

💡 이런 상황에 사용하세요

🚪 사용 방법

🏷️ 로그 타입 (4종)

👨‍💻 개발자 스크립트에서 호출