본문으로 건너뛰기

토픽 생성 및 관리

토픽 생성​

토픽은 특정 메시지나 이벤트 유형을 구분하는 요소로 하나의 토픽에 여러 서브스크립션을 추가할 수 있습니다. Pub/Sub 서비스에서 토픽을 만드는 방법은 다음과 같습니다.

안내

신규 토픽은 Default-Topic을 제외하고 프로젝트당 6개까지 생성할 수 있습니다.자세한 정보는 자세한 정보는 Pub/Sub 쿼터를 참고해 주세요.

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

  2. 토픽 메뉴에서 [토픽 생성] 버튼을 클릭합니다.

  3. 토픽 생성 페이지에서 정보를 입력한 후, [생성] 버튼을 클릭합니다.

    항목설명
    이름사용자가 지정한 토픽의 이름
    기본 서브스크립션생성: 기본 pull 서브스크립션을 토픽과 함께 생성
    생성 안함: 기본 서브스크립션 생성 없이 토픽만 생성
    토픽 메시지 보존 기간토픽의 메시지 보존 기간 설정
    - 기간 범위: 10분-7일 이내 설정
    설명(선택)토픽에 대한 추가 설명

토픽 관리​

토픽은 특정 메시지나 이벤트 유형을 구분하는 요소입니다. Pub/Sub 서비스에서 토픽을 관리하는 방법은 다음과 같습니다.

토픽 목록 보기​

현재 생성된 토픽 목록과 토픽의 기본 정보를 확인할 수 있습니다.

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

  2. 토픽 메뉴에서 토픽 목록을 확인합니다.

    구분설명
    이름사용자가 지정한 토픽의 이름
    서브스크립션 개수해당 토픽에 포함된 서브스크립션의 개수
    메시지 보존기간토픽에 보관되는 메시지들의 보존 기간
    생성자토픽을 생성한 사용자

토픽 상세 보기​

토픽의 상세 정보를 확인할 수 있습니다.

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

  2. Topic 메뉴에서 상세 정보를 확인할 토픽을 선택합니다.

  3. 토픽의 상세 페이지에서 정보를 확인합니다.

    구분설명
    토픽 이름사용자가 지정한 토픽의 이름
    토픽 ID토픽의 고유 ID
    토픽 메시지 보존 기간토픽의 메시지 보존기간, 최대 7일
    *Default-Topic은 31일까지 수정 가능
    생성자토픽을 생성한 사용자
    생성 일시토픽 생성 일시

토픽 수정하기​

토픽의 설명, 보존 기간을 수정할 수 있습니다. 보존 기간은 최소 10분에서 최대 7일까지 설정할 수 있습니다.

안내

현재 토픽 메시지 보존 기간은 연장만 가능합니다. 기간 축소 기능은 추후 업데이트 예정입니다.
* Default-Topic은 메시지 보존 기간을 기본 7일부터 31일까지 설정할 수 있습니다.

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

  2. 토픽 메뉴에서 수정할 토픽의 [더 보기] 아이콘 > 수정을 선택합니다.

  3. 토픽 수정 팝업창에서 토픽 설명 및 메시지 보존 기간을 변경한 후 [저장] 버튼을 클릭합니다.

토픽 삭제하기​

더 이상 사용하지 않는 토픽을 삭제할 수 있습니다.

안내

삭제한 토픽은 복구할 수 없으며 하위 서브스크립션이 함께 삭제됩니다.
⚠️ Default-Topic은 삭제할 수 없습니다.

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

  2. 토픽 메뉴에서 삭제할 토픽의 [더 보기] 아이콘 > 삭제를 선택합니다.

  3. 토픽 삭제 팝업창에서 삭제할 토픽 이름을 입력하고 [삭제] 버튼을 클릭합니다.

토픽 모니터링하기​

토픽의 모니터링 탭에서는 토픽 및 토픽에 연결된 서브스크립션의 모니터링 결과를 확인할 수 있습니다.
kr-central-1, kr-central-2에서 지원하는 모니터링 항목이 다르므로 리전별 모니터링 정보를 확인해 주세요.

안내

Default-Topic은 토픽 모니터링을 지원하지 않습니다.
서브스크립션 모니터링 중 미처리 메시지 집계에는 어느 정도 시간이 소요되며, 재처리 횟수가 초과된 메시지는 집계에서 제외됩니다.

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

  2. 토픽 메뉴에서 모니터링할 토픽을 선택합니다.

  3. 모니터링 탭에서 토픽을 선택합니다.

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

    토픽 제공 데이터​
    메트릭 이름단위설명
    초당 게시된 메시지count/s토픽에 게시된 메시지의 초당 개수
    초당 게시 요청count/s토픽에 메시지 게시를 요청한 초당 횟수
    초당 평균 메시지 크기bytes/s토픽에 게시된 메시지의 초당 평균 메시지 크기
    초당 게시 처리량bytes/s토픽에 게시된 메시지의 초당 처리량
    초당 게시 요청 당 평균 메시지count/s토픽의 초당 게시 요청 당 평균 메시지 개수
    보관 데이터bytes토픽에 보관된 데이터의 총 크기

  4. 모니터링 탭에서 서브스크립션을 선택한 뒤 조회할 서브스크립션을 선택합니다. 자세한 설명은 서브스크립션 모니터링하기을 참고해 주세요.