문제 해결

증상에서 시작해 원인을 좁히는 순서를 정리했습니다.

로그인이 되지 않습니다

확인	방법
사내망 연결	VPN · 네트워크 상태 확인
계정 상태	사내 계정 담당자에게 활성 여부 확인
포털 주소	운영 담당자에게 정확한 주소 확인
인증 서비스 상태	다른 사용자도 같은 증상인지 확인 후 운영 담당자에게 문의

화면은 열리는데 데이터가 비어 있습니다

먼저 권한 문제와 데이터 문제를 구분합니다.

1. 감사 로그에서 본인 ID로 거부 기록이 있는지 확인합니다.
   • 거부 기록이 있으면 권한 문제입니다.
2. 거부 기록이 없으면 데이터가 실제로 없는 상태입니다.
   • Pipeline Ops에서 적재가 멈췄는지 확인합니다.

데이터가 오래되었습니다

Data Quality 판정 확인
   ↓ 신선도 FAIL?
Spark Applications 상태 확인
   ↓ 스트리밍 작업이 살아 있는가?
스트리밍 커넥터 상태 확인
   ↓ 소스 · sink가 실패 상태인가?
CronJobs 확인
   ↓ 스케줄이 일시중지되어 있는가?
파이프라인 실행 이력 확인
   ↓ 마지막 성공 실행이 언제인가?

각 단계는 Pipeline Ops와 Data Factory에서 확인합니다.

⚠️ 주의

커넥터가 Running 상태여도 적재가 진행되지 않는 경우가 있습니다. 프로세스 생존과 적재 성공은 다른 문제이므로, 판정은 항상 신선도 지표로 확인하세요.

수집 작업이 실패합니다

오류 성격	확인
대상을 찾을 수 없음	카탈로그 · 테이블 · 프로젝트 키의 오타, 등록 여부
권한 거부	조회 권한, 자격 증명 유효 기간
시간 초과	대상 데이터 규모, 조회 조건
저장 실패	저장소 권한, 용량
인증 실패	외부 시스템 토큰 만료

오류 메시지는 실행 이력에 그대로 남습니다. 메시지를 먼저 읽는 것이 가장 빠릅니다.

쿼리가 실패하거나 느립니다

증상	조치
접근 거부	접근 정책 확인 후 권한 신청
자원 한도 초과	조회 범위 축소, 필요 시 워커 증설
시간 초과	파티션 조건 추가, 컬럼 축소
계속 대기 상태	Compute의 리소스 그룹 대기 수 확인

값이 가려져 보입니다

정상 동작입니다. 마스킹 규칙이 적용된 결과입니다. 규칙과 대상은 분류와 마스킹에서 확인합니다.

자산의 라이브 값이 표시되지 않습니다

확인	내용
자산 등록	해당 설비가 자산으로 등록되어 있는가
식별자 일치	수집되는 식별자와 등록된 식별자가 같은가 (Pipeline Ops의 미등록 장비 패널)
태그 수집	그 태그가 수집 대상인가
스트리밍 상태	적재 작업이 동작 중인가

배치 화면에 문서가 보이지 않습니다

확인	내용
커넥터 동기화	EDMS 연동에서 마지막 동기화 결과 확인
수집 범위	문서 유형 · 분류 필터가 너무 좁지 않은가
열람 권한	해당 부서 문서에 접근 권한이 있는가
식별자 연결	문서의 배치 식별자가 배치 데이터와 일치하는가

예측 · 위험 패널이 보이지 않습니다

연동이 설정되지 않으면 패널이 표시되지 않습니다. 설정 상태를 KosmosAI 연계에서 확인하고, 연결 테스트로 응답을 검증하세요.

추세 기반 위험 신호는 연동 없이도 동작하지만, 시험 이력이 일정량 누적되어야 계산됩니다.

AI 응답이 이상합니다

1. 도구 호출을 펼쳐 실제 조회된 원본을 확인합니다.
2. 원본이 정상이면 요약 과정의 문제입니다. 질문을 더 구체적으로 다시 던집니다.
3. 원본이 비어 있으면 데이터 또는 권한 문제입니다. 위의 해당 항목을 확인합니다.

스토리지 경고가 표시됩니다

상태	조치
HEALTH_WARN	운영 담당자에게 알림. 디스크 이상 여부 확인
HEALTH_ERR	즉시 운영 담당자에게 보고
용량 임계 근접	적재 실패 전에 확장 · 정리 검토

→ Storage

운영 담당자에게 문의할 때

다음을 함께 전달하면 확인이 빨라집니다.

• 화면 이름과 수행하려던 동작
• 발생 시각 (분 단위)
• 화면에 표시된 오류 메시지 원문
• 대상 데이터 이름 (테이블 · 데이터셋 · 배치 ID 등)
• 본인 계정 ID