본문으로 건너뛰기

서브스크립션 생성 및 관리

서브스크립션 생성​

토픽에 게시된 메시지는 서브스크립션을 통해 수신할 수 있습니다. 서브스크립션은 Pull과 Push 두 가지 유형의 메시지 전송 방식을 제공합니다. Pub/Sub 서비스에서 서브스크립션을 만드는 방법은 다음과 같습니다.

안내

서브스크립션은 프로젝트당 5개까지 생성할 수 있습니다.

  1. 카카오클라우드 콘솔 > Analytics > Pub/Sub 메뉴로 이동합니다.

  2. Subscription 메뉴에서 [서브스크립션 생성] 버튼을 클릭합니다.

  3. 서브스크립션 생성에서 정보를 입력한 후, [생성] 버튼을 클릭합니다.

    이미지 서브스크립션 만들기

    항목설명
    ① 기본 설정서브스크립션 이름: 예시: sub-01-test
    토픽 선택: 서브스크립션을 생성할 토픽 선택
    ② 서브스크립션 유형Pull: 사용자가 메시지 전송을 요청
    Push : Pub/Sub에서 메시지 전송하는 유형으로, 엔드포인트 URL 입력 필요
    - PROTOCOL: HTTP/HTTPS 입력
    - METHOD: POST

    Push 유형 서브스크립션을 만드는 경우
    (1) Pub/Sub Push 허용을 위해 엔드포인트와 연결된 리소스의 보안 그룹 인바운드 정책 설정 필요
       - Default-Topic의 Push 서브스크립션
          - kr-central-1 Source IP 대역: 210.109.79.7 ~ 210.109.79.16
          - kr-central-2 Source IP: 61.109.235.11
       - 사용자 토픽의 Push 서브스크립션
          - kr-central-1 Source IP: 210.109.60.15, 210.109.60.92, 210.109.60.144, 210.109.61.176, 210.109.62.134
          - kr-central-2 Source IP: 61.109.238.137, 61.109.238.107, 61.109.237.249, 61.109.238.114, 61.109.238.74, 61.109.236.65
    (2) 카카오클라우드 퍼블릭 IP를 사용한 각 리전의 엔드포인트 URL로만 Message Push 가능
    ③ 메시지 보존 기간서브스크립션의 메시지 보존 기간 설정
    - 기간 범위: 10분-7일 이내 설정
    - 토픽 메시지 보존 기간보다 같거나 작아야 함
    ④ 응답 대기 시간메시지 확인 응답까지 대기하는 시간
    - 시간 범위: 10-600초(10분) 이내 설정
    ⑤ 재처리 횟수대기 시간까지 응답이 없으면, 메시지를 재처리하는 횟수를 지정
    횟수 지정: 최소 1번 ~ 최대 100번
    무제한 처리: 횟수 제한 없이 재처리
주의

보안을 위해 22, 1433, 1521, 3306, 3389, 6379, 27017 포트는 Push 엔드포인트로 설정할 수 없습니다.

서브스크립션 관리​

Pub/Sub 서비스에서 서브스크립션을 관리하는 방법은 다음과 같습니다.

서브스크립션 목록 보기​

