본문으로 건너뛰기
아우라베이스 로고
아우라베이스

실시간

자체 협상 WebSocket, SSE 및 NATS. 존재감, 재생, 순서 보장, 배압. POP를 통한 100만 연결, 리전 간 팬아웃 15ms 미만 p99.

설명7분 읽기레벨 중급2026. 4. 15.에 개정됨

이 페이지는 자동으로 번역되었습니다. 영어 버전은 권위가 있습니다.

동기화, 현재 상태, 브로드캐스트#

aura-realtime 서비스는 CDC Postgres(RLS로 필터링된 INSERT/UPDATE/DELETE), 존재(온라인) 및 브로드캐스트(사용자 지정)의 세 가지 유형의 이벤트를 브로드캐스트합니다. 데이터베이스와 독립적인 이벤트). 모두 .channel()를 통해 동일한 SDK를 통과합니다.

채널은 임의의 이름(sensors:live, doc:42, room:abc)으로 식별됩니다. 메시지는 채널별로 정렬되고 message_id에 의해 중복 제거되며 동일한 채널 내에서 정확히 한 번만 보장됩니다.

정보

구독은 데이터베이스에서 RLS 정책을 상속합니다. 클라이언트는 읽을 수 있는 변경 사항만 구독할 수 있습니다. 필터는 클라이언트 측이 아닌 WAL의 서버 측에서 평가됩니다.

하나의 연결, N 채널#

SDK는 클라이언트와 가장 가까운 POP 간에 단일 다중화 TCP 연결을 유지합니다. 100개의 소켓을 열지 않고도 100개의 채널을 열 수 있습니다.

schematext
                      ┌──────────────────┐
   Client (WS)  ────▶ │ aura-realtime    │
                      │  ─ CDC listener  │
                      │  ─ Presence CRDT │
                      │  ─ Broadcast hub │
                      └────────┬─────────┘
                               │ NATS JetStream
          ┌────────────────────┴────────────────────┐
          ▼                    ▼                    ▼
    aura-db WAL         Presence state        autres POPs
팁

이벤트는 일관된 해싱으로 분할됩니다. 채널은 항상 동일한 POP에 있지만 다른 POP로의 복제는 15ms 이내에 보장됩니다. p99.

6가지 기본 능력#

  • 처리량이 높은 전송. 서비스 간 NATS에 의해 구동되는 기본 WebSocket 연결.
  • Postgres CDC. WAL 변경 사항은 서버 측에서 필터링되고 RLS는 흐름에 적용됩니다.
  • 프레즌스 API. 온라인, 임의 상태, 참여/탈퇴 이벤트는 누구입니까?
  • 멀티플렉싱. 여러 채널이 하나의 WebSocket 연결을 공유합니다.
  • 이벤트 전달. 자동 클라이언트 재연결을 통한 최선의 실시간 전달.
  • 협업 커서. 기본 기본, 적응형 스로틀 60FPS, 클라이언트 보간.

네 가지 필수 패턴#

components/LiveDevices.tsxtypescript
const channel = aura.channel('db:public.devices')
  .on('postgres_changes', {
    event: '*',
    schema: 'public',
    table: 'devices',
    filter: `tenant_id=eq.${tid}`,
  }, ({ new: row }) => render(row))
  .subscribe()
필수 청소

마운트 해제 시 항상 channel.unsubscribe()를 호출하세요. React에서는 useEffect 정리에서 이 작업을 수행합니다. 위의 useChannel 후크가 이를 수행합니다.

우리가 약속하는 것과 약속하지 않는 것#

✓ 보장됨

  • 채널별 주문
  • 채널의 message_id당 정확히 한 번
  • 팬아웃 p99 < 15ms 지역 간
  • 60초 재생으로 자동 재접속
  • 명시적 배압(구성 가능한 삭제 정책)

✗ 보장되지 않음

  • 교차채널 주문
  • 정확히 한 번 교차 채널(최소 한 번)
  • 1ms 미만의 대기 시간(< 15ms p99가 우리 층임)
  • 60초 이후 재생(Postgres 로그 사용)

더 나아가려면#