SLO와 오류 예산

서비스 수준 목표(서비스 수준 목표, SLO)는 기술 신호를 사용자 영향과 이어 줍니다. FDAI는 워크로드의 서비스 수준 지표(SLI), 목표, 오류 예산, 여러 구간의 소진 속도를 평가해서, 인시던트 우선순위와 변경 판단에 측정된 신뢰성 근거를 사용합니다.

상위 프로젝트에는 SLO 등록부, 평가기, 이벤트 실행기가 이미 구현되어 있습니다. 다만 실제 평가는 배포 환경에서 진짜 MetricProvider를 연결하고 실행기를 예약해야 완성됩니다. 워크로드 SLO는 FDAI 컨트롤 플레인의 목표와는 구분됩니다.

목표 정의하기

SLO 항목에는 워크로드와 범위, SLI 종류, 목표치, 측정 구간, 소진 속도 경보 구간을 적습니다. 정의는 코드로 관리하는 카탈로그에 두고 불러올 때 검증합니다.

요소	예시 의미
SLI	성공한 요청 수를 유효 요청 수로 나눈 비율
목표	30일 동안 99.9%
오류 예산	그 구간에서 허용되는 실패 비율
소진 속도	남은 예산이 줄어드는 속도

두 종류의 SLO를 구분합니다

워크로드 SLO는 FDAI가 운영하는 서비스를 측정합니다. 컨트롤 플레인 SLO는 이벤트 처리 지연, 작업 성공률, 콘솔 가용성처럼 FDAI 자신을 측정합니다. 컨트롤 플레인이 정상이라고 워크로드가 정상인 것은 아니고, 워크로드 인시던트가 났다고 FDAI가 나빠졌다고 볼 수도 없습니다.

구분	쓰임새	예시
워크로드 SLO	인시던트 영향 판단과 위험한 변경 정책	관리 대상 서비스의 요청 성공률
FDAI 컨트롤 플레인 SLO	플랫폼 준비 상태와 안전한 성능 저하	이벤트 판단이 예산 안에 끝났는지

소진 속도 평가

FDAI는 짧은 구간과 긴 구간을 함께 봅니다. 짧은 급등만 보면 잡음일 수 있고, 긴 구간의 위반만 보면 대응이 늦어집니다. 여러 구간을 함께 평가해서 설정된 조합이 예산을 꾸준히 또는 급하게 쓰고 있다고 나올 때만 문제로 보고합니다.

결과에는 목표, 달성률, 남은 예산, 평가한 구간, 임계값, 데이터 최신성을 기록합니다. 지표 데이터가 없거나 오래되면 정상으로 넘기지 않고 안전한 쪽으로 멈춥니다.

짧은 구간과 긴 구간, 그리고 각각의 임계값은 카탈로그에서 정의합니다. 서비스마다 트래픽과 목표가 다르므로 이 문서는 모든 워크로드에 통하는 숫자 조합을 정해 두지 않습니다. FDAI는 설정된 짝을 결정론적으로 평가하고, 문제 없음이라는 결과까지 포함해 두 구간의 결과를 모두 기록하므로, 경보가 왜 울렸는지 또는 왜 울리지 않았는지 운영자가 그대로 재현할 수 있습니다.

위반에서 대응까지

지표 프로바이더가 범위와 시각이 붙은 표본을 돌려줍니다.
소진 속도 평가기가 설정된 구간을 계산합니다.
SloBurnRunner가 slo.error_budget_burn 이벤트를 발행합니다.
이벤트 수집이 중복을 걸러 내고 진행 중인 변경이나 인시던트와 연결합니다.
트러스트 라우터와 안전성 검토가 관찰, 알림, 승인 요청, 완화 작업 중 어느 경로로 갈지 정합니다.

SLO 위반은 발견된 문제일 뿐 롤백이나 확장을 실행할 권한이 아닙니다. 대응에는 여전히 ActionType, 검증, 영향 범위 제한, 롤백, 필요한 결정이 있어야 합니다.

예산이 빠르게 줄고 있으면 정책에 따라 인시던트 우선순위를 올리거나, 위험한 변경의 자율성 상한을 낮출 수 있습니다. 이는 대시보드가 만들어 내는 부수 효과가 아니라 안전성 검토에 명시적으로 들어가는 입력값입니다. 데이터가 없다고 예산 소진을 0으로 보거나 변경을 승인할 수는 없습니다. 그럴 때는 근거 확인 불가로 기록하고, 그 근거에 기댄 판단을 막습니다.

운영자가 확인할 것

SLI가 손쉬운 인프라 대체 지표가 아니라 실제 사용자 영향을 측정하는지 확인하세요.
지표 출처, 최신성, 데이터 누락 시 정책, 측정 구간을 확인하세요.
짧은 구간과 긴 구간의 소진 속도를 함께 보세요.
예산 소진을 배포, 정기 점검 시간대, 진행 중인 인시던트와 연결해 보세요.
브라우저에서 계산한 값만으로 위험한 변경을 막지 말고, 관리되는 정책을 사용하세요.

다음 단계

알아볼 내용	문서
관측 데이터가 발견된 문제가 되는 과정	관측성, 감지, 예측
위반이 인시던트에 합류하는 방법	인시던트 관리
용량 근거가 SLO를 보완하는 방법	용량과 성능
표준 결과 지표	목표와 메트릭