Skip to content

Serverless Graph

Jump to bottom
Anna edited this page Jun 25, 2026 · 1 revision

Module: Serverless Graph

Module flag: serverlessgraph Enabled by default: yes

Overview

The Serverless Graph module exports a typed graph of the project's serverless and event-driven resources: Cloud Run services/jobs, Cloud Functions, Pub/Sub topics and subscriptions, Eventarc triggers, Cloud Scheduler jobs, Cloud Workflows, Cloud Tasks queues, and their dependencies.

This is a focused subset of the full Architecture Graph — faster to compute, scoped to event-driven infrastructure.

Enable This Module

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

Required GCP APIs

gcloud services enable run.googleapis.com cloudfunctions.googleapis.com \
  eventarc.googleapis.com cloudscheduler.googleapis.com \
  workflows.googleapis.com cloudtasks.googleapis.com \
  pubsub.googleapis.com

Required IAM Permissions

Role Tools that need it
roles/run.viewer Cloud Run nodes
roles/cloudfunctions.viewer Cloud Functions nodes
roles/eventarc.viewer Eventarc trigger edges
roles/cloudscheduler.viewer Scheduler job edges
roles/workflows.viewer Workflow nodes
roles/cloudtasks.viewer Cloud Tasks queue nodes
roles/pubsub.viewer Pub/Sub topic and subscription edges

Tools

gcp_export_serverless_graph

Exports the serverless and event-driven resource graph.

Parameters:

Name Required Description
project_id yes GCP project ID
region no Filter to a specific region
max_nodes no Cap on nodes returned (default: 500)

Returns: JSON graph with:

  • Nodes: 35 possible kinds including Cloud Run services/jobs, Cloud Functions, Pub/Sub topics/subscriptions, Eventarc triggers, Scheduler jobs, Workflows, Cloud Tasks queues
  • Edges: Typed directed relationships: publishes_to, subscribes_to, triggers, invokes, routes_to
  • Groups: Hierarchical grouping by project and region

Note: Results are cached for 5 minutes per project+region combination.

Prompt Examples

Graph export

"Export the serverless architecture graph for project my-project."

Pub/Sub fanout

"Show me all the consumers (Cloud Functions, Cloud Run services) that subscribe to Pub/Sub topics in project my-project."

Scheduler fanout

"Which Cloud Run services and Cloud Functions are triggered by Scheduler jobs in project my-project?"

Event chain tracing

"Trace the event flow starting from the order-created Pub/Sub topic in project my-project — what services and functions does it trigger?"

Related Modules

Module flag Why you'd combine it
archgraph Full project graph including GKE, networking, data stores
topology Deeper per-service dependency detail
pubsub Health signals for the topics shown in the graph
eventarc Detailed trigger configuration for Eventarc edges

Clone this wiki locally