문제가 생겼을 때 할 일을 미리 정해 두기

저장 공간 부족, 원본 변경, 이름 충돌, 예약 겹침처럼 전송 중 생기는 문제마다 할 일을 미리 정해 두고 결과를 읽는 방법을 알아보세요.

IT 엔지니어

이 문서가 해결하는 문제#

새벽 세 시에 전송이 멈춰 있습니다. 누군가 일어나서 판단해야 합니다.

  • 대상 장비의 디스크가 찼습니다. 기다릴까요, 이 장비만 건너뛸까요?
  • 보내는 중에 원본 파일이 바뀌었습니다. 다시 보낼까요, 건너뛸까요?
  • 어제 실행이 아직 안 끝났는데 오늘 예약 시각이 됐습니다. 겹쳐 돌릴까요, 이번은 건너뛸까요?

이 판단을 미리 적어 두는 자리가 Error handling 입니다. 적어 두면 사람이 깨지 않아도 INNORIX가 그대로 처리하고, 무엇을 왜 그렇게 했는지 실행 기록에 남깁니다.

그리고 아홉 가지는 아예 정할 필요가 없습니다. INNORIX가 늘 알아서 처리합니다.

적용 대상과 대표 상황#

누가 언제
운영 담당자 야간, 주말에 무인으로 도는 전송을 맡을 때
시스템 관리자 장비가 많아 일부는 늘 문제가 있는 환경일 때
보안, 감사 담당자 문제가 났을 때의 처리가 정책과 맞아야 할 때

시작 전 준비#

설정하는 자리#

  1. Flows → Flow 선택 → Edit flow.
  2. 도구줄의 Assurance 배지를 누릅니다.
  3. 창 아래쪽 Error handling 을 폅니다. 요약줄은 INNORIX 권장값 그대로일 때 INNORIX recommended, 다른 것이 있으면 N custom 으로 뜹니다.
  4. 묶음마다 이슈가 있고 이슈마다 조치를 고릅니다.
  5. Apply 를 누르고 창을 닫은 뒤 Save & activate 로 저장합니다.

위쪽 Success conditions 줄의 Reset to defaults 는 성공 조건만이 아니라 여기 정한 조치까지 함께 되돌립니다. 돌아가는 자리는 이 워크스페이스의 기본값입니다. 워크스페이스에 따로 정한 것이 없으면 INNORIX 권장값으로 갑니다. 창의 Cancel 은 창을 열었을 때의 값으로 돌려놓습니다.

정할 수 있는 것#

아래 표의 "기본 조치" 는 INNORIX 권장값입니다. 그대로 두어도 됩니다.

먼저 읽어 주세요. Flow 가 실제로 시작하는 값은 이 워크스페이스의 Assurance 기본값입니다. 워크스페이스에서 조치를 바꿔 두었다면 아래 표와 다른 값으로 시작합니다.

구별하는 방법이 있습니다.

보이는 것 뜻
줄 옆 배지가 Default 그 줄은 INNORIX 권장값 그대로
줄 옆 배지가 Workspace 그 줄은 워크스페이스 기본값에서 왔음
Flow 이름 옆 배지가 Workspace defaults 이 Flow 는 워크스페이스 기본값을 그대로 쓰는 중
Error handling 요약줄이 아무것도 바꾸지 않았는데 N custom 정상입니다. 이 요약은 INNORIX 권장값과 비교하므로, 워크스페이스가 정해 둔 값도 "다름" 으로 셉니다

워크스페이스 기본값은 워크스페이스 설정의 Assurance defaults 에 있습니다. 누구나 볼 수 있고, 바꾸는 것은 워크스페이스 소유자나 관리자만 할 수 있습니다.

Network#

이슈 기본 조치 뜻
Insufficient storage Keep retrying 대상 디스크가 찼습니다. 공간이 생길 때까지 계속 다시 시도합니다
Recovery not progressing Keep retrying 복구가 진척되지 않습니다. 계속 시도합니다

