문서 자동 업데이트 크론은 무엇을 하나?
대상은 크론 작업 하나입니다. 주기 표기는 `55 7 * * *`, 매일 오전 7시 55분에 한 번 돕니다. 하는 일은 두 단계입니다. 먼저 그동안 만든 자산(스크립트·문서·운영 규칙)을 훑고, 그다음 이력서에서 바뀐 부분에 해당하는 문장만 고쳐 씁니다. 작업 이름에 붙은 “델타”가 바로 이 “바뀐 부분”입니다.
이 회사는 이런 반복 작업마다 목록 파일에 한 줄씩 기록을 남깁니다. 주기, 최근 30일 실행 횟수, 그 횟수를 센 방법, 사람이 같은 일을 하면 걸리는 시간, 그 시간의 근거와 근거 등급, 마지막으로 둘을 곱한 대체 시간입니다. 문서 자동 업데이트 작업의 기록은 아래와 같았습니다.

처음 이 기록을 읽었을 때는 의심할 데가 없어 보였습니다. 매일 도는 작업이 30일 동안 31회 돌았고, 사람이 하면 20분 걸릴 일이니 10.3시간을 아꼈다는 계산입니다. 곱셈 자체에는 틀린 데가 없습니다. 문제는 곱셈의 두 인수, 즉 31회와 20분이 각각 무엇을 센 숫자인지였습니다.
작은 회사에서 이런 숫자는 생각보다 자주 쓰입니다. 자동화를 더 늘릴지, 어떤 작업을 먼저 손볼지 정할 때 “한 달에 몇 시간을 아끼는가”가 기준이 되기 때문입니다. 근거가 약한 숫자가 그 기준 자리에 앉으면, 우선순위도 함께 틀어집니다.
10.3시간은 어떻게 나온 숫자인가?
대체 시간은 실행 횟수에 회당 사람 시간을 곱한 값입니다. 이 작업은 31회 × 20분이고, 결과를 시간으로 바꾸면 10.3시간입니다. 두 인수의 출처는 서로 다릅니다.
- 실행 31회: 기계가 센 값입니다. 셈법 칸에는 “공용 로그 grep”이라고 적혀 있습니다. 여러 작업이 함께 쓰는 로그 파일에서 이 작업 이름이 찍힌 줄을 찾아 센 방식입니다.
- 회당 20분: 사람이 정한 값입니다. 근거 등급 칸에는 estimate(추정)라고 적혀 있고, 근거는 “자산 훑기 12분 + 문장 반영 8분” 한 줄입니다.
- 대체 시간 10.3시간: 위 두 값의 곱입니다. 따로 잰 값이 아니므로 두 인수 중 하나만 틀려도 같이 틀립니다.

기계가 센 31회와 사람이 정한 20분이 한 줄에 나란히 놓이면, 둘이 같은 무게의 숫자처럼 보입니다. 실제로는 하나는 로그에서 셌고 하나는 머릿속에서 나왔습니다. 결과인 10.3시간은 둘 중 더 약한 쪽, 즉 추정치인 20분의 신뢰도를 그대로 물려받습니다.
같은 20분이 다른 작업에도 있었다
20분의 출처를 확인하려고 같은 목록의 인접 기록을 펼쳤습니다. 그러자 채용 사이트 공고를 수집하고 적합도를 판정하는 작업 3개가 똑같이 회당 20분을 쓰고 있었습니다. 첫 번째 작업의 근거는 “검색·목록 훑기 12분 + 상위 공고 열람·기록 8분”이었고, 나머지 두 개의 근거 칸에는 “위와 동일”이라고만 적혀 있었습니다.

