🛠️ 디버깅을 잘하는법?

🤝 페어 디버깅 경험

제가 일을 하며 있었던 하나의 에피소드에 대해 얘기해보려고 합니다.
저는 제 업무를 보고 있던 중 한가지 긴박한 슬랙이 오게 됩니다.

⚠️ 문제 상황 : 메이크샵 자동발송 누락

• 특정 주문건이 배송준비중 상태로 남음
• 다른 주문건은 정상적으로 발송 처리됨

정리하자면 API를 통해 데이터를 넘겼는데 일부만 반영된 상황이였죠

저는 그 질문을 듣고 10초 채 되지 않아 이렇게 답변을 드렸습니다.

그러자 화진님은 당황하여 얼굴에 물음표가 가득하게 됩니다.
이 에피소드를 통해 디버깅 역량을 키우기 힘든 이유를 말해주기도 합니다.

❗ 디버깅 역량을 키우기 힘든 이유

실타래처럼 엉켜있던 이 문제에 대해 문제와 해결 방법만 보이지 그 안에 어떤 인지적 과정이 있었는지 알 수 없습니다 나스를 보고 판매처에 메일을 보내라는 판단과 의사결정을 어떻게 할 수 있었는지 숨겨져 있었던 것 처럼요

돌이켜보면 그 질문을 들었을 때 제 머리 속에는 이러한 과정이 벌어졌었습니다

1. 발송이 누락되었으면 제대로 된 발송 요청을 했는지 알아야 하고
2. 포팅 판매처의 모든 발송 로그는 나스에 있기 때문에 이걸 통해서 확인 할 수 있다.
3. 발송 로그를 확인 후 제대로 된 요청을 보냈다면 그건 API를 받는 판매처의 문제일 것이다.
4. 그렇다면 판매처로 문의해야 한다.

제 머릿속에서 일어났었던 인지적 과정을 다시 정리해보면 다음과 같습니다

🧩 행동 뒤에 숨은 인지적 과정 파악하기

1. 단서: 전체의 주문이 안넘어간 것이 아니고 특정 주문만 넘어가지 않았다?
2. 과거 경험과 유사성: 발송이 제대로 되지 않는 경우 발송 데이터를 만드는 과정 아니면 판매처에서 제대로 못 받았던게 원인이던데
3. 사전지식: 포팅 판매처의 모든 통신 로그는 나스를 통해 기록하고 있어
4. 대안: 데이터가 제대로 만들어지지 않은 상태에서 넘어간거라면 데이터를 만드는 부분의 로직을 살펴봐야겠어

제가 방금 전 셀프로 분석했던 방법은 인지심리학계의 거장인 Gary Klein이 만들어 논문으로 발표한
Critical Decision Method 줄어서 CDM이라고 부르는 기법입니다.
이 CDM은 인지 작업 분석이라는 기법 중 하나입니다 다양한 질문을 통해 복잡한 상황에서 전문가들이 의사결정을 어떻게 내리는지 분석하고 이해해기 위해 개발된 기법입니다.

물론 이 기법을 이해하고 이러한 판단을 내린 것은 아니지만 자기도 모르게 이런 과정들을 수행하고 있었다는것이죠

🛠️ 디버깅의 3단계

1. 원인 파악
2. 문제 해결
3. 사후 처리

디버깅라는 행위를 크게 삼단계로 보면 이렇습니다.

실제로 디버깅을 하다보면 이 세단계에 쏟는 시간과 노력은 달라질 수 있습니다.
어느날은 원인은 금방 찾지만 문제를 해결하는데 하루 종일 걸리는 날도 있고 또 어떤 하루는 원인만 파악하는데 하루가 간날도 있습니다.

하지만 저는 이 세가지 단계 중 원인 파악의 과정이 디버깅 실력을 늘리는데 큰 역할을 한다고
생각하여 이 과정에 대해 상세히 말해보려 합니다.

📝 문제 원인 파악을 위한 5단계 가이드

1. 문제 정의
2. 정상 동작 정의
3. 최소 재현 환경 구축 및 관찰
4. 차이를 발생시키는 다양한 원인 탐색
5. 가설 설정 및 검증

문제의 원인을 파악하는 방법을 5단계로 나눠 보았습니다.
이러한 과정을 거치다 보면 우리는 자연스럽게 심적 표상(Mind Reperesentation)이라는 것이
쌓이게 됩니다.

심적표상의 정의에 대해 알아보면

🧠 심적 표상(Mind Representation)