Source#

이슈 기본 조치 뜻
Source changed Transfer the file again 보내는 중 원본이 바뀌었습니다. 바뀐 내용으로 다시 보냅니다
Source deleted Skip the file 원본이 사라졌습니다. 그 파일만 건너뜁니다
Source file in use Skip the file 다른 프로그램이 쓰고 있습니다. 그 파일만 건너뜁니다

Destination#

이슈 기본 조치 뜻
Destination file exists Keep both 같은 이름이 있습니다. 둘 다 남깁니다. 창이 적어 둡니다 — "Set in each step's save options." 즉 실제 규칙은 단계의 저장 옵션에서 정합니다
Destination file in use Skip the file 대상 파일을 다른 프로그램이 쓰고 있습니다
File system naming conflict Skip the file 파일 시스템이 받을 수 없는 이름입니다

Schedule and time#

이슈 기본 조치 뜻
Schedule overlap Skip this run 앞 실행이 안 끝났는데 예약 시각이 왔습니다. 이번 회차를 건너뜁니다
Deadline missed Continue 기한을 넘겼습니다. 전송은 계속합니다. 다만 Contract는 위반으로 판정됩니다

고를 수 있는 조치#

조치 무엇이 일어나나 언제
Keep retrying 될 때까지 계속 시도 일시적인 문제. 공간 부족, 잠깐의 점유
Retry later 나중에 다시. 그동안 다른 파일은 멈춰 두고 기다립니다. 끝내 안 되면 그 파일을 건너뜁니다 곧 풀릴 것이 확실할 때
Transfer the file again 그 파일을 처음부터 다시 원본이 바뀌었을 때
Skip the file 그 파일만 빼고 나머지는 진행 한 파일 때문에 전체를 멈출 수 없을 때
Skip this device 그 장비만 빼고 나머지 장비는 진행 장비 하나의 문제가 배포 전체를 막으면 안 될 때
Skip this run 이번 회차를 통째로 건너뜀 예약이 겹쳤을 때
Queue one 이번 회차를 거르지 않고 줄 세움. 앞 실행이 끝나면 이어서 돈다 거르면 안 되는 회차일 때
Continue 기록만 남기고 그대로 진행 알고는 있어야 하지만 멈출 일은 아닐 때
Stop the run 실행을 멈춤 더 진행하면 위험할 때
Request review 사람이 볼 때까지 대기 자동으로 정하면 안 되는 판단
Keep both 같은 이름을 둘 다 남김 덮어쓰면 안 될 때
Overwrite 같은 이름을 덮어씀 늘 최신만 있으면 되는 때. Destination file exists 에서만 고를 수 있습니다

이슈마다 고를 수 있는 조치가 다릅니다. 위 표는 조치 열두 가지 전체이고, 창에서 한 이슈의 목록을 열면 그중 둘에서 넷만 나옵니다. 없는 조치는 그 이슈에 쓸 수 없다는 뜻입니다.

이슈 고를 수 있는 것
Insufficient storage Keep retrying / Skip this device / Stop the run
Recovery not progressing Keep retrying / Request review / Skip this device / Stop the run
Source changed Transfer the file again / Skip the file / Stop the run
Source deleted Skip the file / Stop the run
Source file in use Retry later / Skip the file
Destination file in use Retry later / Skip the file
File system naming conflict Skip the file / Stop the run
Schedule overlap Skip this run / Queue one
Deadline missed Continue / Stop the run

Destination file exists 는 이 창에서 고르지 않습니다. 값(Keep both / Skip the file / Overwrite)은 단계의 저장 옵션에서 정하고 창은 그 결과만 보여 줍니다.

Request review 로 둔 이슈가 생기면 Assurance 화면의 Runs requiring attention 에 Pending approval 로 잡힙니다. 카드에 N devices are waiting for your review 가 뜨고, 그 장비들의 재시도는 누군가 정할 때까지 멈춥니다("Retries are paused for these devices until someone decides.").

