TTS 서버 정기점검 자동화 (tts-periodic-inspection, 실험)

TTS 서버 고객사 월 1회 정기점검을 자동화하는 실험 스킬. 로그 수집(SFTP) → 통계 추출 → xlsx/docx 보고서 생성을 단일 명령으로 처리한다.

상태

실험 스킬 (contrib/experimental/tts-periodic-inspection/). 플러그인 자동 등록 대상이 아니므로 슬래시 커맨드는 없음. AI 에이전트에게 자연어로 요청하면 CLAUDE.md 키워드 매칭으로 자동 실행된다.

아키텍처

run_inspection.py (오케스트레이터)
  ├── T2: fetch_logs.py        — SFTP 로그 다운로드
  ├── T1: pttsnetdstat_parse.py — 일별 통화 통계 파싱
  ├── T3: disk_free_process.py  — 디스크 사용량 처리
  ├── T4: pttsnetdlog_resource_extract.py — CPU/Mem/에러 추출
  ├── T6: service_status_check.py — 서비스 상태 SSH 점검
  ├── T5: usage_xlsx_build.py   — 사용량통계 xlsx 생성
  └── T7: report_docx_build.py  — 정기점검 보고서 docx 생성

고객사별 설정은 customers/<name>.yaml + adapters/<name>.py 패턴으로 분리된다.

트리거 (CLAUDE.md 등록 키워드)

"정기점검", "TTS 점검", "월간 점검 보고서"

AI 에이전트 실행법

폴리인스퍼레이션 2026-04 정기점검 보고서 만들어줘

에이전트가 자동으로 SKILL.md → run_inspection.py 순서로 처리한다.

CLI 직접 실행

# 로그 다운로드 포함 (첫 실행). --day 는 점검 수행일(필수).
python run_inspection.py --customer polyinspiration --month 2026-04 --day 28 --output-dir <BASE> --bootstrap-host-keys

# 이미 로그가 있을 때 (--skip-fetch)
python run_inspection.py --customer polyinspiration --month 2026-04 --day 28 --output-dir <BASE> --skip-fetch

산출물

<output-dir>/<MONTH>/
  YYYY년 MM월_폴리인스퍼레이션_사용량통계_<YYYYMMDD>.xlsx
  YYYY년 MM월_폴리인스퍼레이션_정기점검_보고서_<YYYYMMDD>.docx
  Server1/stat_data.json, diskfree.json, resource.json, service_status.json
  Server2/...

사전 준비

자격증명 (1회)

Secret Manager(http://10.200.2.183:8900/admin)에 등록하거나, 임시로 환경변수 사용:

$env:HARNESS_SECRET_POLYINSPIRATION_SERVER1_HOST         = "13.125.222.40"
$env:HARNESS_SECRET_POLYINSPIRATION_SERVER1_USER         = "devtts"
$env:HARNESS_SECRET_POLYINSPIRATION_SERVER1_AUTH_METHOD  = "key"
$env:HARNESS_SECRET_POLYINSPIRATION_SERVER1_KEY_PATH     = "<ppk 경로>"
$env:HARNESS_SECRET_POLYINSPIRATION_SERVER1_KEY_PASSWORD = "<passphrase>"
# server2도 동일하게

SSH host key 등록 (첫 실행 시)

--bootstrap-host-keys 옵션 추가하면 자동 등록된다.

패키지 설치

pip install -r contrib/experimental/tts-periodic-inspection/requirements.txt

새 고객사 추가

1. customers/<name>.yaml 생성 — 서버 목록, 로그 경로, 어댑터 지정
2. Secret Manager에 <secret_prefix>/<server_id>_* 키 등록
3. (선택) adapters/<name>.py — 고객사별 docx 맞춤 로직
4. run_inspection.py --customer <name> ... 실행

수기 보완 항목 (자동화 미해당)

• P7 오류분석
• r32 최종 검토 결과
• r33 기타 고객 요구사항

관련 파일

• contrib/experimental/tts-periodic-inspection/SKILL.md — 스킬 정의 및 절차
• contrib/experimental/tts-periodic-inspection/run_inspection.py — 오케스트레이터
• contrib/experimental/tts-periodic-inspection/customers/polyinspiration.yaml — 고객사 설정