문서 자동 업데이트의 “12분 + 8분”과 공고 수집의 “12분 + 8분”은 쪼갠 방식까지 같습니다. 앞의 12분은 무언가를 훑는 시간이고 뒤의 8분은 결과를 적는 시간입니다. 하는 일은 전혀 다른데 숫자 구조가 같다면, 두 가지 가능성이 있습니다. 실제로 비슷하게 걸리거나, 한쪽 추정을 다른 쪽에 옮겨 쓴 경우입니다. 이 기록만으로는 둘 중 어느 쪽인지 가릴 수 없습니다.
이 겹침이 문제가 되는 이유는 합계에 있습니다. 공고 수집 작업 3개와 문서 자동 업데이트 1개는 각각 31회 × 20분, 10.3시간씩을 기록하고 있습니다. 네 줄의 대체 시간이 사실상 하나의 추정에 기대고 있는 셈입니다. 그 추정이 틀리면 한 줄이 아니라 네 줄이 한꺼번에 틀리고, 줄 수만큼 합계도 같은 방향으로 기웁니다.
비교를 위해 근거가 더 자세한 작업도 봤습니다. 기술블로그 1편을 쓰는 작업은 회당 120분인데, 근거가 “6,600자 이상 기술 글 1편 수기 작성 60~90분 + 검수·발행 30분”이고 라이브 9편의 실제 분량(11K~23K자)에서 역산했다고 적혀 있습니다. 같은 추정 등급이라도 역산한 출발점이 있는 추정과, 다른 작업의 근거를 그대로 쓴 추정은 무게가 다릅니다. 같은 값을 쓰는 두 작업을 다른 각도에서 뜯어본 기록은 다른 두 작업의 건당 40분이 똑같았던 사례에 정리해 두었습니다.
바뀐 것이 없는 날에도 20분을 세야 하나?
처음 세운 가정은 단순했습니다. “매일 돌았으니 매일 20분을 아꼈다.” 이 가정은 공고 수집에는 비교적 잘 맞습니다. 채용 사이트에는 매일 새 공고가 올라오고, 사람이 그 일을 맡았다면 매일 목록을 훑었을 테니까요.
문서 자동 업데이트는 성격이 다릅니다. 이 작업은 바뀐 부분만 반영합니다. 사람이 같은 일을 맡았다면 매일 아침 이력서를 열어 20분씩 고치지는 않았을 가능성이 큽니다. 무언가를 새로 만들었을 때, 혹은 몇 주에 한 번 몰아서 고쳤을 수 있습니다. 그렇다면 “사람이 하면 20분”이 맞더라도, “사람이 했을 횟수”는 31회보다 적을 수 있습니다.
실행 기록은 작업이 돌았다는 증거일 뿐, 그날 사람 몫의 일이 있었다는 증거가 아니다.
20분을 두 부분으로 나눠 보면 이 차이가 더 분명해집니다. 자산 훑기 12분은 바뀐 것이 있든 없든 매번 드는 시간이라고 볼 수 있습니다. 바뀐 게 있는지 확인하려면 어쨌든 훑어야 하니까요. 반면 문장 반영 8분은 바뀐 것이 있을 때만 드는 시간입니다. 바뀐 것이 없는 날의 8분은 아낀 시간이 아니라 원래 쓰지 않았을 시간입니다.
그런데 이 판단을 숫자로 바꾸려면, 31회 중 실제로 문장이 바뀐 실행이 몇 번이었는지 알아야 합니다. 목록 파일에는 그 칸이 없습니다. 공용 로그 grep은 작업 이름이 찍힌 줄만 세므로, 문장을 고친 실행과 훑기만 하고 끝난 실행을 구분하지 못합니다. 지금 이 자료로 말할 수 있는 것은 “10.3시간은 상한일 가능성이 있다”까지입니다. 얼마나 줄어드는지는 아직 모릅니다.
하루 한 번 도는 작업이 30일에 31회 돈 이유는 무엇인가?
두 번째 인수에도 물음표가 붙었습니다. 주기는 하루 한 번인데, 최근 30일 실행 기록은 31회입니다. 같은 셈법(공용 로그 grep)을 쓰는 공고 수집 작업 3개도 모두 31회였습니다. 셈법이 다른 작업은 30회를 넘지 않았습니다. 전용 로그로 센 리드 이메일 수집은 27회, 산출 마커로 센 기술블로그는 26회, 공용 로그 grep으로 센 판매 후보 스캔은 29회였습니다.

하루 한 번 도는 작업이 30일 안에 31회 찍히는 경우는 몇 가지를 떠올릴 수 있습니다. 집계 창의 양 끝 날짜를 모두 포함했을 수도 있고, 같은 실행이 공용 로그에 두 줄을 남겼을 수도 있고, 작업 이름이 다른 작업의 로그 줄에 우연히 섞였을 수도 있습니다. 어느 쪽인지는 이 기록에 나오지 않습니다. 확인하지 않은 원인을 하나 골라 적는 대신, 확인할 목록에 올려 두었습니다.
31회와 30회의 차이는 대체 시간으로 치면 20분, 크지 않습니다. 다만 의미는 작지 않습니다. 실행 횟수는 이 계산에서 “기계가 센 믿을 만한 쪽”으로 여겨 온 숫자였는데, 그 숫자조차 셈법을 알아야 해석할 수 있었습니다.
그래서 셈법 칸을 지우지 않고 남겨 두기로 했습니다. 같은 31회라도 전용 로그로 센 31회와 공용 로그 grep으로 센 31회는 확인해야 할 지점이 다릅니다. 셈법이 적혀 있었기 때문에 이번에도 의심할 곳을 좁힐 수 있었습니다.
이 숫자를 믿을 만하게 만들려면 무엇을 지켜야 하나?
이 회사는 품질 검사 인프라를 설계할 때 “통과를 정답의 증거로 읽지 않는다”는 원칙을 적어 두었습니다. 통과는 “검사한 것 중 걸린 게 없다”일 뿐이라는 뜻입니다. 절감 시간 계산에도 같은 원칙이 들어맞습니다. 로그에 31줄이 있다는 사실은 31번 돌았다는 사실까지만 말해 줍니다.
- 곱셈의 두 인수를 따로 표시합니다. 실행 횟수는 셈법(전용 로그·공용 로그 grep·산출 마커)을, 회당 시간은 근거 등급(estimate 등)을 같은 줄에 남깁니다. 지금 기록은 이 원칙을 이미 지키고 있고, 덕분에 이번 의심도 시작할 수 있었습니다.
- 갱신 작업은 “돈 횟수”와 “바꾼 횟수”를 따로 셉니다. 바뀐 부분만 반영하는 작업은 바꾼 실행에만 반영 시간을 붙여야 합니다.
- “위와 동일”로 근거를 대신하지 않습니다. 다른 작업의 근거를 쓰더라도 왜 같은지 한 줄을 적습니다.
- 기계 검사를 통과한 숫자도 사람이 처음 한 번은 펼쳐 봅니다. 평가 실무에서 흔히 권하는 순서처럼, 자동 판정을 짜기 전에 실제 기록 20~50건을 직접 읽어 실패 유형부터 찾는 편이 안전합니다.

