Manage topic

Create topic

A topic is used to distinguish specific message or event types. Multiple subscriptions can be added to a single topic.
Follow these steps to create a topic in the Pub/Sub service.

info

Excluding the Default-Topic, a maximum of 6 topics per project can be created. For details, refer to Pub/Sub quota.

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

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

3. On the Create topic page, enter the required information and click the [Create] button.

   Item	Description
   Name	Name assigned to the topic by the user
   Default subscription	Create: Creates a default pull subscription with the topic Do not create: Creates topic only, without a subscription
   Topic message retention period	Set the retention period for topic messages - Range: 10 minutes to 7 days
   Description (optional)	Additional description for the topic

Manage topic

A topic is used to distinguish specific message or event types.
Here is how to manage topics in the Pub/Sub service.

View topic list

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

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

2. In the Topic menu, review the topic list.

   Category	Description
   Name	Name assigned to the topic by the user
   Number of subscriptions	Number of subscriptions attached to the topic
   Message retention period	Retention period of messages stored in the topic
   Creator	User who created the topic

View topic details

You can view the detailed information of a topic.

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

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

3. View the topic details on the topic page.

   Category	Description
   Topic name	Name assigned to the topic by the user
   Topic ID	Unique ID of the topic
   Topic message retention period	Retention period of topic messages (max 7 days) * Default-Topic can be extended up to 31 days
   Creator	User who created the topic
   Created at	Timestamp when the topic was created

Modify topic

You can modify a topic’s description and message retention period. The retention period can be set between 10 minutes and 7 days.

info

Currently, only extensions to the message retention period are allowed. Reduction will be supported in a future update.
* Default-Topic retention can be extended from the default 7 days up to 31 days.

1. Go to KakaoCloud console > Analytics > Pub/Sub.
2. In the Topic menu, click the [More] icon of the topic to modify, then select Edit.
3. In the Edit topic popup, change the topic description and retention period, then click the [Save] button.

Delete topic

You can delete topics that are no longer in use.

info

Deleted topics cannot be recovered, and associated subscriptions will also be deleted.
⚠️ Default-Topic cannot be deleted.

1. Go to KakaoCloud console > Analytics > Pub/Sub.
2. In the Topic menu, click the [More] icon of the topic to delete, then select Delete.
3. In the Delete topic popup, enter the topic name and click the [Delete] button.

Monitor topic

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

info

Monitoring is not supported for Default-Topic.
Some delay may occur when aggregating undelivered messages. Messages that exceed the retry limit are excluded from the count.

1. Go to KakaoCloud console > Pub/Sub.

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

3. In the Monitoring tab, select the topic to view its metrics.

   Category	Description
   Topic	Topic tab
   Subscription	Subscription tab linked to the topic
   Data period	Time range shown in the monitoring graph - Options: 1 hour (default) / 3 hours / 12 hours / 1 day / 7 days
   View mode	Display layout of monitoring graph - Options: 1-column, 2-column, 3-column
   Auto-refresh interval	Set auto-refresh interval - Options: Do not auto-refresh (default) / 10s / 30s / 1m / 5m
   Manual refresh	Refreshes the monitoring data manually on click

   
   

   Topic metrics

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

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