DevOps 운영 보고

템플릿 소개

이럴 때 씁니다

스프린트 종료나 월말에 인프라·배포·장애 현황을 정리해 개발 조직 밖으로 보내는 10장 구성입니다. 읽는 사람이 CTO, 프로덕트 조직, 경영진이라는 전제여서 명령어나 설정값이 아니라 지표와 판단이 들어갑니다. 표지에는 “REPORTS” 분류와 “ISSUE 01 · 2026”, “COVER STORY” 같은 발행물 형식의 문구가 있어 회차 번호를 붙이기 좋고, 마지막 10장은 “더 자주 더 안전하게”라는 맺음 문구로 끝납니다. 장애 하나를 깊게 다루는 사후 분석(포스트모템)은 별도 문서로 쓰고, 여기에는 한 줄 요약과 링크만 남기세요.

채우는 순서

1. 8장 “핵심 지표” 카드 네 개는 FIG. 01~04 번호가 붙어 있고 “34회” 주간 배포, “26분” 평균 복구, “4.1%” 변경 실패율, “99.95%” 가용률로 채워져 있습니다. 배포 빈도 / MTTR / 변경 실패율 / 가동률이라는 운영 보고의 기본 네 축이 그대로 들어와 있으니 라벨은 두고 숫자만 우리 값으로 바꾸면 됩니다.
2. 각 카드 값에 SLO 대비 상태를 붙입니다. 예: “99.94%(목표 99.9%)”처럼 목표를 옆에 적으면 좋은지 나쁜지 설명할 필요가 없어집니다.
3. 본문은 두 세트뿐입니다. 4장 “배포 실적”은 리드 문장 “이번 분기에 몇 번 나갔고 얼마나 걸렸는지 봅니다.” 아래 “주간 평균 배포 34회 기록”, “변경 실패율 6.8%에서 4.1%로”, “커밋에서 운영까지 3.2시간” 세 줄이고, 6장 “빌드 파이프라인”은 “빌드가 막히던 구간을 찾아 손봤습니다.” 아래 “테스트 병렬화로 18분에서 7분”, “캐시 적중률 82%까지 상승”, “야간 회귀 시험 자동 실행” 세 줄입니다. 이번 기간 실적은 4장에, 파이프라인 손본 내용은 6장에 쓰면 구조가 그대로 맞습니다.
4. 목차는 배포 실적 · 빌드 파이프라인 · 개선 전 배포와 현재 배포 · 핵심 지표 · 추이 분석 다섯 줄이고 아래에 “총 5개 항목”이라는 표기가 따로 있습니다. 간지는 PART 01 “배포 실적”과 PART 02 “빌드 파이프라인” 두 장이라 목차와 어긋나지 않습니다. 다만 장애 대응이나 비용 추이를 따로 보고하려면 간지·본문 쌍을 복제하고 목차 줄과 “총 5개 항목” 숫자를 함께 고쳐야 합니다.
5. 7장 “개선 전 배포와 현재 배포”는 A “개선 전”과 B “현재” 두 열이고, “배포 주기 월 1회”에서 “배포 주기 주 4회”, “배포 소요 3시간”에서 “배포 소요 11분”, “롤백 평균 47분”에서 “롤백 평균 90초” 세 줄로 짜여 있습니다. 항목 이름은 그대로 두고 값만 우리 파이프라인 측정치로 바꾸면 됩니다.
6. 9장 추이 슬라이드는 “4월” 96, “5월” 118, “6월” 134, “7월” 152 네 막대로 월별 라벨이 붙어 있고 오른쪽으로 갈수록 값이 커집니다. 배포 횟수처럼 늘어나는 지표는 그대로 맞지만, 장애 건수나 응답시간처럼 줄어야 좋은 지표를 넣을 때는 막대 높이 순서까지 뒤집어야 합니다.

예시

• 운영 현황 예: “배포 118회(주 평균 27회), 롤백 4건. 변경 실패율 3.4%로 전월 5.1%에서 개선.”
• 장애 예: “P1 1건 — 2월 9일 01:12 발생, 02:05 복구(53분). 원인은 커넥션 풀 상한 도달.”
• 개선 항목 예: “배포 파이프라인에 부하 테스트 단계 추가 — 3월 2주차까지, 담당 플랫폼팀”

지표 정의와 캡션 처리

변경 실패율은 롤백·핫픽스 건수 ÷ 전체 배포 횟수 × 100, MTTR은 장애별 (복구 시각 − 감지 시각)의 평균입니다. 감지 시각 기준인지 발생 시각 기준인지에 따라 숫자가 크게 달라지므로 정의를 슬라이드에 남기세요. 가동률은 (총 시간 − 장애 시간) ÷ 총 시간 × 100 이고, 계획 점검 시간을 뺐는지 밝혀야 합니다. 이 파일에는 8장 지표 슬라이드에 “지표는 예시 값입니다. 실제 수치로 바꿔 사용하세요.”, 9장 추이 슬라이드에 “분기별 추이를 지수로 나타낸”, “단위: 지수” 같은 캡션이 들어 있습니다. 지우지 말고 측정 기간과 집계 도구로 바꿔 쓰면 그대로 각주가 됩니다. 캡션은 분기별이라고 적혀 있는데 막대 라벨은 4월부터 7월까지 월 단위이므로, 둘 중 하나에 맞춰 문구를 고쳐야 읽는 사람이 기간을 오해하지 않습니다. 막대는 도형이라 값에 맞춰 높이를 손으로 조정해야 합니다.

흔한 실수

• 가동률만 보고하는 것 — 99.9%를 유지하려고 배포를 멈춘 팀도 같은 숫자를 냅니다. 배포 빈도와 함께 봐야 상태가 보입니다.
• 장애 원인을 트래픽 급증으로 마무리하는 것 — 급증은 계기이지 원인이 아닙니다. 어떤 한계값에 걸렸는지까지 씁니다.
• 개선 항목에 담당과 기한을 빼는 것 — 다음 달 보고서에 같은 항목이 그대로 남습니다.
• 본문 두 세트에 여섯 가지 주제를 욱여넣는 것 — 슬라이드를 복제하는 편이 글자 크기를 줄이는 것보다 낫습니다.