콘텐츠로 건너뛰기
Telemetry
데이터베이스 신뢰성 SQL 레시피

릴리스별 데이터베이스 마이그레이션 실패 추적

롤아웃을 완료하기 전에 애플리케이션 릴리스별로 데이터베이스 마이그레이션 성공, 실패, 롤백 및 기간을 비교하세요.

초보자database_migration_events검토됨 2026-07-28테스트됨 아파치 DataFusion 45.2.0

검토자 Telemetry 제품 팀 . SQL 호환성, 이벤트 계약, 합성 출력 및 운영상의 주의사항. 표준 및 소유권 검토

질문에 답변됨

어떤 릴리스에 실패했거나 롤백된 데이터베이스 마이그레이션이 포함되어 있습니까?

부분적으로 적용된 마이그레이션으로 인해 나중에 애플리케이션 요청이 위험해질 수 있지만 배포는 정상으로 나타날 수 있습니다. 하나의 터미널 마이그레이션 결과를 기록하면 릴리스 준비 상태를 검사할 수 있습니다.

이벤트 계약

쿼리가 예상하는 필드

필드유형그것이 존재하는 이유
timestamp_utcTimestampUTC 기준 터미널 마이그레이션 시간입니다.
migration_idUtf8소스 제어의 안정적인 마이그레이션 식별자입니다.
serviceUtf8마이그레이션을 실행한 서비스 또는 배포 작업입니다.
database_nameUtf8승인된 논리적 데이터베이스 이름입니다.
releaseUtf8애플리케이션 또는 인프라 릴리스.
statusUtf8성공, 실패 또는 rolled_back.
duration_msFloat64마이그레이션 실행 기간.
error_typeUtf8원시 데이터베이스 출력이 없는 제어된 오류 범주입니다.
environmentUtf8배포 환경.
DataFusion SQL

쿼리 복사

sql
SELECT
  release,
  service,
  database_name,
  COUNT(*) AS migrations,
  SUM(CASE WHEN status = 'success' THEN 1 ELSE 0 END) AS successful,
  SUM(CASE WHEN status = 'failed' THEN 1 ELSE 0 END) AS failed,
  SUM(CASE WHEN status = 'rolled_back' THEN 1 ELSE 0 END) AS rolled_back,
  100.0 * SUM(CASE WHEN status = 'success' THEN 1 ELSE 0 END)
    / NULLIF(COUNT(*), 0) AS success_rate_pct,
  AVG(duration_ms) AS average_duration_ms
FROM database_migration_events
WHERE timestamp_utc >= now() - INTERVAL '30 days'
  AND environment = 'production'
GROUP BY release, service, database_name
ORDER BY release DESC;

이 읽기 전용 쿼리는 빈 유형의 테이블에 대해 계획되고 실행됩니다. 아파치 DataFusion 45.2.0. 결정론적 샘플 출력은 합성되어 별도로 검토됩니다. 자신의 데이터에 대해 필드 유형, 임계값 및 비즈니스 정의를 검증합니다. 테스트 방법론을 읽어보세요.

쿼리 결과

릴리스별 마이그레이션 성공률

최신 릴리스에는 실패한 마이그레이션과 롤백된 마이그레이션이 모두 포함되어 있으므로 완료된 것으로 간주되어서는 안 됩니다.

releaseservicedatabase_namemigrationssuccessfulfailedrolled_backsuccess_rate_pctaverage_duration_ms
2026.07.2application-apiapp_production5311601,470
2026.07.1application-apiapp_production5500100890

합성 예제 출력. 운영 결정에 사용하기 전에 자체 이벤트 스키마 및 임계값에 대해 쿼리를 실행하세요.

Migration success rate by release: Track Database Migration Failures by Release 예제 결과의 합성 success_rate_pct 값에 대한 정적 차트
결정론적 예제 출력의 색인 생성 가능한 SVG입니다. 기사, 런북 또는 저작자가 포함된 디자인 검토를 위해 다운로드하세요.

예제 재현

공공 픽스처 다운로드

JSON 번들은 타입이 지정된 이벤트 계약을 포함합니다. reproducible 입력 행, 정확한 SQL, 예상 출력, 검토 참고 사항 및 엔진 버전. CSV에는 표시된 결과가 포함됩니다.

SQL 작동 방식

  1. 1마이그레이션당 하나의 터미널 행은 시작 및 재시도 이벤트로 인해 분모가 부풀려지는 것을 방지합니다.
  2. 2성공적인 롤백은 여전히 마이그레이션이 제공되지 않았음을 의미하므로 실패 및 롤백 결과는 별도로 유지됩니다.
  3. 3릴리스, 서비스 및 데이터베이스는 검토가 필요한 정확한 롤아웃 경계를 식별합니다.

결정해야 할 극단적인 경우

  • 일부 마이그레이션 도구는 자동으로 다시 시도합니다. 하나의 최종 결과를 내보내는 동안 시도 횟수를 별도로 유지합니다.
  • 성공적인 마이그레이션은 여전히 논리적으로 잘못될 수 있습니다. 이 보기를 애플리케이션 상태 및 배포 후 검증과 결합하세요.
  • 원시 DDL, 연결 문자열 또는 무제한 데이터베이스 오류 텍스트를 기록하지 마십시오.

추천 대시보드

  • 바: 릴리스별 success_rate_pct
  • 표: 실패 및 롤백된 마이그레이션 ID
  • 추세: 마이그레이션 기간 및 배포별 개수

알림 안내

프로덕션 마이그레이션에 실패하거나 롤백된 최종 결과가 있는 경우 롤아웃 완료를 차단합니다.

알림 설정 읽기

레시피를 활용해 보세요

관련 계측 및 가이드

분석 계속하기

실제 이벤트에서 실행

테이블을 만들고, 필드를 조정하고, 결과를 저장하세요.

무료로 시작하고, 구조화된 이벤트를 보내고, 쿼리 결과를 차트, 공유 대시보드 위젯 또는 알림 입력으로 사용하세요.

API 키 받기