Pusher 한도 정리: 메시지 크기, presence 인원, client events
Pusher Channels의 고정 한도. 10 KB 이벤트 크기, presence 100명, 초당 10개 client event까지, 한도가 있는 이유와 한도 안에서 설계하는 방법.
연결 수와 일일 메시지 수라는 요금제 한도 외에도, Pusher Channels에는 이벤트 하나, 채널 하나, presence 멤버 하나가 담을 수 있는 고정 한도가 있습니다. 운영 환경에서 오류로 드러나는 것은 바로 이것들입니다. 큰 payload에 대한 413, 거부되는 client event, 100명에서 더 이상 멤버를 받지 않는 presence 채널 같은 경우입니다.
Pusher Channels 한도 한눈에 보기
| 한도 | Pusher Channels | Hibira |
|---|---|---|
| 이벤트 데이터 크기 | 10 KB | Free 4 KB, Hobby와 Starter 10 KB, Pro와 Advanced 32 KB, Business와 Scale 64 KB |
| 한 번 발행할 때 채널 수 | 100 | 100 |
| 배치 요청당 이벤트 수 | 10 | 10 |
| 채널 이름 길이 | 164자 | 164자 |
| Presence 채널 멤버 수 | 100 | 100, presence-large- 채널은 최대 100,000 |
| Presence 사용자 객체 | 1 KB | 1 KB (presence-large- 채널은 256 bytes) |
| Presence 사용자 ID | 128자 | 128자 |
| 연결당 client event | 초당 10개 | 초당 10개 |
| 서명 타임스탬프 허용 범위 | 600초 | 600초 |
Pusher의 수치는 HTTP API 레퍼런스, 채널, presence 채널, 이벤트 문서에서 가져왔으며 2026-10-30에 확인했습니다. 요금제별 연결 수와 일일 메시지 수는 Pusher 요금 페이지에 있습니다.
이벤트 크기: 10 KB 한도
이벤트 데이터가 10 KB를 넘으면 Pusher는 단건이든 배치든 HTTP 413을 반환합니다. 한도는 JSON 인코딩 후의 data 필드에 적용되므로, 이스케이프된 따옴표와 한글은 보기보다 많은 공간을 차지합니다.
한도를 넘지 않는 일반적인 방법:
- ID만 보내고 클라이언트가 자체 API로 레코드를 가져오게 합니다.
- 객체 전체가 아니라 바뀐 필드만 보냅니다.
- 긴 목록은 여러 이벤트로 나누거나 페이지로 나눕니다.
Hibira의 한도는 요금제에 따라 다르므로, 20 KB나 50 KB가 필요한 payload(문서 diff, 메타데이터가 붙은 AI 응답 청크 등)도 클라이언트를 바꾸지 않고 Pro나 Business에 들어갑니다.
Presence 채널: 100명 한도
Pusher의 presence 채널은 최대 100명까지 받습니다. 모든 멤버는 구독할 때 전체 멤버 목록을 받고, 누가 들어오거나 나갈 때마다 이벤트를 받습니다. 한도가 있는 이유가 이것으로, 1,000명이면 입장할 때마다 1,000번 보내야 합니다.
Hibira는 presence- 채널에서 같은 100명 한도를 유지하므로 기존 코드는 똑같이 동작합니다. 라이브 방송, 웨비나, 게임 로비 같은 대규모 청중에는 presence-large- 채널이 최대 100,000명을 받고, 전체 목록 대신 인원 수와 묶은 변경 사항을 보냅니다. 클라이언트 쪽은 대규모 presence 가이드를 참고하세요.
Client events
Client event는 브라우저가 서버를 거치지 않고 다른 구독자에게 보내는 기능으로, 입력 중 표시나 커서 위치에 쓰입니다. Pusher에서는 앱마다 활성화해야 하고, private-와 presence- 채널에서만 동작하며, client- 접두사가 필요하고, 보낸 사람에게는 돌아오지 않으며, 연결당 초당 10개로 제한됩니다. Hibira도 같은 규칙을 따르므로 Pusher 한도를 지키는 클라이언트는 그대로 동작합니다.
커서처럼 빈도가 높은 입력은 최대 100 ms마다 보내고, 중간 위치는 쌓지 말고 버리세요.
채널과 요청 한도
채널 이름은 private- 또는 presence- 접두사를 포함해 최대 164자이며, 영문자, 숫자와 _ - = @ , . ; 만 쓸 수 있습니다. 한 번 발행할 때 최대 100개 채널, 배치 요청 하나에 최대 10개 이벤트를 담을 수 있습니다. 서명된 요청의 타임스탬프는 서버 시각과 600초 이내여야 하므로, 시계가 어긋난 서버는 401을 받습니다.
자주 묻는 질문
Pusher의 메시지 최대 크기는 얼마인가요?
이벤트 데이터 기준 10 KB입니다. 넘는 이벤트는 HTTP 413으로 거부됩니다. Hibira는 Free 4 KB, Hobby와 Starter 10 KB, Pro와 Advanced 32 KB, Business와 Scale 64 KB입니다.
Pusher presence 채널에는 몇 명까지 들어갈 수 있나요?
100명입니다. Hibira는 presence- 채널에서 100명을 유지하고, 최대 100,000명의 presence-large- 채널도 제공합니다. 이 채널은 전체 목록 대신 인원 수와 묶은 변경 사항을 보냅니다.
Hibira로 옮길 때 코드를 바꿔야 하나요?
아니요. 프로토콜, 클라이언트와 서버 라이브러리, 이 한도들은 같고, 선택해서 쓸 수 있는 더 큰 payload와 대규모 presence 채널이 더해질 뿐입니다. 절차는 마이그레이션 가이드에 있습니다.
제품명은 각 소유자의 상표입니다.