View report 를 누르면 맨 위에 검토 상자가 서고 고를 것이 셋입니다.

고르는 것 무슨 뜻
Resume 보았고 그대로 이어서 돌린다
Skip this device 그 장비만 빼고 나머지는 계속
Stop the flow run 실행을 멈춘다

고르면 검토 상자가 사라지고 Activity 에 무엇을 누가 골랐는지가 남습니다 -- Review resolved: resumed by … 꼴입니다. 기다리는 동안 Contract 는 Pending 이고 조건 줄은 Judged when the run finishes 로 비어 있습니다.

이것은 전송을 시작하기 전에 받는 승인이 아닙니다. 시작 전 승인은 Portal 쪽 기능입니다.

고른 것이 적용되지 않는 때#

조치를 고르는 것과 그 조치가 일어나는 것은 다릅니다. 사이에 끼어들 수 있는 것이 넷이고, 넷 다 화면에 표시가 납니다. 설정이 고장 났다고 판단하기 전에 먼저 보세요.

보이는 것 뜻 할 일
이슈 옆에 Applied 서버가 이 이슈를 강제합니다. 고른 값이 실제로 돕니다 없음
이슈 옆에 Coming in a later update 이 이슈는 에이전트가 강제하는데 아직 못 합니다. 고른 값이 지금은 아무 일도 하지 않습니다 표시가 사라질 때까지 그 이슈는 처리되지 않는 것으로 보세요
이슈 옆에 Agent 표시 에이전트가 강제하며, "Devices with older agents use the default handling" 이 붙습니다 에이전트를 올리거나, 구버전 장비가 다르게 움직일 것을 감안하세요
"Choices are recorded but not applied yet." 정책 전체가 관찰 모드입니다. 결정은 기록만 되고 실행되지 않습니다 이 화면에서 할 것은 없습니다. 모드는 서버 쪽에서 정합니다

놀라는 것은 관찰 모드입니다. 건너뛰었어야 할 장비가 건너뛰어지지 않습니다. Activity 에는 정책이 "했을 것" 을 적어 둡니다 -- "Policy would skip this device (observe mode)" 같은 문장이고, 이 글귀는 서버가 만듭니다. 그리고 결정 태그가 Applied 가 아니라 Observe 로 붙습니다. 정책이 돈 것처럼 보이는데 실제로는 아무 일도 없습니다.

Schedule overlap 에는 표시가 붙지 않습니다. 겹친 회차를 거르는 것은 제품이 원래 하는 일이라 따로 강제할 것이 없습니다.

정할 필요가 없는 아홉 가지#

창의 Handled by INNORIX 묶음입니다. "9 items, handled automatically" 라고 적혀 있고, 끄거나 바꾸지 않습니다.

묶음 이슈 INNORIX가 하는 일
Network Connection interrupted Automatic reconnect and resume — 다시 연결해 이어서 보냅니다
Transfer process restarted Resume from the last confirmed point — 마지막으로 확인된 지점부터
Transfer stalled Detect and reconnect — 멈춘 것을 감지해 다시 연결
Receiver backpressure Slow down and continue — 받는 쪽이 벅차면 속도를 낮춰 계속
Destination Integrity mismatch Transfer the file again; fail if it repeats — 다시 보내고 또 틀리면 실패 처리
Security Malware detected Follows the security integration setting — 연동한 보안 도구의 설정을 따름
Encryption key mismatch Fail
Retry blocked by device policy Stop the run
Audit logging unavailable Record and continue; notify admins — 기록을 남기고 계속하되 관리자에게 알림

끊김 관련 네 가지가 여기 있다는 것이 중요합니다. 회선이 끊어져도 이어서 전송되는지 묻는 고객에게는 이 묶음이 답입니다. 설정하지 않아도 동작합니다.

업무 상황별 설정 예시#

