통합로그
개요
이 화면은 무엇인가요? MES와 ERP 간 데이터 전송 이력을 조회하는 화면입니다. 전송 시각, 방향, 건수, 성공/실패 상태, 오류 상세를 기록하여 통합 문제를 추적합니다.
누가 사용하나요?
- 시스템관리자
- IT팀
언제 사용하나요?
- MES↔ERP 데이터 전송 이력을 확인하거나 오류를 추적할 때
주요 기능
목록 조회, 상세 입력, 필터 검색, CSV 내보내기를 지원합니다.
입력 항목 가이드
| 항목 | 설명 | 입력 방법 | 예시 |
|---|---|---|---|
| 트랜잭션ID | (필수) VARCHAR | 텍스트 입력 | - |
| 매핑ID | (필수) mes_erp_integration_mappings 테이블 참조 (mapping_name 표시) | 목록에서 선택 | - |
| 전송방향 | (필수) mes_to_erp / erp_to_mes | 목록에서 선택 | - |
| 페이로드 | (필수) 전송 데이터 JSON | JSON 입력 | - |
| 응답페이로드 | JSONB | JSON 입력 | - |
| 상태 | (필수) pending / success / failed / retrying | 목록에서 선택 | - |
| 오류메시지 | TEXT | 텍스트 입력 | - |
| 재시도횟수 | INT | 숫자 입력 | - |
| 최대재시도 | INT | 숫자 입력 | - |
| 처리일시 | TIMESTAMP | 달력에서 선택 | - |
| 원본레코드ID | VARCHAR | 텍스트 입력 | - |
| 이벤트순번 | (필수) 이벤트 순서 보장용 단조증가 시퀀스 | 숫자 입력 | - |
| 이벤트버전 | INT | 숫자 입력 | - |
| 멱등성키 | VARCHAR | 텍스트 입력 | - |
자주 묻는 질문 (FAQ)
Q. 이 화면의 데이터는 어디에 활용되나요?
A. 이 화면에서 등록·관리하는 데이터는 관련 화면에서 참조되며, 대시보드와 분석 리포트에 반영됩니다.
📋 참고: 데이터 구조 (개발자/관리자용)
입력 항목 설명
| 항목 | 의미 | 타입 | 필수 | 왜 필요한가 |
|---|---|---|---|---|
| 트랜잭션ID | transaction_id | VARCHAR | ✅ | - |
| 매핑ID | mapping_id | UUID | ✅ | mes_erp_integration_mappings 테이블 참조 (mapping_name 표시) |
| 전송방향 | direction | mes_to_erp / erp_to_mes | ✅ | - |
| 페이로드 | payload | JSONB | ✅ | 전송 데이터 JSON |
| 응답페이로드 | response_payload | JSONB | 응답 데이터 JSON | |
| 상태 | status | pending / success / failed / retrying | ✅ | - |
| 오류메시지 | error_message | TEXT | - | |
| 재시도횟수 | retry_count | INT | - | |
| 최대재시도 | max_retries | INT | - | |
| 처리일시 | processed_at | TIMESTAMP | - | |
| 원본레코드ID | source_record_id | VARCHAR | 원본 시스템 레코드 식별자 | |
| 이벤트순번 | sequence_number | BIGINT | ✅ | 이벤트 순서 보장용 단조증가 시퀀스 |
| 이벤트버전 | event_version | INT | 이벤트 스키마 버전. 순서 역전 감지용 | |
| 멱등성키 | idempotency_key | VARCHAR | source_table + source_id + event_type 복합. 중복 처리 방지 |
데이터 관계
참조받는 테이블
- MES-ERP통합매핑 (1:N) MES-ERP통합매핑→트랜잭션로그
화면 설정
목록 컬럼
| 컬럼 | 렌더링 | 고정 | 정렬 |
|---|---|---|---|
| 트랜잭션ID | link | - | ✅ |
| 매핑ID | 기본 | - | ✅ |
| 전송방향 | tag | - | ✅ |
| 상태 | badge | - | ✅ |
| 재시도횟수 | 기본 | - | ✅ |
| 처리일시 | date | - | ✅ |
| 이벤트순번 | 기본 | - | ✅ |
필터 설정
| 필드 | 필터유형 |
|---|---|
| 트랜잭션ID | search |
| 상태 | select |
| 전송방향 | select |
폼 구성
기본정보
| 필드 | 필수 | 읽기전용 | 비고 |
|---|---|---|---|
| 트랜잭션ID | ✅ | ||
| 매핑ID | ✅ | ||
| 전송방향 | ✅ | ||
| 상태 | |||
| 처리일시 |
재시도/시퀀스
| 필드 | 필수 | 읽기전용 | 비고 |
|---|---|---|---|
| 재시도횟수 | |||
| 최대재시도 | |||
| 이벤트순번 | |||
| 이벤트버전 | |||
| 멱등성키 | |||
| 원본레코드ID |
페이로드/오류
| 필드 | 필수 | 읽기전용 | 비고 |
|---|---|---|---|
| 페이로드 | |||
| 응답페이로드 | |||
| 오류메시지 |