이 문서가 해결하는 문제#
전송이 Completed 로 끝났는데도 업무는 실패한 경우가 있습니다.
- 새벽 배포가 영업 시작 전 06:00까지 끝나야 하는데 06:12에 끝났습니다. 파일은 다 갔지만 지점은 구버전으로 문을 열었습니다.
- 1,000대 중 998대가 받았습니다. 못 받은 둘이 하필 기준 장비였습니다.
- 파일 수는 맞는데 하나가 전송 중 깨졌습니다.
Assurance Contract는 "무엇이 충족되어야 이 업무가 성공인가" 를 미리 적어 두는 자리입니다. 적어 두면 INNORIX가 실행이 끝날 때마다 그 조건으로 판정하고, 전송 상태와는 별개로 Satisfied 또는 Violated 를 남깁니다.
이 문서 하나로 조건을 정의하고, 결과를 읽고, 위반이 났을 때 무엇을 볼지까지 끝낼 수 있습니다.
적용 대상과 대표 상황#
| 누가 | 언제 쓰나 |
|---|---|
| 운영 담당자 | 매일 도는 배포, 수집이 정해진 시각까지 끝나야 할 때 |
| 시스템 관리자 | 특정 장비가 반드시 받아야 하는 배포를 운영할 때 |
| 품질, 감사 담당자 | 전송이 끝났다는 것을 넘어 무결성까지 증빙해야 할 때 |
대표 상황 셋입니다.
- 기한이 있는 배포 — 영업 시작 전, 생산 교대 전, 방송 송출 전
- 반드시 받아야 하는 장비가 있는 배포 — 기준 장비, 주 계통 서버, 관제 단말
- 무결성을 증빙해야 하는 전송 — 의료 영상, 검사 데이터, 금융 증빙
시작 전 준비#
- Flow 하나. 단계와 대상이 정해져 있어야 합니다. 단계가 없으면 저장할 때 거부됩니다.
- Flow를 수정할 수 있는 권한.
- 대상 장비가
Connected상태일 필요는 없습니다. 조건은 실행 시점에 판정합니다.
설정하는 자리와 순서#
Flows 에서 Flow를 고르고 Edit flow 를 누릅니다.
편집기 위쪽 도구줄의 Assurance 배지를 누릅니다. 배지에 지금 상태가 적혀 있습니다.
배지 글자 뜻 RecommendedINNORIX 권장값 그대로 Workspace defaults워크스페이스 기본값을 물려받음 Custom · N물려받은 값에서 N개를 바꿈 Defaults apply설정을 불러오지 못했습니다. 권장값으로 실행됩니다 배지의
Custom · N은 이 Flow 가 물려받은 값과 비교한 수입니다. 워크스페이스 기본값이 있으면 그것까지 포함한 값이 비교 기준이므로, 워크스페이스가 정해 둔 것은 이 수에 들어가지 않습니다.창 안쪽 Error handling 줄의
N custom은 기준이 다릅니다. 그쪽은 INNORIX 권장값과 비교하므로 워크스페이스가 정해 둔 것까지 셉니다. 같은 화면의 두 수가 서로 다를 수 있고, 그것이 정상입니다. 자세한 것은 문제가 생겼을 때 할 일을 미리 정해 두기 에 있습니다.배지 아래에 지금 값이 두 줄로 요약됩니다 —
Success conditions의 요약 줄에 조건이 가운뎃점으로 이어 적히고(All targets · No deadline · Hash verified (MD5)), 그 아래Error handling줄에 그쪽 상태가 적힙니다. 창을 열지 않고도 지금 무엇으로 판정하는지 읽을 수 있습니다.Assurance 창이 열립니다. 위가 Success conditions, 아래가 Error handling 입니다. 이 문서는 위를 다룹니다. 아래는 문제가 생겼을 때 할 일을 미리 정해 두기 에 있습니다.
조건을 정하고 Apply 를 누릅니다. 창을 닫은 뒤 Save & activate 로 Flow를 저장해야 반영됩니다. 편집기 위쪽 단추는 넷입니다 —
Cancel(버리기),Save draft(활성화하지 않고 저장),Start now(지금 한 번 실행),Save & activate(저장하고 활성화).Save draft로 저장하면 조건은 남지만 실행되지 않습니다.처음 활성화할 때는 확인 단계가 한 번 뜹니다. 어떤 조건으로 판정할지 보여 주고 넘어갑니다.
되돌리기 두 가지.
Success conditions줄 오른쪽의 Reset to defaults 는 물려받은 값으로 돌립니다. 워크스페이스 기본값이 있으면 그것으로, 없으면 INNORIX 권장값으로 갑니다. 이것은 성공 조건만이 아니라 아래Error handling까지 함께 되돌립니다. 창의 Cancel 은 창을 열었을 때의 값으로 돌려놓습니다. 둘은 다릅니다.
조건 항목과 고르는 기준#
Target completion — 몇 대가 받아야 성공인가#
| 선택지 | 뜻 | 언제 |
|---|---|---|
All targets |
전부 받아야 성공 | 대상이 적고 하나도 빠지면 안 될 때 |
Percentage |
고르면 Percent 칸이 열립니다. 1에서 100까지이고 뒤에 % 가 붙습니다 |
대상이 많고 일부 오프라인이 일상일 때 |
Number of devices |
고르면 Devices 칸이 열립니다. 뒤에 devices 가 붙습니다 |
"최소 몇 대만 살아 있으면 된다" 가 업무 기준일 때 |
수천 대 현장 장비에 All targets 를 걸면 늘 한두 대가 꺼져 있어 매번 Violated 가 납니다. 그러면 경보가 의미를 잃습니다. 비율로 걸고, 꼭 필요한 장비는 아래 Required devices 로 따로 묶는 편이 낫습니다.
Deadline — 언제까지 끝나야 하는가#
| 선택지 | 뜻 |
|---|---|
None |
기한을 보지 않음 |
After start |
고르면 Minutes 칸이 열립니다. 1에서 10080까지이고 뒤에 min 이 붙습니다. 실행이 시작된 때부터 셉니다 |
Time of day |
고르면 Time 칸이 열립니다. 하루 중 시각입니다 |
예약 실행이면 Time of day 가 업무와 맞습니다. 수동 실행이 섞이면 After start 가 안전합니다.
File check — 무엇으로 파일이 맞다고 보는가#
| 선택지 | 뜻 |
|---|---|
Hash (MD5) |
받은 파일마다 원본과 MD5 해시를 비교합니다 |
Size and count |
크기와 개수만 맞으면 통과 |
창의 설명이 그대로 적어 둡니다. "Each received file is compared with the source by its MD5 hash."
해시는 확실하지만 파일마다 계산이 듭니다. 수백만 개 소형 파일을 매일 옮기면서 무결성 증빙이 필요 없다면 Size and count 로 충분합니다. 의료, 금융, 검사 데이터는 Hash (MD5) 를 권합니다.
Required devices — 빠지면 안 되는 장비#
Change 를 눌러 목록을 열고, 고른 뒤 Done 으로 닫습니다. 장비가 많으면 Search devices 로 찾습니다. 아직 아무것도 고르지 않았으면 값이 None 으로 보입니다.
Flow 에 대상 장비가 없으면 고를 것이 없습니다. 그때는 창이 "Add target devices to the flow first." 라고 적습니다. 먼저 단계에 대상을 놓고 오세요.
창이 그대로 적어 둡니다.
The contract is violated if any of these does not complete, whatever the target completion says.
즉 At least 95% of targets 를 걸어 두어도, 여기 고른 장비가 하나라도 못 받으면 Violated 입니다. 비율과 함께 쓰는 것이 핵심입니다.
Advanced conditions — 접혀 있고 처음에는 Off#
펼치면 셋이 있습니다.
| 항목 | 뜻 |
|---|---|
Maximum retries |
재시도 횟수 상한 |
Maximum interruption (minutes) |
끊겨 있던 시간의 상한 |
No unresolved issues at the end |
끝났을 때 복구되지 않은 이슈가 없어야 함 |
창이 적어 둔 단서가 중요합니다.
Empty fields are off. Retries continue past a limit; only the contract result changes.
재시도 한도를 걸어도 재시도가 멈추지 않습니다. 한도를 넘으면 Contract 판정만 위반으로 바뀝니다. "세 번까지만 시도하고 포기하라" 는 뜻이 아니라 "세 번을 넘겼으면 이 업무는 정상이 아니다" 라는 뜻입니다. 재시도 자체를 멈추려면 문제가 생겼을 때 할 일을 미리 정해 두기 의 조치를 Keep retrying 이 아닌 것으로 바꿔야 합니다.
빈 칸은 끈 것으로 봅니다. 위 넷으로 모자랄 때만 씁니다.
Mandatory conditions — 끄지 못하는 것#
창이 적어 둡니다. "Always checked: stored at destination, required policies and run record."
목적지에 실제로 저장되었는지, 요구된 정책과 실행 기록이 남았는지는 항상 검사합니다. 설정에서 뺄 수 없습니다.
업무 상황별 설정 예시#
| 상황 | Target completion | Deadline | File check | Required devices |
|---|---|---|---|---|
| 전국 1,200개 매장 새벽 배포, 영업 06:00 시작 | Percentage 98% |
Time of day 05:30 |
Size and count |
물류 거점 서버 4대 |
| 생산 설비 20대 레시피 배포, 교대 전 | All targets |
After start 20분 |
Hash (MD5) |
비움(전부가 필수) |
| 검사 장비 300대 측정값 야간 수집 | Percentage 95% |
Time of day 07:00 |
Hash (MD5) |
기준 장비 3대 |
| 지사 서버 12곳 일일 로그 수집 | Number of devices 10 |
After start 60분 |
Size and count |
본사 집계 서버 |
결과 읽기#
실행이 끝나면 Runs 목록과 Assurance 화면에 두 가지가 따로 섭니다.
| 칸 | 무엇 |
|---|---|
Transfer Status |
파일이 갔는가 — Success, Partial, Failed, In Progress, Pending |
Recovery |
문제를 어떻게 넘겼는가 — Verified, Recovered, Recovering, Needs Attention, Failed, Not evaluated |
Contract Status |
업무가 성공인가 — Satisfied, Violated, Indeterminate, At Risk, Pending |
가운데 것은 리포트의 칩 셋에서는 Recovery 로, 실행 목록의 칸에서는 Assurance 로 적힙니다. 같은 값입니다.
셋은 서로 다를 수 있습니다. 그것이 이 기능의 핵심입니다.
실제 예입니다. 매일 도는 Nightly backup 이 기한 30분으로 걸려 있습니다.
Transfer Status Success 100 / 100
Contract Status Violated 1 condition failed
All files were delivered, but the deadline was missed by 12 min.파일은 100대 전부 갔습니다. 그런데 10:00 기한을 12분 넘겨 Contract는 위반입니다.
Assurance Report#
실행 줄에서 리포트를 열면 조건마다 통과 여부가 섭니다.
조건 줄의 판정은 둘이 아니라 넷입니다.
| 줄 머리 | 판정 | 언제 |
|---|---|---|
✓ |
Passed |
확인했고 충족됨 |
✕ |
Failed |
확인했고 미달 |
! |
Not verified |
확인할 수는 있는데 답이 오지 않음 |
– |
Not checked |
확인할 것이 없음. 아무것도 전달되지 않은 경우 |
Not verified 와 Not checked 는 둘 다 Contract Status 를 Indeterminate 로 둡니다. 통과도 실패도 아닙니다.
Conditions 1 condition failed
✕ Completion deadline 10:12 (+12m) by 10:00 Failed
✓ Target completion 100 / 100 targets all Passed
✓ File accuracy 100 passed MD5 Passed
✓ Stored at destination 100 / 100 Passed
✓ Security & evidence no violations Passed
Required devices를 걸어 두면 조건 줄이 하나 더 섭니다. 위 블록에 없는 것은 그 실행에 지정한 장비가 없었기 때문입니다. 걸려 있으면 리포트에 이렇게 붙습니다.✕ Required devices 1 / 2 missing Edge 0020 (failed) 2 devices Failed"비율이 충족되어도 계약은 위반" 이 화면에서는 이렇게 보입니다. 그 실행에서
Target completion은19 / 20 targets ≥ 90% Passed로 통과했는데 이 줄이 실패했고 계약은Violated가 되었습니다. 실패한 장비는 장비 표에도required로 표시됩니다.
그 위에 원인과 다음 할 일이 한 줄씩 적힙니다.
Primary Cause Branch-0100 · finished 12m late · +28 more devices
Recommended Action Find what slowed the transfer under Devices and Activity,
or give the flow more time in its Assurance settings.아래에는 장비 분포(Late 29, On time 71)와 Issues & Recovery 가 함께 섭니다. 그 줄은 기록된 이벤트 수, 복구 시도 횟수, 몇 대에서 있었는지를 · 로 잇고, 아무 일도 없었으면 No issues 라고만 적힙니다.
정상으로 끝난 모습#
Transfer Status 가 Success 이고 Contract Status 가 Satisfied 이면 업무까지 성공입니다. Assurance 화면 위쪽의 Contract compliance rate 가 통과 비율을 누적해 보여 줍니다.
오류와 예외#
| 무엇이 보이나 | 뜻 | 할 일 |
|---|---|---|
배지가 Defaults apply 이고 눌리지 않음 |
설정을 불러오지 못했습니다. 권장값으로 실행됩니다 | 서버 연결을 확인합니다. 그동안 전송은 정상으로 돕니다 |
| 저장할 때 잘못된 값 거부 | 조건 값이 범위를 벗어났습니다 | 비율과 기한 값을 확인합니다 |
| 필수 장비가 최종 대상이 아니라고 거부 | Required devices 에 고른 장비가 이 Flow의 마지막 단계 대상이 아닙니다 |
대상에 넣거나 필수에서 뺍니다 |
| 버전 충돌로 거부 | 다른 사람이 먼저 저장했습니다 | 창을 닫고 다시 열어 최신 값 위에서 고칩니다 |
| 단계가 없다고 거부 | Flow에 단계가 없습니다 | 단계를 먼저 만듭니다 |
Contract Status 가 Indeterminate |
판정에 필요한 정보가 모자랍니다 | 리포트에서 어떤 조건이 확인 불가인지 봅니다. 구버전 에이전트가 무결성을 보고하지 않는 경우가 흔합니다 |
Contract Status 가 At Risk |
아직 도는 중인데 기한을 넘길 것 같습니다 | 끝나기 전에 손쓸 수 있습니다 |
운영할 때 주의할 것#
- 기한은 업무 기한보다 앞에 둡니다. 영업이 06:00에 시작하면 기한을 06:00이 아니라 05:30에 겁니다. 위반이 나도 손쓸 30분이 남습니다.
All targets를 수천 대에 걸지 않습니다. 매번 위반이 나면 경보를 아무도 보지 않게 됩니다. 비율 +Required devices조합이 현실적입니다.- 해시 검사는 비용이 있습니다. 소형 파일이 수백만 개면 전송 시간이 늘어납니다. 증빙이 필요한 Flow에만 켭니다.
- 조건을 바꾸면 그다음 실행부터 적용됩니다. 이미 끝난 실행의 판정은 바뀌지 않습니다.
- 워크스페이스 기본값을 먼저 정해 두면 Flow마다 다시 고르지 않아도 됩니다. 배지가
Workspace defaults로 뜹니다. - 전송 상태만 보고 "다 됐다" 고 보고하지 않습니다. 이 기능을 쓰는 이유가 그것입니다.
업종별 활용#
| 업종 | 어떻게 쓰나 |
|---|---|
| 제조 | 교대 시작 전 기한, 라인 기준 설비를 Required devices 로. 레시피는 Hash (MD5) |
| 금융 | 영업 시작 전 기한, 지점 서버 비율 + 기간계 서버 필수. 증빙 때문에 해시 |
| 유통 | 개점 전 기한, 물류 거점을 필수로. 매장 단말은 비율로 |
| 의료 | 영상 전송에 해시 필수. 판독 서버를 Required devices 로 |
| 공공, 국방 | Mandatory conditions 의 실행 기록이 감사 증빙이 됩니다 |
| 방송 | 송출 시각을 기한으로. 송출 서버를 필수로 |
함께 보기#
- 문제가 생겼을 때 할 일을 미리 정해 두기 — 같은 창의
Error handling - 다시 보내기 네 가지를 구분해서 쓰기 — 위반이 났을 때 무엇을 다시 보낼지
- 장비별 전송 결과와 누락 확인하기 — 어느 장비가 늦었는지 찾기
- 전송된 파일의 해시값으로 무결성 자동 검증하기