상황 바꿀 것 왜
매장 단말 배포, 일부는 늘 꺼져 있음 Insufficient storage → Skip this device 한 매장 때문에 전국 배포가 밤새 매달리지 않게
생산 설비 레시피, 잘못된 파일이 가면 안 됨 Source changed → Stop the run 보내는 중 원본이 바뀌면 멈추고 사람이 확인
야간 로그 수집, 다음 날 아침이 기한 Schedule overlap → Skip this run (기본값 유지) 어제 것이 안 끝났으면 오늘은 거르는 편이 안전
금융 증빙 전송 Destination file exists → Keep both (기본값 유지) 덮어쓰기로 증빙이 사라지면 안 됨
의료 영상 Source file in use → Retry later 촬영 중인 파일은 끝나면 가져오면 됨

결과 읽기#

정책이 작동하면 Assurance Report에 남습니다. 실제 예입니다.

Signage update · 50 devices
Transfer Status   Success     49 / 50    1 skipped
Contract Status   Satisfied   All 4 conditions met

Conditions                                       All 4 conditions met
  ✓ Target completion      49 / 49 targets   1 skipped   ≥ 95%   Passed
  ✓ File accuracy          49 passed  MD5                        Passed
  ✓ Stored at destination  49 / 49                               Passed
  ✓ Security & evidence    no violations                         Passed

Devices   50 devices    Skipped (left out of the rate) 1    Completed 49
Issues & Recovery   1 recorded event · 3 recovery attempts · on 1 device
                    1 unresolved
Activity   8 events · 1 policy decision

반드시 이해해야 할 것 — 건너뛴 장비는 분모에서 빠집니다#

위 예에서 대상은 50대인데 Target completion 이 49 / 49 입니다. 건너뛴 한 대가 비율 계산에서 제외되었습니다. 그래서 95% 조건을 통과했습니다.

위의 두 블록은 장비를 다르게 묶고 있습니다. 이쪽은 Skipped 와 Completed, 아래 깨끗한 실행은 On time 입니다. 결과가 아니라 계약을 따릅니다. 기한을 걸면 Late 와 On time, 걸지 않으면 Completed, Completed with issues, Not started 입니다. Skipped 와 Failed 는 어느 쪽에서나 따로 섭니다. 자세한 것은 장비별 전송 결과와 누락 확인하기 에 있습니다.

이것은 의도된 동작입니다. 정책이 "이 장비는 건너뛴다" 고 정했으니 성공 판정에서도 빼는 것입니다. 다만 "50대 중 49대가 받았는데 100% 성공" 으로 읽힐 수 있으니, 운영 보고에는 Devices 의 Skipped 수를 함께 적어야 합니다.

건너뛴 장비를 그냥 두면 안 됩니다. Issues & Recovery 의 Unresolved 가 그것을 알려 줍니다. 그 장비는 다시 보내기 로 따로 채웁니다.

No issues 가 "아무 일도 없었다" 는 뜻은 아닙니다#

어떤 기록은 이슈가 아니라 알림입니다. 같은 이름 파일이 name(1) 로 저장된 것, 파일명이 정규화된 것, 타임스탬프가 넘어가지 않은 것, 저장 경로가 바뀐 것 같은 일입니다. 전송이 규칙대로 처리했으므로 서버가 결과에서도, 셈에서도, Issues & Recovery 에서도 빼 버립니다.

그래서 이름이 겹친 파일을 전부 번호를 붙여 저장한 실행은 Recovery: Verified, Contract: Satisfied, Issues & Recovery: No issues 로 뜹니다. 이름이 바뀌었다는 사실이 그 화면 어디에도 없습니다.

Activity 에는 남아 있습니다. "이름이 바뀐 것이 있나, 타임스탬프가 빠진 것이 있나" 는 거기서만 답할 수 있습니다. 이렇게 다루는 것이 열두 가지이고 File name conflict(DST-03), Duplicate file delivery(DST-02), File name normalized(SRC-12), Timestamp not preserved(DST-13) 등이 들어갑니다.

