VS Code extension to visualize EventBridge event flows in serverless architectures.
Features
- Graph view: interactive graph showing events, handlers, streams and APIs
- Tree view: sidebar panels listing events and their consumers
- Click-to-navigate: click a node to open the corresponding source file
- Auto-refresh: graph updates automatically when serverless files change
- Tooltips: hover over a node to see event patterns, filters and handler details
How it works
The extension scans your project for:
- Serverless function definitions (
serverless/functions/*.yml) - Event patterns (
serverless/eventPattern/*.json) - DynamoDB stream triggers (filter patterns in stream events)
- API Gateway endpoints (HTTP events)
It builds a directed graph showing:
- Which events trigger which handlers
- Which DynamoDB streams feed which processors
- Which filters are applied on each connection
Usage
- Open a workspace containing a
serverless.ymlfile - Open the command palette (
Cmd+Shift+P/Ctrl+Shift+P) - Run
AWS Event Driven Lens: Show Event Graph
Or use the AWS EventDrivenLens panel in the Activity Bar.
Available commands
| Command | Description |
|---|---|
AWS Event Driven Lens: Show Event Graph |
Display the event graph |
AWS Event Driven Lens: Refresh Graph |
Refresh the graph |
AWS Event Driven Lens: Filter by Event Name |
Filter by event name |
AWS Event Driven Lens: Clear Event Filter |
Clear the active filter |
Graph legend
| Color | Node type |
|---|---|
| 🔵 Blue | EventBridge Event |
| 🟠 Orange | Lambda Handler (EventBridge triggered) |
| 🟢 Green | Stream Handler (DynamoDB stream triggered) |
| 🟣 Purple | API Endpoint (HTTP triggered) |
| 🟡 Yellow | DynamoDB Table |
Interactions
- Click a handler/stream/API node → opens the TypeScript source file
- Hover over a node → shows a detailed tooltip with patterns and filters
- Zoom/Pan → use toolbar buttons or scroll
Installation
Install from the .vsix file:
code --install-extension aws-lens-event-driven-0.2.4.vsix
Or search for AWS EventDrivenLens on the VS Code Marketplace.
Roadmap
- Orphan event detection
- Detect events emitted by handlers (putEvents calls)
- PR diff mode (show added/removed flows)
- CloudWatch logs integration
- Impact analysis mode (highlight downstream effects)
- Cross-service graph (multi-repo scanning)