현재 생성된 서브스크립션 목록과 서브스크립션의 기본 정보를 확인할 수 있습니다.

  1. 카카오클라우드 콘솔 > Analytics > Pub/Sub 메뉴로 이동합니다.

  2. Subscription 메뉴에서 서브스크립션 목록을 확인합니다.

    이미지 서브스크립션 목록

    No구분설명
    ①서브스크립션 필터필터를 통해 특정 서브스크립션을 조회하거나, 키워드로 검색
    - 선택한 항목은 AND 조건으로, 일반 키워드 검색은 OR 조건으로 동작
    ②서브스크립션 이름사용자가 지정한 서브스크립션의 이름
    상태서브스크립션의 상태
    - Active: 활성 상태
    - In Progress: 작업 중
    - Error: 서브스크립션에 이상이 발생해 정상적으로 동작이 불가한 상태
    - Expired: 생성된 서브스크립션의 작업이 없으며 Expiration Policy에 의해 사용 불가인 상태
    내부 리소스가 삭제되며, 이후 삭제만 가능
    *Expiration Policy: 서브스크립션의 미처리 개수가 10,000개 이상인 상태로 1시간 유지
    유형서브스크립션의 유형
    - Pull: 사용자가 메시지 전송을 요청
    - Push: Pub/Sub에서 메시지 전송
    토픽 이름서브스크립션이 속한 토픽의 이름
    메시지 보존 보존기간서브스크립션의 메시지 보존기간
    응답 대기 시간메시지 응답까지 대기하는 시간
    생성자서브스크립션을 생성한 사용자
    [더 보기] 아이콘- 서브스크립션 수정: 서브스크립션의 설정 사항을 수정
    - 서브스크립션 삭제: 서브스크립션을 삭제
    - 서브스크립션 시점 되돌리기: 서브스크립션의 시점을 되돌리기

서브스크립션 상세 보기​

서브스크립션의 상세 정보를 확인할 수 있습니다.

  1. 카카오클라우드 콘솔 > Analytics > Pub/Sub 메뉴로 이동합니다.

  2. Subscription 메뉴에서 상세 정보를 확인할 서브스크립션을 선택합니다.

  3. 서브스크립션의 상세 페이지에서 정보를 확인합니다.

    이미지 서브스크립션 상세 정보

    No구분설명
    ①서브스크립션 상태서브스크립션의 상태
    - Active: 활성 상태
    - In Progress: 작업 중
    - Error: 서브스크립션에 이상이 발생해 정상적으로 동작이 불가한 상태
    - Expired: 생성된 서브스크립션의 작업이 없으며 Expiration Policy에 의해 사용 불가인 상태
    내부 리소스가 삭제되며, 이후 삭제만 가능
    *Expiration Policy: 서브스크립션의 미처리 개수가 10,000개 이상인 상태로 1시간 유지
    서브스크립션 보존 기간서브스크립션의 메시지 보존기간
    기능[서브스크립션 시점 되돌리기] 버튼: 클릭 시 서브스크립션 시점을 되돌림
    ②서브스크립션 ID서브스크립션의 고유 ID
    서브스크립션 이름사용자가 지정한 서브스크립션의 이름
    생성자서브스크립션을 생성한 사용자
    생성 일시서브스크립션의 생성 일시
    서브스크립션 유형서브스크립션의 유형
    - Pull: 사용자가 메시지 전송을 요청
    - Push: Pub/Sub에서 메시지 전송
    엔드포인트 URL서브스크립션 유형 Push를 선택하고 생성 시 입력한 URL
    응답 대기 시간메시지 확인 응답까지 대기하는 시간
    미처리 메시지 개수처리되지 않은 메시지 개수
    *미처리 메시지 집계에는 어느 정도 시간이 소요되며, 재처리 횟수가 초과된 메시지는 집계에서 제외됩니다.
    토픽 이름서브스크립션이 속한 토픽의 이름
    토픽 메시지 보존 기간토픽의 메시지 보존 기간

서브스크립션 수정하기​

서브스크립션의 상세 설정을 수정할 수 있습니다.

안내

현재 서브스크립션 보존 기간은 연장만 가능합니다. 기간 축소 기능은 추후 업데이트 예정입니다.

  1. 카카오클라우드 콘솔 > Analytics > Pub/Sub 메뉴로 이동합니다.

  2. Subscription 메뉴를 클릭 후, [더 보기] 아이콘 > 수정을 선택합니다.

  3. 서브스크립션 수정에서 서브스크립션 설정값을 변경하고, [저장] 버튼을 클릭합니다.

    이미지 서브스크립션 수정 페이지

    항목설명
    서브스크립션 메시지 보존 기간서브스크립션의 메시지를 보존할 기간
    - 기간 범위: 10분-7일 이내 설정
    * 토픽 메시지 보존기간보다 작아야 합니다.
    응답 대기 시간메시지 응답까지 대기하는 시간
    - 시간 범위: 10-600초(10분) 이내 설정
    재처리 횟수대기 시간까지 응답이 없으면, 메시지를 재처리할 횟수 지정
    - 횟수 지정 : 1-100번 이내
    - 무제한 처리 : 무제한으로 재처리

