Remote-Write 사양

Remote-Write 사양 (Prometheus Remote-Write specifications)

프로메테우스가 데이터를 원격 수신자(receiver)로 보내는 표준 프로토콜인 Remote-Write의 공식 사양 모음이에요. 시계열 샘플을 실시간으로 손실 없이 전파하기 위해 설계된 이 프로토콜은, 프로메테우스 자체는 물론 Thanos, Mimir, Cortex 같은 롱텀 스토리지와 연동하는 모든 도구가 사용해요. 이 섹션은 안정 버전 1.0과 실험 중인 2.0 두 가지 사양으로 구성돼요.

스크레이프가 "당겨오기(pull)" 방식이라면 Remote-Write는 데이터를 "밀어보내기(push)" 방식으로 전송하는 핵심 표준이에요. 프로메테우스 서버나 에이전트가 수집한 메트릭을 원격 저장소로 보낼 때 어떤 형식으로, 어떤 규칙으로 보내야 하는지 정의한 문서랍니다. 아래에서 두 버전의 사양으로 들어가 보세요.

출처: 문서

본문

Remote-Write(원격 쓰기)는 프로메테우스와 호환되는 전송자(sender)가 프로메테우스 또는 호환 수신자에게 데이터를 보내는 표준이에요. 샘플을 시계열 단위로 묶어 HTTP POST로 보내고, 스내피(Snappy) 압축과 프로토콜 버퍼(protobuf) 인코딩을 사용해요. 이 프로토콜은 무상태(stateless)로 설계돼 샘플 간 통신이 없고, 시리즈별 시간 순서를 지켜 보내며, 실패 시 재시도와 백오프를 사용해 데이터 손실을 막는 것이 핵심 원칙이에요.

이 섹션은 두 개의 사양 문서로 구성돼요:

  • Remote-Write 1.0: 2023년 4월에 발행된 안정 버전 사양. 기존에 널리 유기적으로 채택된 프로토콜을 표준화해 문서화했으며, 새로운 것을 제안하지 않아요
  • Remote-Write 2.0: 개발 중인 다음 버전 사양(릴리스 후보). 새 Protobuf 메시지와 기능, 필수 응답 헤더를 추가하고 1.0 메시지를 deprecated 처리해요

더 알아보기 (Learn more)