How lyft/cartography works
Cartography collects infrastructure and identity data from many platforms, models assets and relationships, and syncs them into Neo4j for querying and security analysis. The main workflow is selecting a data source, collecting its inventory, writing graph data, then querying the graph or running security rules. Its model and graph-job layers build and execute graph operations; analysis and ontology modules add derived insights. The README documents broad platform coverage and rules; source excerpts show graph ingestion mechanics, but not the full CLI dispatch or every integration.
Main entry points: job.py Graph Jobs · cli.py CLI · querybuilder.py Query Builder · rules Security Rules
Components 22
Collection and Sync
- CLI
cartography/cli.py - Platform Collectors
cartography/intel - Azure Storage
cartography/intel/azure/storage.py - Configuration
cartography/config.py
Graph Engine
- Graph Jobs
cartography/graph/job.py - Graph Statements
cartography/graph/statement.py - Query Builder
cartography/graph/querybuilder.py - Analysis Builder
cartography/graph/analysisbuilder.py - Cleanup Builder
cartography/graph/cleanupbuilder.py - Neo4j Transactions
cartography/client/core/tx.py - Core Schemas
cartography/models/core - Ontology Schema
cartography/models/ontology - Statistics
cartography/stats.py
Analysis and Ontology
- Cloud Analysis
cartography/analysis/aws/analysis.py - Ontology Analysis
cartography/analysis/ontology/analysis.py
Security Checks
- Security Rules
cartography/rules - Rule Model
cartography/rules/spec/model.py
Drift Detection
- Drift CLI
cartography/driftdetect/cli.py - Deviation Detection
cartography/driftdetect/detect_deviations.py - Drift Storage
cartography/driftdetect/storage.py
Other components
- Operator
- Neo4j
Connections 20
- Operator → CLI: runs
- CLI → Platform Collectors: selects modules
- CLI → Configuration: configures
- Platform Collectors → Neo4j: syncs inventory
- Azure Storage → Graph Jobs: runs jobs
cartography/intel/azure/storage.py - Graph Jobs → Graph Statements: executes
cartography/graph/job.py - Graph Jobs → Cleanup Builder: builds cleanup
cartography/graph/job.py - Graph Jobs → Neo4j Transactions: executes queries
- Neo4j Transactions → Query Builder: uses queries
cartography/client/core/tx.py - Query Builder → Core Schemas: maps schemas
cartography/graph/querybuilder.py - Query Builder → Ontology Schema: maps ontology
cartography/graph/querybuilder.py - Analysis Builder → Cloud Analysis: builds analysis jobs
- Cloud Analysis → Neo4j: analyzes graph
- Ontology Analysis → Neo4j: analyzes graph
- Operator → Security Rules: runs checks
- Security Rules → Rule Model: uses definitions
cartography/rules/data/rules/object_storage_public.py - Security Rules → Neo4j: queries graph
- Operator → Drift CLI: runs
- Drift CLI → Deviation Detection: dispatches
- Deviation Detection → Drift Storage: uses storage