Create and manage topic

Create topic

A topic is an element that categorizes specific messages or event types, and multiple subscriptions can be added to a single topic.

Here’s how to create a topic in the Pub/Sub service.

info

You can create up to three new topics per project, excluding the Default-Topic.

1. Go to KakaoCloud Console > Analytics > Pub/Sub.

2. In the Topic menu, click the [Create topic] button.

3. In the popup, enter the required information, then click the [Create] button.

   Create topic

   Field	Description
   Name	Example: topic-01-test
   Default subscription	Create: Create a default pull subscription with the topic Not to create: Create only the topic without a default subscription
   Topic message retention	Set the message retention period for the topic
   Description (optional)	Additional information about the topic

Manage topic

A topic is an element that categorizes specific messages or event types. Here’s how to manage topics in the Pub/Sub service.

View topic list

You can view the list of created topics and their basic information.

1. Go to KakaoCloud Console > Analytics > Pub/Sub.

2. In the Topic menu, view the list of topics.

   Topic list

   Item	Description
   Name	Name of the topic as designated by the user
   Number of subscriptions	Number of subscriptions included in the topic - Unit: items
   Encryption	Whether the topic is encrypted - Currently, the default is Enabled, with further updates planned
   Message retention	Retention period for messages stored in the topic
   Creator	User who created the topic
   [More] icon	- Modify: Change the topic’s description and retention period - Delete: Delete the topic ⚠️ Default-Topic cannot be deleted.

View topic details

You can view detailed information about a topic.

1. Go to KakaoCloud Console > Analytics > Pub/Sub.

2. In the Topic menu, select a topic.

3. Check the details on the topic’s detail page.

   Topic details

   Item	Description
   Number of subscriptions	Number of subscriptions included in the topic
   Topic message retention	Retention period for messages in the topic
   Topic ID	Unique ID of the topic
   Topic name	Name of the topic as designated by the user
   Creator	User who created the topic
   Encryption	Whether the topic is encrypted *Currently, the default is Enabled, with further updates planned
   Created at	Date the topic was created
   Topic message retention	Retention period for messages in the topic, up to 7 days *Default-Topic can be modified up to 31 days

Modify topic

You can modify the description and retention period of a topic. The retention period can be set from a minimum of 10 minutes to a maximum of 7 days.

info

Currently, the topic retention period can only be extended. The ability to shorten the period will be added in a future update.
For the Default-Topic, the retention period can be set from 7 to 31 days.

1. Go to KakaoCloud Console > Analytics > Pub/Sub.

2. In the Topic menu, select the [More] icon > Modify.

3. In the popup, change the retention period to the desired duration, then click [Save].

   Modify topic

Delete topic

You can delete topics that are no longer needed.

info

Deleted topics cannot be recovered, and their associated subscriptions will also be deleted.

1. Go to KakaoCloud Console > Analytics > Pub/Sub.

2. In the Topic menu, select the [More] icon > Delete.

3. In the popup, enter the name of the topic to delete, then click [Delete].

Monitor topic

In the Monitoring tab of a topic, you can check the monitoring results for the topic and its connected subscriptions.

info

Default-Topic does not support topic monitoring.
Subscription monitoring may take some time to aggregate unprocessed messages, and messages that have exceeded the retry count will be excluded from the aggregation.

1. Go to KakaoCloud Console > Pub/Sub.

2. In the Topic menu, select the topic to monitor.

3. In the Monitoring tab, select a topic.

   Data provided by topic

   Metric name	Unit	Description
   Published message per sec	count/s	Published messages
   Publish requests per second	count/s	Publish requests
   Average message size per second	bytes	Average message size
   Throughput per second	bytes/s	Publish throughput
   Average messages per Publish request per sec	count/s	Average messages per request

4. Then, go to the Subscription tab.

   Data Provided for PULL Subscriptions

   Metric Name	Unit	Description
   Acknowledged messages per second compared to Pull	count/s	Number of acknowledged messages compared to Pulls
   Number of unprocessed messages	count	Number of unprocessed messages
   Rewind timestamp request for 5 mins	count	Number of seek requests in the past 5 minutes
   Acknowledgement requests per second	times/s	Number of acknowledgment requests
   Streaming Pull requests per second	times/s	Streaming Pull responses

   Data Provided for PUSH Subscriptions

   Metric Name	Unit	Description
   Acknowledged messages per second compared to Push	count/s	Number of acknowledged messages compared to Pushes
   Number of unprocessed messages	count	Number of unprocessed messages
   Rewind timestamp request for 5 mins	count	Number of seek requests in the past 5 minutes
   Push requests per second	count/s	Number of Push requests