토픽 생성 및 관리

토픽 생성

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

안내

신규 토픽은 Default-Topic을 제외하고 프로젝트당 3개까지 생성할 수 있습니다.

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

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

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

   토픽 만들기

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

토픽 관리

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

토픽 목록 보기

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

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

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

   토픽 목록

   No	구분	설명
   ①	토픽 필터	필터를 통해 특정 토픽을 조회하거나, 키워드로 검색 - 선택한 항목은 AND 조건으로, 일반 키워드 검색은 OR 조건으로 동작
   ②	토픽 이름	사용자가 지정한 토픽의 이름
   	서브스크립션 개수	해당 토픽에 포함된 서브스크립션의 개수 -단위: 개
   	암호화	토픽의 암호화 여부 - 현재 디폴트는 사용이며, 추후 기능 업데이트 예정
   	메시지 보존기간	토픽에 보관되는 메시지들의 보존 기간
   	생성자	토픽을 생성한 사용자
   	[더 보기] 아이콘	- 수정: 토픽의 설명, 보존 기간 변경 - 삭제: 토픽을 삭제 ⚠️ Default-Topic은 삭제할 수 없습니다.

토픽 상세 보기

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

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

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

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

   토픽 상세 정보

   No	구분	설명
   ①	토픽	지정한 토픽의 이름
   	토픽 설명	토픽의 설명, 입력한 내용이 없는 경우 공란으로 표기
   ②	서브스크립션 개수	토픽에 포함된 서브스크립션 개수
   	토픽 메시지 보존 기간	토픽의 메시지 보존기간 설정
   ③	ID	토픽의 고유 ID
   	이름	사용자가 지정한 토픽의 이름
   	생성자	토픽을 생성한 사용자
   	암호화	토픽의 암호화 여부 *현재 디폴트는 사용이며, 추후 기능 업데이트 예정
   	생성일	토픽 생성일
   	토픽 메시지 보존 기간	토픽의 메시지 보존기간, 최대 7일 *Default-Topic은 31일까지 수정 가능

토픽 수정하기

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

안내

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

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

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

3. 토픽 수정 팝업창에서 원하는 토픽 보존 기간으로 변경한 후 [저장] 버튼을 클릭합니다.

   토픽 수정

토픽 삭제하기

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

안내

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

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

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

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

   토픽 삭제

토픽 모니터링하기

토픽의 모니터링 탭에서는 토픽 및 연결된 서브스크립션의 모니터링 결과를 확인할 수 있습니다.

안내

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

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

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

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

   토픽 모니터링

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

   
   

   Topic 제공 데이터

   메트릭 이름	유닛	설명
   초당 게시된 메시지	count/s	토픽에 게시된 메시지의 초당 개수
   초당 게시 요청	count/s	토픽에 메시지 게시를 요청한 초당 횟수
   초당 평균 메시지 사이즈	bytes/s	토픽에 게시된 메시지의 초당 평균 메시지 사이즈
   초당 게시 처리량	bytes/s	토픽에 게시된 메시지의 초당 처리량
   초당 게시 요청 당 평균 메시지	count/s	토픽의 초당 게시 요청 당 평균 메시지 개수
   보관 데이터	bytes	토픽에 보관된 데이터의 총 사이즈 ⚠️ 현재 토픽에 게시된 메시지는 사용자가 설정한 보존 기간보다 더 길게 저장될 수 있으며, 기능 개선 후 설정한 보존 기간만큼 저장될 예정입니다.

4. 모니터링 탭에서 Subscription을 선택한 뒤 조회할 서브스크립션을 선택합니다.

   서브스크립션 모니터링

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

   
   

   PULL 서브스크립션 제공 데이터

   메트릭 이름	유닛	설명
   초당 Pull 대비 확인 처리 메시지	count/s	Push 메시지에 대한 확인 처리 메시지의 초당 발생 횟수
   미처리 메시지	count	미처리 메시지 개수
   5분간 시점 되돌리기 요청	count	5분간 시점 되돌리기를 요청한 횟수
   초당 확인 처리 요청	count/s	확인 처리 요청의 초당 발생 횟수
   초당 Streaming Pull 응답	count/s	Streaming Pull 응답의 초당 횟수

   PUSH 서브스크립션 제공 데이터

   메트릭 이름	유닛	설명
   초당 Push 대비 확인 처리 메시지	count/s	Push 대비 초당 확인 처리 메시지 개수
   미처리 메시지	count	미처리 메시지 개수
   5분간 시점 되돌리기 요청	count	5분간 시점 되돌리기를 요청한 횟수
   초당 확인 처리 요청	count/s	확인 처리 요청의 초당 발생 횟수
   초당 Push 요청	count/s	Push 요청의 초당 발생 횟수