EZ-SPY 설정 사용법¶
1. 소개¶
EZ-SPY 3.0은 기존 EzSpy와 동일하게 AXL Library함수의 호출 시간과 인자, 결과값을 실시간으로 모니터링하고 기록하는 프로그램입니다.
2. EZ-SPY 실행 방법¶
EZ-SPY 3.0은 별도 프로그램으로 동작되며, EzWorks의 메뉴을 통해 실행하거나, 프로그램 설치 폴더의 EzSpy3.0.exe를 실행할 수도 있습니다.
2.1 EzWorks를 통한 실행 방법¶
EzWorks를 실행 후, Ez유틸리티 메뉴의 “EZ-SPY”를 선택하여, 실행할 수 있습니다.
2.2 EzSpy3.0.exe를 실행하는 방법¶
프로그램 설치 폴더의 EzSpy3.0.exe를 더블클릭하여 실행할 수 있습니다.
3. EZ-SPY 화면 UI 및 동작 방법¶
3.1 EZ-SPY UI¶
EZ-SPY 3.0은 상단 툴바와 실시간 로그 출력화면, 우측에는 특정 함수의 값을 모니터링 하는 Watch화면, 하단에는 Bookmark및 로그 개수 UI로 구성되어 있습니다.
3.2 상단 툴바¶
3.2.1 툴바 메뉴 설명¶
불러오기는 저장된 csv 파일을 불러와서 볼수
있는 기능입니다.
수신하는 로그 Level 을 설정하는 것으로,
FUNCTION을 설정하면 호출되는 모든 함수를 볼 수 있다.
None은 로그를 수신하지 않는다.
로그 취득을 체크(ON)해야, 함수 호출을
화면에 표시 및 csv 파일로 저장한다.
자동 저장을 체크(ON)하면, csv파일로 계속
저장되며, 체크 해제시, 파일은 기록되지 않는다.
저장되는 파일명과 현재까지 수신된 함수
로그의 숫자가 표시된다.
자동스크롤을 체크하면, 그리드는 계속 최신
로그로 스크롤 된다.
화면에 표시되는 로그를 모두 삭제한다.
파일에 저장된 내용을 계속 유지된다.
로그 함수의 색깔을 설정하는 기능
로그를 검색하는 키워드를 입력한다. 대/소
문자를 구분한다.
Watch창을 표시하거나 숨깁니다.
csv 파일의 분할 용량을 설정하는 것으로,
기본값은 5MB이다.
3.3 실시간 AXL함수 호출 로그¶
실시간 로그는 로그 레벨을 설정하고, 로그 수집 버튼을 체크하면, 실시간으로 수신되며, 프로그램의 중앙 화면에 표시됩니다.
3.3.1 실시간 AXL함수 색깔 설정¶
버튼을 클릭하여, 함수별 로그의 색깔을
설정할 수 있습니다.
(개선 예정)
3.4 로그 북마크 추가/삭제 및 바로가기¶
로그 수신창의 맨 첫 열을 클릭하면, 북마크가 표시되거나 삭제됩니다.
북마크가 추가되면, 화면 하단에 Line 번호와 함께 북마크 위치가 추가됩니다.
(기능 개선이 좀 필요합니다)
추가된 북마크를 더블클릭하면, 해당 로그 위치로 바로 이동합니다. 수신되는 모든 로그는 누락없이 csv파일로 저장되지만, 화면에 표시되는 로그는 10만개를 벗어나면, 지나간 로그는 표시하지 않습니다. 따라서, 로그가 계속 수신되는 상태에서는 북마크의 위치가 잘못 계산될 수 있습니다.
3.5 로그 필터링¶
AXL함수의 호출 로그를 일부만 화면에 표시하기 위해, 필터링 할 수 있습니다.
(개선 예정)
3.6 로그 Watch 함수 등록¶
호출된 AXL함수중, 특정 함수만을 모니터링 하고 싶을 때, Watch창에 등록하여 함수 호출값을 모니터링 할 수 있습니다.
(개선 예정)
4. EZ-SPY 로그 파일 형식 및 분석 방법¶
4.1 로그(csv) 파일 형식¶
로그는 텍스트 형태의 csv 파일의 형태로 저장된다.
첫줄은 Bookmark여부 및 수신 번호, 시각, AXL 호출함수 명 및 파라미터 등을 구분하는 헤더 내용이 기록되며, 그 이하에는 실제 함수로그가 기록됩니다.
| 구분 | 내용 |
|---|---|
| 첫 줄 | Bookmark,No,Recv Time,Date,Time,Milliseconds,Level,Level(Text),API Type,Func Index,Func Category,Resource No,Resource Name,Module No,Return Code,Return Code(Hex),API Name,Argument |
| 데이터 내용 | ,1,2025-04-11 11:11:41.765,2025-04-11,11:11:41,764,1,Error,0,927,72,0,0,AXIS-1,4051,0xFD3,AxmSignalIsServoOn,"0, 0","4051 AxmSignalIsServoOn(0, 0)" ,2,2025-04-11 11:11:41.768,2025-04-11,11:11:41,764,1,Error,0,927,72,0,1,AXIS-2,4051,0xFD3,AxmSignalIsServoOn,"1, 0","4051 AxmSignalIsServoOn(1, 0)" |
4.2 엑셀을 활용한 로그(csv) 파일 보기 및 분석¶
*.csv 파일은 MS-Excel이 설치된 컴퓨터에서는 아래 그림과 같이 Spreadsheet형태로 구분하여 표시되므로, 로그를 쉽게 분석 할 수 있습니다.