숫자를 고치기 전에 정의부터 고치는 순서도 중요합니다. 바뀐 실행 수를 세지 않은 채 20분을 12분으로 낮추면, 근거 없는 추정 하나를 근거 없는 추정 다른 하나로 바꾸는 데 그칩니다.
갱신 작업의 절감 시간은 어떻게 다시 계산하나?
정의를 먼저 바꾸면 계산식도 따라 바뀝니다. 지금 식은 “실행 횟수 × 20분” 한 줄입니다. 바뀐 부분만 반영하는 작업이라면 식을 두 항으로 나누는 편이 실제 일의 모양에 가깝습니다. “실행 횟수 × 자산 훑기 12분”에 “바뀐 실행 횟수 × 문장 반영 8분”을 더하는 방식입니다.
이 식에서 첫 항은 지금 기록만으로도 계산할 수 있습니다. 31회 × 12분입니다. 둘째 항은 바뀐 실행 횟수를 모르기 때문에 아직 비어 있습니다. 바뀐 실행이 31회 전부라면 결과는 지금의 10.3시간과 같고, 하나도 없었다면 첫 항만 남습니다. 즉 지금 기록이 알려 주는 것은 정확한 값이 아니라 범위입니다. 이 범위를 좁히려면 계측이 하나 더 필요합니다.
- 실행이 끝날 때마다 한 줄을 남깁니다. 날짜, 훑은 자산 수, 바꾼 문장 수 세 칸이면 충분합니다.
- 바꾼 문장 수가 0인 줄은 “돈 실행”으로만 세고, 1 이상인 줄만 “바뀐 실행”으로 셉니다.
- 공용 로그 대신 이 작업 전용 기록을 씁니다. 다른 작업 줄과 섞일 여지를 없애면 31회 문제도 함께 확인할 수 있습니다.
- 30일이 지나면 두 항을 다시 계산하고, 목록 파일의 근거 칸에 “바뀐 실행 N회”를 함께 적습니다.
30일에 31회가 나온 이유도 같은 기록으로 가릴 수 있습니다. 날짜별로 줄 수를 세었을 때 하루에 두 줄이 찍힌 날이 있으면 중복 기록이고, 모든 날이 한 줄씩인데 날짜가 31개라면 집계 창의 경계 문제입니다. 원인을 추측으로 고르지 않고, 다음 30일 기록이 고르게 하도록 장치를 거는 셈입니다.
이 방식은 이력서 갱신에만 해당하지 않습니다. 회사 소개서, 실적 목록, 가격표처럼 “바뀐 것만 반영하는 문서”를 자동으로 고치는 작업이라면 모두 같은 함정을 안고 있습니다. 매일 돈다는 사실과 매일 사람 몫의 일이 있었다는 사실은 다른 문장이고, 절감 시간은 뒤쪽 문장으로 계산해야 합니다.
아직 못 푼 것은 무엇인가?
가장 큰 미해결은 바뀐 실행 수입니다. 최근 30일의 31회 중 이력서 문장이 실제로 바뀐 실행이 몇 번인지 아직 모릅니다. 실행마다 “바꾼 문장 수”를 한 줄 남기게 만든 뒤 다시 재야, 10.3시간이 얼마나 부풀었는지 말할 수 있습니다.
두 번째는 30일에 31회가 나온 이유입니다. 공용 로그 grep으로 센 작업 4개가 모두 31회를 기록했으므로, 원인이 작업 쪽보다 셈법 쪽에 있을 가능성을 먼저 봐야 합니다. 같은 셈법을 쓰면서 29회가 나온 작업도 있어, 셈법 하나로 다 설명할 수 있을지는 열어 봐야 압니다.
세 번째는 20분 자체입니다. 근거 등급이 estimate인 이상, 이 숫자는 사람이 같은 일을 직접 해서 잰 값이 아닙니다. 공고 수집 작업과 같은 “12분 + 8분” 구조가 실제로 비슷해서 나온 값인지도 아직 확인하지 않았습니다.
반복 업무를 크론으로 돌리기 시작했다면, “몇 번 돌았나”와 “그중 몇 번이 사람 몫의 일이었나”를 처음부터 나눠 세는 편이 쌉니다. 비슷한 업무 자동화의 효과 계산이나 실행 기록 설계를 정리해야 한다면 상담으로 문의해 주세요.