디코더 오류인가요, 썸네일 작업자 오류인가요? 누락된 RAW 미리 보기 테스트

동일한 디코더로 대기열 외부에서 RAW 파일 하나를 테스트한 다음, 작업자 할당과 작업 로그를 비교하여 형식 지원 문제와 실행 실패를 구분합니다.

원본 RAW 파일은 정상적으로 가져오지만 미리보기가 빈 상태로 남거나 대기 중일 때 이 판단이 중요합니다. 경쟁하는 두 상태는 지원되지 않거나 실패한 RAW 디코딩과 썸네일 대기열, 작업자, 권한 또는 출력 저장소의 실패입니다. 저장된 구성과 폐기 가능한 데이터로 시작하고, 한 번에 한 경로만 관찰하며, 테스트로 인해 데이터 손실, 권한 또는 가용성 위험이 커지면 중단합니다.

지원되지 않거나 실패한 RAW 디코딩과 썸네일 대기열, 작업자, 권한 또는 출력 저장소 실패를 구분하기

변경하기 전에 환경을 기록합니다. 소프트웨어 및 펌웨어 버전, 장치 식별 정보, 마운트 또는 네트워크 경로, 여유 공간, 권한 및 관찰 가능한 증상을 기록합니다. 기준선에는 원본 RAW 파일은 정상적으로 가져오지만 미리보기가 빈 상태로 남거나 대기 중인 상황을 재현할 수 있을 만큼 충분한 세부 정보가 포함되어야 합니다.

첫 번째 후보는 지원되지 않거나 실패한 RAW 디코딩입니다. 두 번째는 썸네일 대기열, 작업자, 권한 또는 출력 저장소의 실패입니다. 현재 Immich 지원 미디어 유형은 테스트에 사용되는 메커니즘 또는 명령 경계를 정의하지만, 이 특정 홈 서버에서 직접 관찰한 결과를 대신하지는 않습니다.

판별 테스트를 실행하기 전에 통과 조건과 중단 조건을 작성합니다. 통과는 한 경로에서 예측한 증거를 변경하면서 관련 없는 서비스는 변경하지 않아야 합니다. 실패하면 추측성 수정 작업을 연쇄적으로 실행하지 말고 시스템을 저장된 상태로 되돌려야 합니다.

통제된 판별 테스트 하나 실행하기

다음 판별 테스트를 사용합니다. 복사한 RAW 파일 하나에 메타데이터 및 디코딩 프로브를 실행하고, 썸네일 작업 하나를 대기열에 추가한 다음 대기열에서 출력 파일까지 추적합니다. 변경된 변수에 결과를 귀속할 수 있도록 작업량, 클라이언트, 경로, 파일 세트 및 타이밍을 동일하게 유지합니다.

libvips 디코더 지원을 사용하여 두 경로를 실제로 구분할 수 있는 필드를 선택한 다음, 해당 필드의 타임스탬프, 종료 상태, 오류 텍스트, 장치 또는 스냅샷 식별 정보, 지연 시간, 전송된 바이트, 권한 및 복구 상태를 캡처합니다. 신원, 내구성 또는 애플리케이션 상태가 테스트 대상 주장일 때는 명령이 오류 없이 종료되는 것만으로 충분하지 않습니다.

첫 실행 후 원래 조건에 재시작, 재연결, 재마운트 또는 콜드 캐시가 포함되어 있다면 해당 이벤트를 거친 뒤 테스트를 한 번 반복합니다. 첫 실행이 파괴적이거나 환경을 복원할 수 없다면 중단하고 폐기 가능한 복사본에서 대신 재현합니다.

exiftool sample.CR3
# 설치된 이미지 스택으로 복사본을 디코딩한 다음 썸네일 작업 하나를 대기열에 추가합니다

증거가 어느 경로를 뒷받침하는지 해석하기

통과: 대기열 작업 전에 디코더가 실패하거나, 디코딩은 성공하지만 작업자가 파생 파일을 기록하지 않습니다. 결론이 보편적인 주장이 되지 않도록 통과한 정확한 버전, 식별 정보 및 작업량을 기록합니다.

실패: 카메라 하나 또는 압축 모드 하나만 실패하므로 지원 범위를 해당 샘플로 한정해야 합니다. 네트워크, 메모리, 권한 또는 소스 일관성이 두 경로 모두에 영향을 줄 수 있으므로 실패가 자동으로 반대 경로를 입증하지는 않습니다. 문제를 확대하기 전에 이러한 공통 종속성을 분리합니다.

