Cloud Workflows

Module: Cloud Workflows

Module flag: workflows Enabled by default: yes

---

Overview

The Cloud Workflows module lists workflows and their execution history. Use it to audit workflow definitions, track execution outcomes, and identify long-running or failed executions.

---

Enable This Module

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

---

Required GCP APIs

gcloud services enable workflows.googleapis.com

---

Required IAM Permissions

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

---

Tools

gcp_workflows_list

Lists Cloud Workflows in the project.

Parameters:

Name	Required	Description
project_id	yes	GCP project ID
location	no	Region; - or omit for all regions

Returns: Workflow name, region, state (ACTIVE / UNAVAILABLE), revision ID, service account, create time, update time, labels.

---

gcp_workflows_list_executions

Lists recent executions of a workflow.

Parameters:

Name	Required	Description
project_id	yes	GCP project ID
location	yes	Region
workflow_name	yes	Workflow name
limit	no	Max executions to return (default: 10)

Returns: Execution ID, state (SUCCEEDED / FAILED / CANCELLED / ACTIVE), start time, end time, duration, error message (for failed executions).

---

Prompt Examples

Inventory

"List all Cloud Workflows in project my-project."

Failure audit

"Show me the last 20 executions of the data-pipeline workflow in us-central1 — how many failed?"

Long-running detection

"Which workflow executions in project my-project have been running for more than 10 minutes?"

---

Related Modules

Module flag	Why you'd combine it
scheduler	Find Scheduler jobs that trigger these workflows
eventarc	Find Eventarc triggers that invoke these workflows
pubsub	Find Pub/Sub topics used within workflows
logging	Fetch execution logs for failed workflow steps