진단 이력 & 디버그 로그

진단 이력은 모든 세션을 변경된 값과 함께 기록하고, 디버그 로그는 고객 지원팀의 오류 분석을 위해 통신 내용을 기록해요.

진단 이력

차량 작업을 하는 동안 CarPort는 실제로 일어난 일, 즉 어떤 ECU에 접속했는지, 어떤 데이터를 읽었는지, 그리고 무엇보다 어떤 값을 변경했는지를 백그라운드에서 기록해요. 진단 이력은 이 기록을 보여 주는 기능이에요.

특히 코딩이나 어댑테이션 후에 예상치 못한 동작이 나타날 때 큰 도움이 돼요. 기록에는 변경마다 이전 값(변경 전)과 새 값(변경 후)이 남아 있어서, 며칠이 지나도 어떤 작업을 했는지 추적하고 정확히 되돌릴 수 있어요.

이력은 메뉴 보기 → 진단 이력에서 열거나, 홈 화면의 진단 이력 열기 버튼으로 열 수 있어요. 홈 화면에서는 이미 기록이 있을 때만 이 영역이 나타나요.

화면 구성:

왼쪽 – 세션: 차량에 연결할 때마다 별도의 세션이 만들어져요. 세션은 처음 기록된 작업과 함께 시작되고, 인터페이스 연결이 끊기거나 CarPort를 종료하면 끝나요. 세션은 기간별로 묶여 있어요(오늘, 어제, 최근 7일, 이번 달, 올해, 그 이전은 연도별). 각 행에는 시각, 차대번호(또는 사용한 인터페이스), 항목 수가 표시돼요. 창을 열면 진행 중인 세션이 이미 선택되어 있고, 실시간으로 항목이 계속 추가돼요.
오른쪽 – 기록: 선택한 세션을 시간순으로 보여 줘요. ECU가 바뀔 때마다 주소, 이름, 통신 파라미터가 적힌 색깔 있는 행이 나타나고, 그 아래에 각 작업이 시각, 이름, 결과, 읽거나 쓴 값과 함께 이어져요. 변경 사항은 색으로 강조되며, 실패한 작업도 마찬가지예요.

💡 팁: 세션 이름 바꾸기(세션 목록의 컨텍스트 메뉴 또는 F2 키)로 세션에 이름을 붙일 수 있어요(예: “Golf 7 – 코너링 램프 코딩”). 이름은 목록과 기록의 머리글에 표시되어 나중에 다시 찾기 쉬워요.

필터링 및 검색:

세션 하나에 금세 수천 개의 항목이 쌓일 수 있어요. AutoScan 한 번만으로도 ECU마다 여러 항목이 생겨요. 필터로 표시 내용을 좁힐 수 있어요.

선택	효과
`모든 항목`	기록된 모든 작업(기본값).
`변경 사항만`	차량에 실제로 영향을 준 작업만 표시해요. 예: 코딩 쓰기, 어댑테이션 값 쓰기, 고장 메모리 삭제, 액추에이터 테스트, 기본 설정, 보안 액세스, SFD 잠금 해제. 차량에서 무엇이 바뀌었는지 추적할 때 가장 중요한 보기예요.
`읽기 작업만`	읽기 작업만 표시해요. ECU 정보, 고장 메모리, 코딩, 어댑테이션 채널, 설치 목록, 측정값이 해당돼요.

이와 별도로 사용자 작업만을 켤 수 있어요. 이 옵션은 자동으로 실행되는 기능, 즉 AutoScan, 서비스 어시스턴트, 모든 고장 코드 삭제가 일으킨 항목을 모두 숨겨요. 그러면 사용자가 ECU에서 직접 한 작업만 남아요. 이 기능들의 시작과 끝은 표시로 남아 있어서 시간 흐름을 놓치지 않아요.