• 심적 표상은 장기기억에 저장되어 있으며, 일반적인 상황이 아니라 특정 유형의 상황에서 신속하고 효율적으로 반응하기 위해 활용하는, 우리 머릿속에 이미 존재하는(사실, 이미지, 규칙, 관계 등의) 정보 패턴이다.
• 전문가와 일반인의 차이는 심적 표상의 양과 질이다. 전문가는 연습을 통해서 아주 복잡하고 다양한 심적 표상을 축적한다. 특정 상황에서 남들보다 빠르고 정확한 결정을 내리고, 신속하게 대응할 수 있다.

📝 문제 원인 파악을 위한 5단계 가이드

1. 문제 정의
2. 정상 동작 정의
3. 최소 재현 환경 구축 및 관찰
4. 차이를 발생시키는 다양한 원인 탐색
5. 가설 설정 및 검증

제가 이 5가지의 가이드를 5단계라고 표현하긴 했지만 우리는 실제 디버깅을 하며 이 과정을 순차적으로 실행하지는 않습니다.
예를 들어 정상 동작을 정의하고 최소 재현 환경을 구축하며 관찰하다 보니 정상 동작의 정의가 달라져 다시 정의하고 나아가는 식이죠 그렇게 때문에
이 단계를 꼭 순차적으로 실행해야 할 의무는 없다는걸 짚어드리며 각 단계에 대해 설명해보도록 하겠습니다.

📝 문제 원인 파악을 위한 5단계 가이드

1. 문제 정의 🔍

   • 이정표 만들기: 내가 지금 어떤 문제를 풀려고 하는지 명확히 한다.
   • 중간회고할 때마다 길을 잃지 않도록 하는 이정표를 설정한다.
   • 다른 사람들에게 문제를 설명하고 공유할 때 유용하다.
   • 이게 없으면 당장 중요하지 않은 문제에 빠져서 시간을 허비할 수 있음

2. 정상 동작 정의 ✅

   • 현재 벌어지는 일을 관찰하고 알고 있는 정보를 정리한다.
   • ‘올바른 동작’을 테스트코드처럼 Given-When-Then 패턴으로 작성한다.
   • 정상적인 상황에서 어떤 조건, 순서로 일이 벌어져야 하는지 정의한다.

3. 최소 재현 환경 구축 및 관찰 🛠️

   • 문제가 발생한 환경과 동작을 그대로 따라하며 재현한다.
   • 격리하며 패턴을 관찰하고 문제를 특정한다.
   • 직접 재현이 어렵다면 로그 심기, 오류 리포트 참고 등을 통해 조건을 파악한다.

4. 차이를 발생시키는 다양한 원인 탐색 🔎

   • 떠오르는 원인을 추상적이든 구체적이든 최대한 많이 나열한다.
   • 다양한 옵션을 검토하고, 다른 사람들과 논의하거나 추가 정보를 수집한다.

5. 가설 설정 및 검증 🧪

   • 작은 변경을 가하면서 가설대로 현상이 변화하는지 확인한다.
   • 가설이 틀렸다면 원인을 기록하고 다음 가설을 세운다.
   • 검증 가능한 형태로 가설을 정리한다.
   • 예: A가 B로 되어있어 C 현상이 발생한다면, A를 D로 바꿨을 때 C가 해결된다.

이 다섯 단계를 이해하고 계속 반복하다 보면 우리에게는 수많은 심적표상이 쌓일 것이고 커질 것이라고 생각듭니다.

✨디버깅을 잘하는 사람은 디버깅마다 심적 표상이 쌓인며 똑똑해진다.

이 심적표상이 쌓이게 되면 디버깅을 할때에도 여러 가지를 살펴보는 것이 아닌 정리되어있는
심적표상을 하나씩 꺼내 쓸 수 있게 되는 것이죠

📚 맺으며

디버깅을 잘하는 방법은 단시간에 쉽게 얻을 수 있는 지름길 같은 것은 아닙니다.
많은 경험을 쌓고, 다양한 오류를 직접 마주하면서 조금씩 익혀야 합니다.팁을 조금 드리자면,
자신보다 더 많은 경험과 지식을 쌓은 분들에게 적극적으로 질문하는 것도 좋은 방법입니다.
그분들이 오랜 노력 끝에 얻은 귀중한 경험과 지식을 짧은 시간 안에 배울 수 있을테니까요.

• 디버깅을 잘하는 사람이 부리는 마법은, 사실 누구나 배울 수 있는 기술입니다.
• 문제를 해결해가는 과정을 즐기고 내걸로 만들어 연습하며 좋은 심적 표상을 쌓으면
• 누구나 디버깅 역량을 효과적으로 늘릴 수 있습니다.

감사합니다.

📚 출처:

• Critical Decision Method(CDM)
• globalcognition.org
• 디버그-뜻과-개념-설명
• 심적 표상이란?
• 1만 시간의 법칙이 말하지 않은 것