Skip to content

Data Stores

Anna edited this page Jun 25, 2026 · 1 revision

Module: Data Stores

Module flag: datastores Enabled by default: yes


Overview

The Data Stores module provides read-only inventory for four managed database services: Cloud Spanner, AlloyDB for PostgreSQL, Firestore, and Memorystore (Redis). All tools are read-only.


Enable This Module

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

Required GCP APIs

gcloud services enable spanner.googleapis.com alloydb.googleapis.com \
  firestore.googleapis.com redis.googleapis.com

Required IAM Permissions

Role Service Tools that need it
roles/spanner.viewer Cloud Spanner gcp_spanner_list_instances
roles/alloydb.viewer AlloyDB gcp_alloydb_list_clusters
roles/datastore.viewer Firestore gcp_firestore_list_databases
roles/redis.viewer Memorystore gcp_memorystore_list_instances

Tools

gcp_spanner_list_instances

Lists Cloud Spanner instances.

Parameters:

Name Required Description
project_id yes GCP project ID

Returns: Instance name, configuration (region/multi-region), node count, processing units, edition (STANDARD / ENTERPRISE / ENTERPRISE_PLUS), state, labels.


gcp_alloydb_list_clusters

Lists AlloyDB clusters.

Parameters:

Name Required Description
project_id yes GCP project ID

Returns: Cluster name, location, state, PostgreSQL version, cluster type (PRIMARY / SECONDARY), network, labels.


gcp_firestore_list_databases

Lists Firestore databases in the project.

Parameters:

Name Required Description
project_id yes GCP project ID

Returns: Database name, type (FIRESTORE_NATIVE / DATASTORE_MODE), location, concurrency mode, state.


gcp_memorystore_list_instances

Lists Memorystore Redis instances.

Parameters:

Name Required Description
project_id yes GCP project ID
region no Filter by region; - or omit for all regions

Returns: Instance name, region, tier (BASIC / STANDARD_HA), memory size (GB), Redis version, host (IP), port, state, labels.


Prompt Examples

Inventory

"List all managed databases in project my-project — Spanner, AlloyDB, Firestore, and Memorystore."

Spanner sizing

"Which Cloud Spanner instances in project my-project are using fewer than 3 nodes?"

Redis HA check

"Which Memorystore Redis instances are running in BASIC tier (no HA) in project my-project?"

Firestore mode audit

"Which Firestore databases in project my-project are in DATASTORE_MODE?"


Related Modules

Module flag Why you'd combine it
cloudrun Find Cloud Run services that connect to these databases
networking Inspect the VPC networks hosting private database endpoints
archgraph Include data stores in the full architecture graph

Clone this wiki locally