도구 모음 오른쪽 끝에 있는 검색... 입력란은 항목을 숨기지 않고, 기록에서 찾은 부분을 모두 노란색으로 강조해요. 긴 세션에서 특정 부품 번호, 어댑테이션 채널, 고장 코드를 찾을 때 유용해요.

인쇄 및 내보내기:

인쇄(Ctrl+P)는 선택한 세션의 인쇄 미리 보기를 열어요.
내보내기(Ctrl+S)는 선택한 세션을 PDF, Markdown 또는 텍스트 파일로 저장해요. 형식은 선택한 파일 확장자에 따라 정해져요. 저장 위치는 프로그램 설정에서 지정한 보고서 폴더가 기본으로 설정되어 있고, 파일 이름에는 날짜가 이미 들어 있어요.

두 기능 모두 전체 세션을 대상으로 하며, 화면에 아직 불러오지 않은 부분도 포함돼요. 단, 설정한 필터는 그대로 적용돼요. 숨겨진 항목은 인쇄되거나 내보내지지 않아요.

💡 팁: 자체 기록용이나 정비소에 제출할 증빙 자료로는 PDF가 알맞아요. 포럼에서 도움을 요청할 때는 Markdown이나 텍스트로 내보내는 것이 더 좋아요. 게시글에 바로 붙여 넣을 수 있기 때문이에요. 기록에서 일부만 선택해 클립보드에 복사(Ctrl+C)로 복사할 수도 있어요.

이력 삭제:

삭제 버튼에는 두 가지 옵션이 있어요.

세션 삭제는 선택한 세션을 모든 항목과 함께 삭제해요.
전체 이력 삭제는 기록된 모든 세션을 삭제해요.

두 동작은 세션 목록의 컨텍스트 메뉴에서도 사용할 수 있어요. CarPort는 매번 확인을 요청해요.

⚠️ 주의: 삭제한 기록은 복원할 수 없어요. 변경 내역을 남겨 두고 싶다면 먼저 해당 세션을 내보내 두세요.

기록 및 보관 기간:

기록 여부와 세션 보관 기간은 프로그램 설정의 진단 이력 영역에서 지정해요.

ℹ️ 참고: 진단 이력에는 어떤 작업이 실행되었는지, 그리고 그때 어떤 값을 읽거나 썼는지가 기록돼요. 버스 상의 원시 통신은 기록되지 않아요. 통신 문제를 기술적으로 분석하려면 여전히 디버그 로그가 알맞은 도구예요.

디버그 로그

진단 중에 문제가 생기면(예: 통신 오류, 연결 끊김, 예상치 못한 오류 메시지) CarPort는 차량과의 모든 통신을 디버그 로그로 기록할 수 있어요. 이 로그에는 주고받은 모든 메시지, 내부 처리 단계, 발생한 오류나 예외에 대한 자세한 정보가 담겨요.

디버그 로그는 저희 개발팀이 문제의 원인을 분석하는 데 가장 중요한 도구예요. 그래서 고객 지원을 요청하면 보통 디버그 로그를 만들어 보내 달라는 안내를 받게 돼요.

ℹ️ 참고: 디버그 로그에는 CarPort와 차량 사이의 기술적인 통신 데이터만 들어 있어요. 개인 정보는 기록되지 않아요.

단계별 안내:

메뉴 도구 → 디버그 로그 쓰기에서 디버그 로그 기록을 켜세요.
저장 위치를 보여 주는 대화 상자가 열려요. 기본 경로는 프로그램 설정에서 지정한 디버그 폴더예요.
문제가 발생할 때까지 평소처럼 진단을 진행하세요(예: 통신 오류, 예상치 못한 오류 메시지).
CarPort를 종료하세요.
디버그 로그가 저장된 폴더가 Windows 탐색기 창으로 자동으로 열려요. 로그 파일 이름에는 타임스탬프가 들어 있어서 해당 파일을 쉽게 찾을 수 있어요.
개발팀이 원인을 분석할 수 있도록 로그 파일을 이메일로 고객 지원팀에 보내 주세요.