AWS EventDrivenLens
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.yml file
- 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)
| |