예외 또는 모호한 결과: 원본을 보존하고 재시도 폭주를 중단하며, 조사하는 동안 정상적으로 작동하는 JPEG 미리보기 경로를 유지합니다. 복구 가능한 복사본이 생기기 전에는 로그를 보존하고 복구, 정리, 삭제, 재분할 또는 재귀적 소유권 변경 명령을 실행하지 않습니다.

Featured

ZimaCube 2 개인용 클라우드 홈 NAS

ZimaCube2

$799.00 - $2,499.00

Buy Now

일치하는 조치를 적용하고 원래 실패를 재현하기

관찰된 경로에 맞는 조치를 적용한 다음, 축소된 대체 조건이 아니라 원래 조건을 반복합니다. 두 번의 주기 또는 관련 재부팅, 절전, 중단 또는 부하 전환 동안 디코더가 대기열 작업 전에 실패하거나, 디코딩은 성공하지만 작업자가 파생 파일을 기록하지 않을 때만 이 판단이 유효합니다.

읽기 전용 Immich 라이브러리를 사용하여 가장 가까운 종속 워크플로를 확인하되, 원래 트리거는 변경하지 않습니다. 관련 없는 데이터 세트, 공유, 컨테이너, 사용자 및 복구 지점은 이전의 접근 권한과 타이밍을 유지해야 합니다.

중단 경계는 명확합니다. 카메라 하나 또는 압축 모드 하나만 실패하여 지원 범위를 해당 샘플로 한정해야 한다면, 마지막으로 검증된 구성으로 돌아가 증거를 보존하고, 해당 경로가 반복 가능할 때만 더 심층적인 플랫폼 또는 하드웨어 테스트로 에스컬레이션합니다.

대상 결과가 유지되면 썸네일 작업 일정과 비교하여 수정 사항이 인접 서비스로 위험을 옮기지 않는지 확인합니다. 새로운 백업, 신원, 시간 초과 또는 가용성 문제가 발생한 성공적인 대상 테스트는 여전히 실패한 변경입니다.

FAQ

RAW 미리보기 누락을 진단할 때 남은 질문은 대개 왜 한 카메라의 일부 RAW 파일만 작동하는지, 파일 권한이 올바르게 보이는데도 작업자가 실패할 수 있는지, 미리보기를 라이브러리 전체에서 다시 생성해야 하는지에 관한 것입니다. 아래 답변은 이러한 예외 사례를 기본 판단과 분리합니다.

통과 기준은 변하지 않습니다. 디코더가 대기열 작업 전에 실패하거나, 디코딩은 성공하지만 작업자가 파생 파일을 기록하지 않아야 합니다. 후속 조건으로 파일 시스템, 신원, 네트워크 경로 또는 애플리케이션 버전이 변경되면 그 변경의 영향을 받은 판별 테스트만 반복합니다.

카메라 하나 또는 압축 모드 하나만 실패하여 지원 범위를 해당 샘플로 한정해야 한다면 실험 범위를 넓히지 않습니다. 그 시점에는 원본을 보존하고 재시도 폭주를 중단하며 조사하는 동안 정상적으로 작동하는 JPEG 미리보기 경로를 유지합니다. 플랫폼, 저장소 또는 하드웨어 담당자에게 에스컬레이션하기 전에 증거를 보존합니다.

왜 한 카메라의 일부 RAW 파일은 작동하나요?

같은 확장자라도 카메라 펌웨어, 압축 모드, 내장 미리보기 및 디코더 버전이 다를 수 있습니다.

파일 권한이 올바르게 보이는데도 작업자가 실패할 수 있나요?

예. 작업자가 다른 컨테이너 경로, UID 또는 출력 마운트를 사용할 수 있습니다.

미리보기를 라이브러리 전체에서 다시 생성해야 하나요?

샘플 하나가 성공하고 대기열 및 저장소의 여유 용량이 작업량을 감당할 수 있을 때까지는 실행하지 않습니다.

동일한 작업량에서 증거가 지원되지 않거나 실패한 RAW 디코딩 또는 썸네일 대기열, 작업자, 권한 또는 출력 저장소 실패를 따르고, 일치하는 조치가 두 번째 문제를 만들지 않고 원래 증상을 제거하면 진단이 완료됩니다. 어느 경로도 반복 가능하게 유지되지 않으면 로그와 저장된 상태를 그대로 보존합니다. 불확실성은 수정 사항을 더 쌓을 이유가 아니라 에스컬레이션할 이유입니다.