CH05 · 모니터링 & 사용자 관리

5-4. [실습] "이번 주 운영 리포트 + 퇴사자 정리해줘"

이번 섹션에서 만든 모니터링과 사용자 관리 기능을 한 번에 실행합니다. 지금까지 따로따로 요청했던 기능들을 하나의 자연어 명령으로 통합해 돌려보겠습니다.


1. 실습 목표

이번 실습에서 만들 리포트에는 다음 네 가지가 포함됩니다.

이 모두를 프롬프트 한 번으로 처리합니다.


2. 프롬프트 입력

터미널에서 Claude Code를 열고 다음과 같이 지시합니다.

이번 주 운영 리포트를 만들어줘.
다음 항목을 포함해줘:
1. 신규 워크플로우: 이번 주 새로 만들어진 워크플로우
2. 에러 현황: 이번 주 실패한 실행 기록을 분석하고 원인/해결책 정리
3. 휴면 워크플로우: 30일 이상 실행되지 않은 활성 워크플로우

그리고 김철수님이 퇴사 예정이니,
이 분의 워크플로우 인계 리포트도 함께 만들어줘.

3. Claude가 수행하는 작업

Claude는 이 요청을 받으면 여러 MCP 도구를 순차적으로 호출합니다.

STEP 1

신규 워크플로우 조회. n8n_list_workflows로 전체 목록을 가져오고, createdAt 기준으로 이번 주 신규 항목을 필터링합니다.

STEP 2

에러 실행 이력 조회 및 분석. n8n_executions로 실패 이력을 가져오고, 메시지를 연결/데이터/로직/리소스 에러로 분류한 뒤, 워크플로우별 반복 패턴과 해결책을 정리합니다.

STEP 3

휴면 워크플로우 감지. 1번 목록과 2번 실행 이력을 조합해, 활성 상태이지만 30일 이상 실행 기록이 없는 워크플로우를 골라냅니다.

STEP 4

퇴사자 워크플로우 필터링. 소유자가 김철수님인 워크플로우만 추려, 실행 이력과 상태를 확인해 인계 우선순위를 매깁니다.


4. 종합 리포트 결과

모든 분석이 완료되면 Claude가 다음과 같은 종합 리포트를 생성합니다.

이번 주 n8n 운영 리포트 (2026-03-20 ~ 2026-03-26)<br /><br />---<br /><br />1. 신규 워크플로우 (3건)<br />| 이름 | 생성일 | 활성 상태 | 비고 |<br />|------|--------|-----------|------|<br />| [test] 슬랙 실험 | 03-24 | 비활성 | 컨벤션 위반 |<br />| 마케팅 주간 리포트 | 03-23 | 활성 | 정상 |<br />| 고객 문의 자동 응답 | 03-20 | 활성 | 정상 |<br /><br />2. 에러 현황 (5건, 2개 워크플로우)<br />- 마케팅 주간 리포트: 3회 실패 (연결 에러 - Google Sheets OAuth 토큰 만료)<br />- 고객 문의 자동 응답: 2회 실패 (데이터 에러 - email 필드 누락)<br />- 권장 조치: Google Sheets 크레덴셜 재인증, 웹훅 데이터 검증 로직 추가<br /><br />3. 휴면 워크플로우 (2건)<br />| 이름 | 마지막 실행 | 경과일 | 권장 조치 |<br />|------|-----------|--------|----------|<br />| 구 버전 매출 알림 | 02-10 | 44일 | 비활성화 검토 |<br />| 임시 마이그레이션 | 01-05 | 80일 | 삭제 검토 |<br /><br />4. 김철수님 퇴사 인계 리포트<br />- 즉시 인계 필요: 5개 (활성 상태)<br />- 검토 후 결정: 2개 (비활성 상태)<br />- 삭제 권장: 1개 (3개월 이상 미사용)<br />- 주의: CRM 연동 워크플로우의 크레덴셜이 개인 계정 기반일 가능성 있음

이 리포트 하나면 이번 주 팀 n8n 서버에서 무슨 일이 있었고, 무엇을 조치해야 하는지가 한눈에 들어옵니다.


5. 섹션 5 마무리 — ops-manager에 추가된 기능

이번 섹션에서 ops-manager 모듈에 추가한 기능을 정리합니다.

신규 워크플로우 감지

n8n_list_workflows의 createdAt 기준 필터링으로 새로 만들어진 워크플로우를 자동 감지합니다. 컨벤션 위반 여부도 함께 확인합니다.

에러 모니터링

n8n_executions로 실패 이력을 조회하고, AI가 원인을 분류하며 해결책을 한국어로 정리합니다. n8n_autofix_workflow로 자동 수정도 시도합니다.

사용자 관리

퇴사자의 워크플로우를 소유자 기준으로 필터링하고, 실행 이력을 바탕으로 인계 리포트를 생성합니다. 휴면 워크플로우도 함께 감지합니다.

세 기능 모두 ops-manager 모듈에 등록되어 있으므로, 앞으로는 "운영 리포트 만들어줘" 한마디면 Claude가 전체 과정을 자동으로 수행합니다.


6. 다음 섹션 예고

핵심. 세 기능이 모두 모듈로 등록되어 있으면, 한 번의 자연어 명령으로 통합 리포트가 만들어집니다. 이게 ops-manager의 진짜 가치입니다.

다음 섹션 6에서는 백업, 보안, 팀 공유를 다룹니다. 워크플로우를 매일 자동 백업하고, API 키를 안전하게 관리하고, 완성된 클로드 스킬을 팀원에게 전달하는 방법을 배우겠습니다.

다음 클립
6-1. 자동 백업 + 보안 설정 (.env, Credentials)
이어보기 →