Kyb/DocsBeta

Cloud Discovery

Kyb can scan your Google Cloud Platform projects and automatically discover infrastructure, mapping raw cloud resources into architecture-level entities. Every discovered element goes through human review before entering your graph.

Prerequisites

To run a discovery scan, you need a GCP service account with read access to the Cloud Asset Inventory API. The service account key is uploaded to Kyb and used only for the duration of the scan.

Required GCP permissions

  • cloudasset.assets.listResource
  • cloudasset.assets.searchAllResources

The built-in role roles/cloudasset.viewer covers both. We recommend creating a dedicated service account with only this role.

Running a Discovery Scan

  1. 1. Navigate to Settings > Discovery or use the import menu in the Explorer.
  2. 2. Upload your GCP service account key (JSON format).
  3. 3. Select which resource types to discover. By default all 40+ types are enabled, but you can toggle individual types on or off.
  4. 4. Click Start Discovery. Kyb will scan your GCP project and propose architecture-level entities.

Supported Resource Types

Kyb discovers 40+ GCP resource types across compute, containers, networking, data, messaging, and AI/ML:

Compute Engine VMsGKE ClustersGKE WorkloadsCloud Run ServicesCloud FunctionsApp EngineCloud SQLBigQuery DatasetsCloud SpannerFirestoreCloud StoragePub/Sub TopicsVPC NetworksSubnetsLoad BalancersFirewallsCloud DNSVertex AICloud EndpointsAPI Gateway

AI Abstraction

Raw cloud resources are not architecture. A Compute Engine VM is infrastructure; what matters architecturally is the application or service running on it. Kyb's AI abstraction layer maps raw resources into ArchiMate-typed architecture entities:

  • A GKE Deployment running a payments service becomes an Application Component with specialization GKE Workload.
  • A Cloud SQL instance becomes a Technology Service with specialization Database.
  • Relationships between resources (e.g., a service connecting to a database) are proposed as ArchiMate relationships.

You can run discovery in deterministic-only mode to skip the AI abstraction step. This is faster and has no token cost, but produces infrastructure-level entities only.

Reviewing Discovered Elements

After a scan completes, Kyb presents the proposed elements in a review panel. For each element you can:

  • Accept -- Add the element to your graph as-is.
  • Reject -- Skip this element. It will not appear in your graph.
  • Reclassify -- Accept the element but change its type or specialization.

Resync: Detecting Changes

Run discovery again at any time to detect changes in your cloud infrastructure. Kyb produces a diff showing:

  • New -- Resources that appeared since the last scan.
  • Updated -- Resources whose properties changed.
  • Removed -- Resources that no longer exist in your cloud project.
  • Replaced -- Resources that were deleted and recreated (new ID, same purpose).

Coming soon

AWS and Azure discovery are on the roadmap.

Next: AI Assistant

Learn how to use natural language to build your architecture in AI Assistant.