본문으로 바로가기
리옵트 핸드북
리옵트 핸드북
에이전틱 테스트 환경 엔지니어링

근본 원리

테스트 포트폴리오 운영 모델환경·상태 통제 전략실행 토폴로지와 러너 아키텍처테스트 하네스 엔지니어링

계약 & 구성

인터페이스 계약과 관측 포인트상태 구성과 시나리오 픽스처

실행 & 게이트

실행 패브릭과 오케스트레이션리스크 기반 릴리즈 게이트

신뢰도 & 운영

비결정성과 Flake 관리관측성·신뢰도 지표테스트 인시던트 대응거버넌스와 소유권

부록

런북 템플릿검증 리포트업데이트 내역
핸드북›에이전틱 테스트 환경 엔지니어링›관측성·신뢰도 지표

관측성·신뢰도 지표

pass rate를 넘어 evidence completeness, environment drift, MTTR까지 묶어 테스트 운영 지표로 설계하는 방법

핵심 요약

  • 테스트 관측성은 얼마나 많이 돌렸느냐보다 무엇을 측정해 어떤 행동으로 잇느냐가 더 중요합니다.
  • Pass/Flake Rate를 넘어 MTTD·MTTR·Evidence Completeness·Environment Drift·Cost per Decision까지 KPI로 둡니다.
  • 대시보드는 팀 운영·리드/매니저·경영 요약 3계층으로 분리해 보고합니다.
  • 파이프라인의 핵심은 러너가 아니라 정규화 계층이며 gate·service·owner·classification·fingerprint를 함께 저장합니다.
  • main/release failed는 즉시 알리고 flaky 3일 누적 시 deflake 티켓, evidence completeness 95% 미만 시 정책을 점검합니다.

에이전틱 테스트 환경에서는 얼마나 많이 돌렸느냐보다 무엇을 측정하고 그것을 어떤 행동으로 잇느냐가 더 중요합니다. 대시보드는 예쁘게 꾸미는 게 목적이 아닙니다. gate 품질과 우선순위를 결정하는 도구여야 합니다.

핵심 KPI

지표정의owner권장 활용
Pass Rate최근 N회 실행 중 성공 비율suite owner안정성 추세
Flake Rateretry/pass 패턴 포함 간헐 실패 비율QA platformdeflake 우선순위
MTTD실패 발생 후 triage 시작까지 시간QA platform탐지/알림 품질
MTTRtriage 시작 후 green 복구까지 시간suite owner운영 반응 속도
Evidence Completenesstrace, log, event, env info가 충분히 남은 비율DevEx / QA platformtriage 생산성
Environment Drift동일 probe의 환경 fingerprint 변화량SRE / Platform환경 안정성 추세
Cost per Decisionrelease 판단 1회당 runner/infra/스토리지 비용Dev Productivity예산 관리

보고 계층 분리

팀 운영 대시보드

  • 오늘 실패한 gate와 owner
  • flaky / nondeterminism top 10
  • quarantine 목록
  • suite duration 변화
  • evidence 누락 비율

리드 / 매니저 대시보드

  • 주간 gate 안정성
  • release blocker 빈도
  • 서비스별 nondeterminism debt
  • deflake backlog burn-down

경영 / 임원 요약

  • 릴리즈 승인에 걸리는 평균 시간
  • 테스트 환경이 사전 차단한 장애성 이슈 수
  • 운영 비용과 변화 추이

실패 분류 체계

분류의미
Product Regression실제 제품 회귀
Test Issuelocator, assertion, helper 문제
Data Issueseed, reset, 계정 충돌
Infra Issuerunner, network, container, environment
External Dependencysandbox, provider, quota 이슈
Model Varianceagent / LLM 결과 분산

수집 파이프라인 예시

이 파이프라인에서 진짜 중요한 건 러너가 아니라 정규화 계층입니다. 같은 실패라도 gate, service, owner, classification, environment_fingerprint를 함께 저장해 둬야 운영 질문에 답할 수 있습니다.

정규화 이벤트 스키마

필드의미예시
run_id실행 단위 식별자gha-20260401-1832
gate어떤 gate에서 실행됐는지pr, main, release, canary
probe_typeprobe 성격browser, api, workflow, synthetic
service소유 서비스payments-web
runner사용 러너playwright, http-client, queue-harness
final_status최종 결과passed, failed, flaky, skipped
classification실패 분류product, test, data, infra, external, model
retry_count재시도 횟수1
duration_ms실행 시간18432
ownersuite owner 또는 팀@payments-qa
artifact_urlevidence 링크https://ci.example.com/runs/1832/report
commit_sha코드 버전abc1234
environment실행 환경preview, integration, prod-like, canary
environment_fingerprintseed/flag/version 요약seed-v14|ff-a92|queue-3
started_at시작 시각2026-04-01T02:11:10Z

운영 액션 연결 규칙

  • main 또는 release gate에서 final_status=failed면 incident 채널에 즉시 알립니다.
  • final_status=flaky가 3일 연속 누적되면 deflake 티켓을 자동 생성합니다.
  • evidence completeness가 95% 아래로 떨어지면 reporter / retention 정책을 점검합니다.
  • classification=infra 비중이 급증하면 제품팀이 아니라 플랫폼팀이 먼저 triage합니다.

운영 팁

  • pass rate 하나만 보고 건강도를 판단하지 마세요.
  • flaky와 infra failure를 구분하지 않으면 엉뚱한 곳에 투자하게 됩니다.
  • environment drift를 측정하지 않으면 "테스트는 안 바뀌었는데 왜 흔들리나"라는 질문에 답할 수 없습니다.

관련 문서

비결정성과 Flake 관리

flaky를 타이밍 문제가 아니라 환경·상태·외부 의존성·모델 분산의 운영 신호로 다루는 방법

실행 패브릭과 오케스트레이션

PR, main, nightly, release, canary, agent-repair 루프를 어떤 시간 예산과 증거 정책으로 운영할지 설명합니다.

팀 문서화 문화 만들기

에이전틱 시대의 문서화 혁신 · 에이전트 지침, Skill, Plugin, MCP를 운영하는 팀 거버넌스

비결정성과 Flake 관리

flaky를 타이밍 문제가 아니라 환경·상태·외부 의존성·모델 분산의 운영 신호로 다루는 방법

테스트 인시던트 대응

gate failure를 릴리즈 판단 시스템 인시던트로 다루고 triage, release hold, rollback을 연결하는 방법

On this page

핵심 KPI보고 계층 분리팀 운영 대시보드리드 / 매니저 대시보드경영 / 임원 요약실패 분류 체계수집 파이프라인 예시정규화 이벤트 스키마운영 액션 연결 규칙운영 팁