Open-Source Event Tracking
Track events, monitor deployments, and manage your infrastructure
Tracker is a comprehensive event tracking and observability platform designed for modern distributed systems. It helps teams monitor deployments, track incidents, manage infrastructure catalogs, and coordinate operations across services.
- 🆓 Free & Open Source - No vendor lock-in, full control over your data
- 🚀 Easy to Deploy - Single Docker image with frontend & backend
- 📊 Rich UI - Beautiful React interface with dark mode
- 🔌 Multi-Protocol - gRPC, REST, and Swagger UI
- 📈 Observable - Built-in Prometheus metrics
- 🔄 Real-time - Track events as they happen
- 🎨 Customizable - Extend and adapt to your needs
Real-time overview with event velocity chart, environment breakdown, and live activity stream.
Chronological list of all events with advanced filtering by type, environment, priority and status.
Gantt-style visualization to detect and manage scheduling conflicts across services.
Monthly calendar view with per-day event details and overlap detection.
Dedicated page for resolving scheduling conflicts with team contact information.
Analytics over a configurable period — event distribution, top projects, and trends.
Inventory of all services, modules, libraries, and containers with version and owner tracking.
Interactive dependency graph of services registered in the catalog.
Version compliance tracking to identify projects using outdated deliverables.
View and manage deployment locks across all services and environments.
Track and manage configuration drifts with Jira integration.
Monitor Robotic Process Automation executions.
Quick access portal to all your tools and resources, synced from Homer.
- Multiple Event Types: Deployments, Operations, Drifts, Incidents, RPA Usage
- Rich Metadata: Priority, Status, Environment, Owner, Impact tracking
- Linking: Connect events to PRs, tickets, and related events
- Search & Filter: Powerful search across all event attributes
- Timeline View: Visualize events chronologically
- Calendar View: See events in a calendar format
- Insights: Analytics and trend visualization over configurable periods
- Inventory Management: Track modules, libraries, projects, containers
- Version Tracking: Monitor versions across your infrastructure
- Multi-Language: Support for Go, Java, Python, JavaScript, and more
- Repository Links: Direct links to GitHub/GitLab repositories
- Architecture View: Interactive service dependency graph
- Compliance Tracking: Identify projects with outdated deliverables
- Exclusive Locks: Prevent concurrent operations
- Lock Ownership: Track who owns which locks
- Automatic Cleanup: Locks expire automatically
- Coordination: Synchronize deployments and operations
- Lock Management UI: View and release locks directly from the interface
- Collapsible Sidebar: Clean navigation organized by domain
- Dashboard: Live activity stream with charts and statistics
- Streamline: Gantt chart with automatic overlap detection
- Calendar: Monthly calendar view of events
- Dark / Light / System mode: Three theme options
- Responsive: Works on desktop, tablet, and mobile
- Global Search:
Ctrl+Kinstant search across all data - Quick Actions: Header shortcuts to create events, locks, drifts, and more
- gRPC API: High-performance native API
- REST API: HTTP/JSON endpoints via grpc-gateway
- Swagger UI: Interactive API documentation
- OpenAPI Spec: Standard API specification
- MCP Server: Model Context Protocol for AI agents (Kiro, Claude, etc.)
- Prometheus: Built-in metrics endpoint
- Homer Integration: Sync links from your Homer dashboard
# Build the image
docker build -t bananaops/tracker:latest .# Run the container
docker run -d -p 27017:27017 --name tracker-mongo mongo:7
docker run -p 8080:8080 -p 8081:8081 -p 8765:8765 bananaops/tracker:latestAccess the application:
- 🌐 Web UI: http://localhost:8080
- 📚 Swagger UI: http://localhost:8080/docs
- 📊 Metrics: http://localhost:8081/metrics
- 🔌 gRPC: localhost:8765
# Start the application
docker-compose up -d
# View logs
docker-compose logs -f
# Stop the application
docker-compose downBackend:
# Clone the repository
git clone https://github.com/BananaOps/tracker.git
cd tracker
# Run the server
go run main.go servFrontend:
# Install dependenciescd web
npm install
# Start development server
npm run dev- 🚀 Installation Guide - Complete installation instructions
- ⚙️ Configuration Guide - Environment variables and settings
- 🔧 Development Guide - Set up development environment
- 📖 User Guide - How to use Tracker
- 📊 Events Guide - Working with events
- 📦 Catalog Guide - Managing service catalog
- 🔒 Locks Guide - Distributed locking
- 🔌 API Specification - API reference
- 📚 Swagger UI - Interactive API docs (when running)
- 🤖 MCP Server - Model Context Protocol server for AI agents
┌─────────────────────────────────────────────────────────────┐
│ Web Browser │
│ http://localhost:8080 │
└────────────────────────┬────────────────────────────────────┘
│
┌───────────────┼───────────────┐
│ │ │
┌────▼────┐ ┌────▼────┐ ┌────▼────┐
│ React │ │ REST │ │ Swagger │
│ UI │ │ API │ │ UI │
└─────────┘ └────┬────┘ └─────────┘
│
┌───────▼────────┐
│ grpc-gateway │
│ (REST→gRPC) │
└───────┬────────┘
│
┌──────────────┼──────────────┐
│ │ │
┌────▼────┐ ┌───▼────┐ ┌───▼────┐
│ Event │ │Catalog │ │ Lock │
│ Service │ │Service │ │Service │
└────┬────┘ └───┬────┘ └───┬────┘
│ │ │
└─────────────┼──────────────┘
│
┌──────▼──────┐
│ MongoDB │
│ / FeretDB │
└─────────────┘
Create a deployment event via REST API:
curl -X POST http://localhost:8080/api/v1alpha1/event \
-H "Content-Type: application/json" \
-d '{ "title": "Deploy service-api v2.1.0 to production", "attributes": { "message": "Deployed via GitHub Actions", "type": 1, "priority": 2, "service": "service-api", "status": 3, "environment": 7, "owner": "platform-team" }, "links": { "pullRequestLink": "https://github.com/org/repo/pull/123", "ticket": "PROJ-456" } }'Response:
{
"id": "507f1f77bcf86cd799439011",
"title": "Deploy service-api v2.1.0 to production",
"createdAt": "2024-01-15T10:30:00Z"
}# Get last 10 events
curl http://localhost:8080/api/v1alpha1/events?limit=10
# Filter by service
curl http://localhost:8080/api/v1alpha1/events?service=service-api
# Filter by environment
curl http://localhost:8080/api/v1alpha1/events?environment=7Add a service to the catalog:
curl -X POST http://localhost:8080/api/v1alpha1/catalog \
-H "Content-Type: application/json" \
-d '{ "name": "user-service", "type": 3, "language": 1, "version": "1.2.3", "repositoryUrl": "https://github.com/org/user-service", "description": "User management microservice" }'Track when infrastructure configuration deviates from expected state:
curl -X POST http://localhost:8080/api/v1alpha1/event \
-H "Content-Type: application/json" \
-d '{ "title": "Terraform drift detected in production", "attributes": { "message": "Manual changes detected in AWS security group", "type": 3, "priority": 3, "service": "infrastructure", "environment": 7 } }'Acquire a lock before deployment:
# Acquire lock
curl -X POST http://localhost:8080/api/v1alpha1/lock \
-H "Content-Type: application/json" \
-d '{ "name": "production-deployment", "owner": "ci-pipeline-123", "ttl": 3600 }'# Release lock
curl -X DELETE http://localhost:8080/api/v1alpha1/lock/production-deploymentMonitor robotic process automation executions:
curl -X POST http://localhost:8080/api/v1alpha1/event \
-H "Content-Type: application/json" \
-d '{ "title": "RPA: Invoice Processing Completed", "attributes": { "message": "Processed 150 invoices successfully", "type": 5, "priority": 1, "service": "invoice-automation", "status": 3 } }'curl -X POST http://localhost:8080/api/v1alpha1/event \
-H "Content-Type: application/json" \
-d '{ "title": "Production API Outage", "attributes": { "message": "API returning 500 errors", "type": 4, "priority": 4, "service": "api-gateway", "status": 1, "environment": 7, "impact": 3 }, "links": { "ticket": "INC-789", "slackThread": "https://workspace.slack.com/archives/C123/p456" } }'- Language: Go 1.26.2+
- API: gRPC + REST (grpc-gateway)
- Database: MongoDB / FeretDB (with automatic index optimization)
- Metrics: Prometheus
- Logging: Structured JSON logs
- Framework: React 19
- Language: TypeScript 5
- Build: Vite
- Styling: Tailwind CSS
- Icons: Lucide React + Font Awesome
- State: React Query (TanStack Query)
- Containerization: Docker multi-stage builds
- Orchestration: Kubernetes + Helm
- CI/CD: Skaffold
- Protocol: Protocol Buffers (protobuf)
We welcome contributions! Here's how you can help:
- 🐛 Report Bugs: Open an issue
- 💡 Suggest Features: Start a discussion
- 📝 Improve Docs: Submit documentation improvements
- 🔧 Submit PRs: Fix bugs or add features
See CONTRIBUTING.md for detailed guidelines.
Looking for a place to start? Check out issues labeled good first issue or help wanted.
- ✅ Core API: Production ready
- ✅ Web UI: Production ready
- ✅ Docker: Production ready
- ✅ Kubernetes: Production ready
- ✅ Slack App: Production ready (project github tracker-slack)
- 🚧 Github Action: In development
- 🚧 Webhooks: Planned
This project is licensed under the Apache 2.0 License - see the LICENSE file for details.
If you find Tracker useful, please consider giving it a star! ⭐
This project exists thanks to all the people who contribute. The contributors list is automatically updated.
Want to contribute? Check out our Contributing Guide!
- GitHub Issues: Report bugs or request features
- GitHub Discussions: Ask questions and share ideas
- Documentation: Read the docs
Made with ❤️ by the BananaOps community