월간 리포트 자동으로 만드는 실제 순서

Pipedeck 실제 화면

작성자

카테고리:

매달 리포트 만들다가 월요일 오전이 사라진다면

매달 초에 서치콘솔, GA4, 결제 내역을 열어서 셀 복붙하며 리포트를 만들던 시절이 있다. 그 월요일 오전이 통째로 사라졌다. 숫자를 모으는 것 자체는 기계의 일인데 사람이 하고 있으니 이상했다. 그때부터 월간 운영 리포트를 크론이 뽑게 바꿨고, 지금은 새벽에 돌린 결과가 아침에 슬랙으로 온다.

다만 이 글은 “이 툴 쓰세요” 글이 아니다. 세팅한 순서와, 실패했던 지점과, 고쳐 쓰는 중인 구조까지 적는다.

이 글에서 세팅하게 될 것

  • 지표 확정부터 발송까지의 4단계 파이프라인
  • 월 1회 크론이 조용히 죽었을 때 감지하는 알림 설계
  • AI 요약이 숫자를 틀리게 말할 때 잡아내는 검증 절차

월간 리포트 자동화, 어떤 순서로 세팅하나

나는 순서를 거꾸로 밟았다. 도구부터 깔고 “이걸로 뭘 뽑지”를 고민하다가, 결국 지표 정의가 없으니 매달 뽑히는 게 달라지고, 전월 대비 비교가 안 맞아서 갈아엎었다. 순서가 진짜였다.

  1. 지표 확정: 리포트에 뭐가 들어갈지 먼저 문서로 정한다. 이게 없으면 이후 전부 흔들린다.
  2. 수집: 정해진 지표를 매달 같은 기준으로 한 곳에 모은다. 시트든 DB든 상관없다.
  3. 요약: 모인 숫자를 사람이 읽는 문장으로 바꾼다. 여기가 제일 사고가 잦다.
  4. 발송: 정해진 채널로 정해진 형식을 보낸다.

요약과 발송은 세팅이 한 번 끝나면 건드릴 일이 적다. 시간을 잡아먹는 건 지표 확정과 수집 쪽이다. 지표 정의를 안 정하면 “지난달 대비”의 기준이 매번 달라져서 나중에 비교가 깨진다.

어떤 지표를 모으고, 데이터는 어디서 가져오나

내가 직접 굴리는 서비스에서 매달 보는 지표를 적는다. 우선순위대로다.

  • 구글 검색 클릭·노출 (서치콘솔)
  • 방문자 수·유입 경로 (GA4)
  • 구독·해지 수
  • 매출 관련 수치 (결제 내역)
  • 서비스별 활성 사용자
  • 파이프라인이 만들어낸 산출물 수
  • 에러·실패 로그 요약

데이터 소스별로는 이렇게 가져온다. 서치콘솔은 API로 28일치를 조회하고, GA4도 데이터 API로 뽑는다. 결제는 내보내기 파일을 읽게 했고, 서비스 지표는 각자 DB에서 카운트 쿼리로 뽑는다. 하나로 모으는 곳은 시트 한 장이다. 시트가 구리다고 생각할 수 있는데, 월 단위 지표는 양이 적어서 시트로도 충분하고 사람이 눈으로 들여다보기에 시트가 제일 편하다.

매달 하고 싶은 말인데, 지표 정의서를 한 줄씩 만들어 두면 나중에 고맙다. “구독자 수: 매달 1일 자정 기준, 해지 포함 여부 무엇” 수준으로만 적어 둬도 3개월 뒤의 내가 다른 기준으로 다시 세지 않는다.

Pipedeck 실제 화면

숫자를 사람이 읽는 문장 요약으로 바꾸는 법

요약은 LLM에게 시킨다. 프롬프트는 이런 식으로 쓴다.

아래는 이번 달 운영 지표 원본 수치다. 원본에 있는 숫자를 그대로 인용해서 전월 대비가 어떤지 3문장으로 요약해 줘. 원본에 없는 숫자를 계산하거나 추측하지 마. 상승이면 상승, 하락이면 하락으로 방향을 정확히 말해 줘. 수치 옆에 반드시 원본 값을 괄호로 붙여 줘.

이렇게 붙잡는 이유가 있다. 한번은 요약이 상승률을 반대로 말해서, 하락한 지표를 “성장세”라고 요약한 걸 그대로 보낼 뻔했다. 사람이 읽으면 “어? 번호가 문장이랑 안 맞네” 하는 수준이지만, 받는 사람은 문장만 읽는다. 그 뒤로 원본 수치 검증 절차를 넣었다.

요약이 나오면 확인하는 3줄이다.

  • 문장의 방향(증가/감소)이 원본 부호와 같은가
  • 괄호로 붙은 수치가 원본 시트와 일치하는가
  • 원본에 없는 숫자가 문장에 섞여 있지 않은가

이 검사도 스크립트로 돌린다. 요약문에서 숫자를 전부 뽑아서 원본 집합에 포함되는지 대조하는 방식이다. 톤은 대표용은 담백하게, 고객용은 부드럽게 프롬프트에 한 줄 추가하는 걸로 나눈다. 그 이상의 톤 튜닝은 해봤자 효과가 없었다.

Pipedeck 실제 화면

월 1회 크론 잡기와 실패 감지 설계

매달 1일 새벽에 돈다. 크론 표현은 단순하다.

# 매달 1일 새벽 4시 30분 (서버 타임존 기준)
30 4 1 * * /home/user/scripts/monthly_report.sh >> /var/log/monthly_report.log 2>&1