Keep both 을 골랐을 때 특히 중요합니다. 동작은 하는데 눈에 띄는 자리에는 기록이 없고, 목적지에는 번호 붙은 사본이 조용히 쌓입니다.

문제가 없었을 때#

Devices   100 devices   On time 100
Issues & Recovery   No issues

No issues 이면 정책이 한 번도 발동하지 않은 것입니다.

오류와 예외#

무엇이 보이나 뜻 할 일
배지가 Defaults apply 설정을 못 불러왔습니다 권장값으로 돕니다. 서버 연결을 확인합니다
Pending approval 로 멈춰 있음 Request review 로 둔 이슈가 생겼습니다 View report 의 검토 상자에서 Resume, Skip this device, Stop the flow run 중 하나를 고릅니다
1 unresolved 가 남음 복구되지 않은 이슈가 있습니다 리포트에서 어떤 이슈인지 보고 해당 장비를 따로 처리합니다
Deadline missed 인데 전송은 계속됨 INNORIX 권장값이 Continue 입니다 멈춰야 한다면 Stop the run 으로 바꿉니다
같은 이슈가 매일 반복됨 설정이 아니라 환경 문제입니다 장비 상태와 디스크를 봅니다. 조치를 바꿔 덮지 않습니다

운영할 때 주의할 것#

  • Keep retrying 를 기한과 함께 쓰면 충돌합니다. 계속 재시도하다 기한을 넘기면 Contract는 위반입니다. 기한이 중요한 Flow에서는 Skip this device 가 맞을 때가 많습니다.
  • 파일을 건너뛰는 것과 장비를 건너뛰는 것은 계약에서 결과가 다릅니다. 저장 공간이 없는 장비를 Skip this device 로 뺀 실행은 그 장비가 분모에서 빠져 계약이 Satisfied 로 끝났습니다. 반면 원본이 바뀌어 Skip the file 로 파일 하나를 뺀 실행은 Stored at destination 이 어긋나 계약이 Violated 가 되었습니다. 둘 다 "건너뛴다" 고 읽히지만 판정이 반대입니다.
  • Retry later 도 결국 건너뜁니다. 기다리다 안 되면 그 파일을 빼고 가므로 위의 Skip the file 과 같은 결말이 됩니다. Activity 의 정책 결정에 몇 번 시도하고 건너뛰었는지가 남습니다.
  • Skip this device 는 분모를 바꿉니다. 위에 적은 대로입니다. 비율 조건을 느슨하게 만드는 효과가 있으니 Required devices 로 핵심 장비를 따로 묶어 두세요.
  • Stop the run 은 신중하게. 장비 하나의 문제로 1,200대 배포가 통째로 멈춥니다.
  • 기본값을 먼저 믿어 보세요. INNORIX recommended 는 대부분의 환경에 맞게 정해져 있습니다. 운영하며 실제로 걸리는 것만 바꾸는 편이 낫습니다.
  • 바꾼 설정은 다음 실행부터 적용됩니다.
  • 조치를 바꾸기 전에 Activity 줄의 N policy decisions 를 보세요(하나면 1 policy decision). 실제로 얼마나 자주 발동하는지 알 수 있습니다.

업종별 활용#

업종 어떻게 쓰나
제조 레시피와 설비 설정은 Source changed → Stop the run. 잘못된 파일이 설비에 가는 것이 가장 큰 위험
유통 매장 단말은 Insufficient storage → Skip this device. 영업시간 외 창이 짧아 기다릴 수 없음
금융 덮어쓰기 금지가 원칙이라 Keep both 유지. Audit logging unavailable 이 자동으로 관리자에게 알리는 것을 감사에 활용
의료 촬영 중 파일은 Retry later. Integrity mismatch 는 자동 처리라 따로 둘 것이 없음
공공, 국방 Request review 를 넓게 써서 자동 판단을 줄이고 사람이 결정
방송 송출 기한이 절대적이라 Deadline missed → Stop the run 으로 바꿔 늦은 파일이 나가지 않게