서브스크립션 시점 되돌리기​

서브스크립션을 특정 시점으로 되돌리는 기능으로, 되돌린 시점 이후의 모든 메시지를 다시 받아볼 수 있습니다. 단, 토픽에서 보존기간이 만료된 메시지는 서브스크립션에서 시점을 되돌려도 다시 받아올 수 없습니다.

안내

서브스크립션이 속한 토픽 생성 시간 이전으로는 시점을 되돌릴 수 없습니다.

  1. 카카오클라우드 콘솔 > Analytics > Pub/Sub 메뉴로 이동합니다.

  2. Subscription 메뉴에서 [더 보기] 아이콘 > 시점 되돌리기를 선택합니다.

  3. 서브스크립션 시점 되돌리기 팝업창에서 되돌릴 시점을 설정한 후, [되돌리기] 버튼을 클릭합니다.

    이미지 되돌릴 시점 설정

서브스크립션 삭제하기​

더 이상 사용하지 않는 서브스크립션을 삭제할 수 있습니다.

안내

삭제한 서브스크립션은 복구할 수 없습니다.

  1. 카카오클라우드 콘솔 > Analytics > Pub/Sub 메뉴로 이동합니다.
  2. Subscription 메뉴에서 삭제할 서브스크립션의 [더 보기] 아이콘 > 삭제를 선택합니다.
  3. 서브스크립션 삭제 팝업창에서 삭제할 서브스크립션 이름을 입력하고 [삭제] 버튼을 클릭합니다.

서브스크립션 모니터링하기​

서브스크립션의 모니터링 선택한 서브스크립션의 모니터링 결과를 확인할 수 있습니다.

안내

Subscription 모니터링 중 미처리 메시지 집계에는 어느 정도 시간이 소요되며, 재처리 횟수가 초과된 메시지는 집계에서 제외됩니다.

  1. 카카오클라우드 콘솔 > Pub/Sub 메뉴를 선택합니다

  2. Subscription 메뉴에서 모니터링할 서브스크립션을 선택합니다.

  3. 모니터링 탭을 선택합니다.

    이미지 서브스크립션 모니터링

    구분설명
    데이터 기간모니터링 그래프에 보일 데이터의 기간
    - 기간: 1시간(기본값) / 3시간 / 12시간 / 1일 / 7일
    뷰 모드모니터링 그래프 뷰 모드 설정
    - 1단, 2단, 3단 제공
    자동 새로고침 주기자동 새로고침 주기 설정
    - 주기: 자동 새로고침 안 함(기본값) / 10초 / 30초 / 1분 / 5분
    수동 새로고침클릭 시 모니터링 결과 새로고침

    PULL 서브스크립션 제공 데이터​
    메트릭 이름유닛설명
    초당 Pull 대비 확인 처리 메시지count/sPush 메시지에 대한 확인 처리 메시지의 초당 발생 횟수
    미처리 메시지count미처리 메시지 개수
    5분간 시점 되돌리기 요청count5분간 시점 되돌리기를 요청한 횟수
    초당 확인 처리 요청count/s확인 처리 요청의 초당 발생 횟수
    초당 Streaming Pull 응답count/sStreaming Pull 응답의 초당 횟수
    PUSH 서브스크립션 제공 데이터​
    메트릭 이름유닛설명
    초당 Push 대비 확인 처리 메시지count/sPush 대비 초당 확인 처리 메시지 개수
    미처리 메시지count미처리 메시지 개수
    5분간 시점 되돌리기 요청count5분간 시점 되돌리기를 요청한 횟수
    초당 확인 처리 요청count/s확인 처리 요청의 초당 발생 횟수
    초당 Push 요청count/sPush 요청의 초당 발생 횟수
최종 수정: 에