V VibeCoding 365
사전 목록 devops

VIBECODING 365 / DICTIONARY

관측 가능성

Observability

기초 난이도: 기초태그: 관측가능성 · 로그 · 운영

DEFINITION

관측 가능성이란

Observability(관측 가능성)는 시스템의 출력을 살펴보고 내부 상태를 이해하는 능력이다. OpenTelemetry 문서는 소프트웨어에서는 보통 traces·metrics·logs 같은 텔레메트리 데이터를 분석해 달성한다고 정의한다. 「에러가 났다」는 사실만 아는 것을 넘어, 어느 요청·어느 서비스·어느 배포 이후인지 설명 가능한 상태를 목표로 한다. 클라우드·마이크로서비스처럼 구성이 복잡해질수록, 출력을 체계적으로 모으지 않으면 내부 동작을 추측만 하게 된다.

계측(instrumentation)이 전제

시스템을 관측 가능하게 만들려면 계측해야 한다. 즉 코드(또는 자동 계측)가 traces·metrics·logs를 내보내고, 그 데이터를 관측용 백엔드로 보내야 한다. OpenTelemetry Signals 문서는 traces를 요청이 앱을 통과하는 경로, metrics를 런타임에 캡처한 측정값, logs를 이벤트 기록으로 정리한다. Baggage처럼 시그널 사이를 흐르는 컨텍스트도 상관관계에 쓰인다. 계측 없이 대시보드만 있으면 「보이는 숫자」와 「원인」이 끊긴다.

OpenTelemetry와의 관계

OpenTelemetry는 관측 백엔드 자체가 아니라, traces·metrics·logs 텔레메트리의 생성·수집·내보내기를 돕는 오픈소스·벤더 중립 프레임워크다. Jaeger·Prometheus·상용 제품 등 다양한 백엔드로 보낼 수 있고, 앱 코드를 바꾸지 않고 백엔드를 갈아탈 수 있게 하는 것이 목표다. 저장·시각화 UI는 의도적으로 다른 도구에 맡긴다. CNCF 프로젝트이며 OpenTracing·OpenCensus가 합쳐진 결과다. 데이터 소유권과 단일 API·관례를 배우는 것을 핵심 원칙으로 둔다.

바이브코딩에서의 자리

에이전트가 배포한 뒤 「느리다/500」만 보이면 원인 추적이 막힌다. 최소한의 로그·메트릭·트레이스(또는 플랫폼 제공 관측)로 요청·배포·사용자 흐름을 연결해 두면, 롤백할지 고쳐 올릴지 판단이 빨라진다.

ENGLISH

Observability

EXAMPLE

API 지연이 늘면 metrics로 수치를 보고, traces로 어느 서비스 구간인지 찾고, logs로 해당 요청의 에러 메시지를 확인하는 식으로 원인을 좁힌다.

REFERENCE

opentelemetry.io/docs/what-is-opentelemetry/