여기서 제일 크게 한번 당한 게 두 가지다. 하나는 타임존이다. 서버 시간과 내가 사는 시간이 달라서 “새벽”이 아니라 전날 저녁에 돌아가고 있었다. 로그 타임스탬프를 먼저 확인하고 잡아라. 다른 하나는 조용한 실패다. 토큰이 만료되면 크론은 실패하지만 아무한테도 알리지 않는다. 나는 빈 리포트가 여러 번 쌓이는 걸 나중에 발견했다.

그 뒤로 알림 설계를 바꿨다.

  • 성공 알림: 리포트가 정상 발송되면 무조건 슬랙에 한 줄 온다. 성공 알림이 곧 실패 감지다. 1일 오전에 이 메시지가 안 오면 뭔가 죽은 거다.
  • 실패 알림: 스크립트 마지막에 종료 코드를 확인해서 0이 아니면 즉시 알림.
  • 빈 데이터 감지: 수집 결과가 0건이거나 시트가 비어 있으면 발송을 막고 알림. 빈 리포트를 보내는 것보다 못 보내는 게 낫다.

실패 시 대응은 순서가 정해져 있다. 로그 마지막 30줄을 본다. 그다음 토큰 만료면 재발급, 할당량 초과면 다음 날 재시도, 빈 데이터면 집계 기간이 잘못됐는지 확인. 대부분 여기서 끝난다. 만료 토큰은 달력에 만료일을 적어 두는 것보다 만료 7일 전에 알려주는 크론을 하나 더 박아 두는 게 낫다. 지금 서버에 크론이 70개 돌고 있으니 나도 이 방식으로 관리한다.

Pipedeck 실제 화면

리포트를 어디로 보내고, 형식은 어떻게 잡나

받는 사람에 따라 형식을 나눈다. 나한테는 슬랙 3줄이면 충분하다. 밖으로 나가는 건 이메일에 표를 넣는다.

채널 형식 맞는 경우
슬랙 3줄 요약 + 시트 링크 나 자신, 팀 내부
이메일 헤더 + 전월 대비 표 + 해석 고객, 외부 보고
시트 링크 원본 그대로 숫자를 직접 보고 싶은 사람

월간 리포트 템플릿 골격은 이렇게 잡았다. 헤더 한 줄(기간), 전월 대비 표, 해석 3줄, 다음 액션 1줄. 여기서 다음 액션까지 자동으로 쓰게 하면 말이 커지니까, 액션은 내가 직접 쓴다.

자동화하면 안 되는 구간과, 마무리 체크리스트

전부 자동화를 해 보려다가 포기했다. 수치 수집·표 생성·발송까지는 기계의 몫이 맞는데, “이 숫자가 왜 이렇게 나왔는가”를 설명하는 문장은 사람이 쓰는 게 빠르고 안전하다. AI 요약의 오해석 리스크를 매달 감수할 이유가 없었다. 지금 기준은 사람이 1분 검수하는 구간을 하나 남겨 두는 거다. 발송 전에 표와 문장이 맞는지만 훑고 보낸다.

세팅 완료 체크리스트

  1. 지표 정의서가 있고 집계 기간이 고정되어 있다
  2. 수집 스크립트가 같은 기준으로 매달 돈다
  3. 빈 데이터일 때 발송이 막힌다
  4. 요약문의 숫자를 원본과 대조하는 검사가 들어 있다
  5. 성공 알림이 온다
  6. 실패 시 로그를 어디서 볼지 정해 두었다
  7. 토큰 만료일을 알림이 알려준다

오늘 할 첫 걸음은 크론 잡기가 아니라 지표 리스트를 적는 거다. 메모장에 “매달 보는 지표”를 적다 보면 애매한 게 나온다. 그게 정의서의 시작이다. 이 블로그의 자동화 스택을 더 궁금해하면 wallenstein.dev에 만든 것들이 걸려 있다.


글쓴이 정보

1인 빌더 아일리고가 씁니다. 잘된 것도 망한 것도 적습니다. 영상은 제가 만든 ClipSquare 에서 나옵니다.

궁금해할 만한 것들

월간 운영 리포트 자동화는 어떤 순서로 세팅하나요?

지표 확정 → 수집 → 요약 → 발송 순서로 세팅합니다. 도구부터 깔지 말고 리포트에 뭐가 들어갈지 먼저 문서로 정하는 게 핵심인데, 지표 정의가 없으면 매달 뽑히는 게 달라지고 전월 대비 비교가 깨집니다.

매달 1일 도는 크론이 조용히 죽은 건 어떻게 알 수 있나요?

성공 알림을 무조건 보내게 만드는 게 제일 확실합니다. 1일 오전에 슬랙에 성공 메시지가 안 오면 뭔가 죽은 거라, 성공 알림 자체가 실패 감지 역할을 합니다. 여기에 종료 코드 체크와 빈 데이터 감지(수집 0건이면 발송 차단)를 함께 넣으면 됩니다.

AI로 리포트 요약을 시켰는데 숫자를 틀리게 말하면 어떻게 잡나요?

프롬프트에 원본 수치를 그대로 인용하고 없는 숫자는 계산·추측하지 말라고 못 박은 뒤에, 요약문에서 숫자를 전부 뽑아 원본 시트와 대조하는 검증 스크립트를 돌립니다. 문장의 증가/감소 방향이 원본 부호와 같은지까지 확인해야 안전합니다.