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.

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

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.

   Item	Description
   Number of subscriptions	Number of subscriptions included in the topic
   Topic ID	Unique ID of the topic
   Topic message retention	Retention period for messages in the topic, up to 7 days *Default-Topic can be modified up to 31 days
   Creator	User who created the topic
   Created at	Date the topic was created

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

• Topic monitoring is not supported for Default-Topic.
• It may take some time to aggregate unprocessed messages during subscription monitoring, and messages that exceed the retry attempt limits are excluded from the aggregation.

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

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

3. Select the Monitoring tab to view the topic's details.

   Metrics provided by topics

   Metric Name	Unit	Description
   Published messages per sec	count/s	Number of messages published to the topic per second
   Publish requests per sec	count/s	Number of publish requests made to the topic per second
   Average message size per sec	bytes/s	Average size of messages published to the topic per second
   Publish throughput per sec	bytes/s	Amount of data published to the topic per second
   Average messages per publish request	count/s	Average number of messages per publish request per second
   Stored data	bytes	Total size of data stored in the topic

4. In the Monitoring tab, select the subscription and choose the subscription you want to view. For details, refer to Monitor subscription.