Pub Sub

Module: Pub/Sub

Module flag: pubsub Enabled by default: yes

---

Overview

The Pub/Sub module provides topic and subscription inventory with health signals. Use it to inspect subscription lag, unacknowledged message counts, dead-letter topics, and push endpoint configuration.

---

Enable This Module

GCP_PROJECT_ID=my-project ./aura-tracker-gcp --modules pubsub

---

Required GCP APIs

gcloud services enable pubsub.googleapis.com

---

Required IAM Permissions

Role	Tools that need it
roles/pubsub.viewer	All tools

---

Tools

gcp_pubsub_list_topics

Lists all Pub/Sub topics in the project.

Parameters:

Name	Required	Description
project_id	yes	GCP project ID

Returns: Topic name, labels, subscription count, KMS key name (if CMEK).

---

gcp_pubsub_inspect_topic_health

Fetches subscription lag and unacknowledged message counts for all subscriptions on a topic.

Parameters:

Name	Required	Description
project_id	yes	GCP project ID
topic_name	yes	Topic name (short form or full resource name)

Returns: Per-subscription oldest unacked message age, undelivered message count, delivery type (push/pull), dead-letter topic name (if configured).

---

gcp_pubsub_list_subscriptions

Lists all subscriptions in the project.

Parameters:

Name	Required	Description
project_id	yes	GCP project ID
topic	no	Filter to subscriptions on a specific topic

Returns: Subscription name, topic, delivery type, push endpoint URL, ack deadline, retain acknowledged messages, dead-letter topic, expiration policy.

---

Prompt Examples

Inventory

"List all Pub/Sub topics in project my-project and their subscription counts."

Lag detection

"Which Pub/Sub subscriptions in project my-project have more than 10,000 unacknowledged messages?"

Dead-letter audit

"Which subscriptions do not have a dead-letter topic configured?"

Push endpoint audit

"List all push subscriptions and their endpoint URLs — are any pointing to non-HTTPS endpoints?"

---

Related Modules

Module flag	Why you'd combine it
eventarc	See which Eventarc triggers use Pub/Sub as transport
functions	Find Cloud Functions triggered by these topics
cloudrun	Find Cloud Run services receiving push messages
serverlessgraph	Map topic→subscription→consumer edges in the event graph