Knowledge Tree

Architecture Diagrams

Automatically generate architecture diagrams from your knowledge graph. Keep your documentation accurate with live diagrams.

Overview

Architecture diagrams are automatically generated from the knowledge graph, ensuring they are always accurate and up to date. The system supports multiple diagram types and rendering formats, from simple network topology maps to detailed service dependency diagrams.

Living documentation
Unlike manually maintained diagrams, Knowledge Tree diagrams are regenerated on every discovery run. When infrastructure changes, the diagrams update automatically.

Diagram types

Diagram typeDescription
Topology mapPhysical and logical network topology with subnets, VPCs, and connections
Dependency graphService dependencies showing which resources depend on which
Data flow diagramHow data moves between resources, with direction and protocol annotations
Network diagramSecurity groups, load balancers, and network paths
Deployment diagramResources organized by scope, region, and availability zone
Cloud architectureProvider-specific architecture view (AWS Well-Architected, GCP, Azure)

Rendering formats

Diagrams can be rendered in multiple formats:

  • Mermaid -- embeddable in Markdown, Confluence, and documentation
  • DrawIO -- editable with the DrawIO editor for manual refinement
  • SVG -- vector graphics for embedding in web pages and PDFs
  • Interactive -- zoomable, pannable, clickable diagram in the Knowledge Tree UI
  • GraphML -- machine-readable format for graph analysis tools
# Generated Mermaid diagram
graph TD
  subgraph "Production VPC (vpc-abc)"
    subgraph "Public Subnet"
      ALB["ALB: app-alb"]
    end
    subgraph "Private Subnet"
      EC2["EC2: app-server-1"]
      EC2 --> RDS["RDS: prod-db"]
    end
    EC2 --> ALB
  end

  Internet --> ALB

Auto-layout

The diagram engine automatically lays out resources for readability:

  • Hierarchical layout -- resources arranged by dependency depth
  • Force-directed layout -- organic layout for complex, densely connected graphs
  • Grid layout -- organized by scope, region, and availability zone
  • Grouping -- resources grouped by VPC, namespace, or custom tags
  • Collapsing -- nested groups that can be expanded or collapsed

Customization

Diagrams can be customized with:

  • Style rules -- color-code resources by type, provider, status, or tag
  • Filters -- include or exclude specific resource types, scopes, or providers
  • Annotations -- add labels, notes, and custom styling to specific resources
  • Templates -- save diagram configurations as reusable templates

Export and sharing

Diagrams can be exported and shared in various ways:

  • Embed -- embed live diagrams in Confluence, Notion, or any iframe-compatible tool
  • Download -- download as SVG, PNG, PDF, or DrawIO format
  • Scheduled export -- automatically email diagrams on a schedule
  • Version history -- previous versions of diagrams are preserved for comparison