Chaos Genius 🔮

Chaos Genius is an open-source business observability platform. Chaos Genius enables businesses to monitor thousands of KPIs, across multiple data sources, and perform automated root cause analysis for any deviation in the KPIs.

Chaos Genius can help teams reduce their Mean-Time-To-Detect (MTTD) and Mean-Time-To-Resolve (MTTR) for any issues in their business and system KPIs.

Standard BI dashboards enable data visualization to track how select metrics are trending. However, diagnosing why a particular metric or KPI has changed, remains a woefully manual process involving slicing & dicing the data, coordination with multiple teams in an organisation to identify related events and monitoring externalities.

With Chaos Genius, we aim to automate the diagnosis and root-cause-analysis for deviations in different business and system KPIs at scale.

Find detailed Documentation here!

✅ Key Use-Cases

Business KPI Observability - All important business KPIs such as Sign Ups, Payment Gateway Failures, Fraud Detection, Ad Spend, Campaign Performance, DAUs, Retention, Engagement and many others.

Data Quality KPI Observability - Data quality metrics like Data Volume, Freshness, Max, Mean, Median, Min, Missing Data, Null Count and many others.

Systems KPI Observability - System metrics like Cloud Costs, Cloud Failure, Infra performance and many others.

IOT/Device KPI Observability - Device metrics like performance, data volumes, uptime and many others.

🧰 Key Features

DeepDrills - Multidimensional drill-downs & waterfall analysis to identify the top drivers of change in a KPI across multiple dimensions.

Anomaly Detection - Modular anomaly detection toolkit for monitoring high-dimensional time series with ability to select from different models. Anomaly investigation across multiple dimensions and data quality metrics like volume, max, mean and missing data.

Smart Alerts - No more alert fatigue from static alerts. Self-learning thresholds to reduce false positives. Configurations to setup alert frequency & severity. Choose from multiple destinations like Slack, Email and other channels for your team.

Integrations - Modular architecture to enable multiple data sources including databases, data warehouses and multiple third party connectors like Stripe, Shopify, Zendesk, Google Analytics, and many others.

See more on our website.

⚙️ Quick Install

git clone https://github.com/chaos-genius/chaos_genius

cd chaos_genius

docker-compose up

Visit http://127.0.0.1:8080

Upgrade from earlier versions

To update the install first make sure the docker containers are down with docker-compose down

Then update the repo & docker builds by following commands:

git pull docker-compose pull

And then bring back the containers with docker-compose up

Quick start & support

Follow this Quick Start guide showing you how to connect a data source, define your first KPI, configure Anomaly Detector on your local machine.

If you want to schedule office hours with our team to help you get set up, please select some time directly here.

🌱 Community

Chaos Genius is a community driven initiative. For any help, discussions, suggestions feel free to reach out to the Chaos Genius team and the Community on either of the following channels.

GitHub (report bugs, contribute, follow roadmap)
Slack (For discussion with the Community and Chaos Genius team)
Book Office Hours(Set Up time with Chaos Genius team for any questions or help with setup)
Blog (Follow us on latest trends on Data, Machine Learning, Open Source and more)

🚦 Roadmap

Our goal is to make Chaos Genius production ready for all organisations irrespective of their data infrasturcture, data sources and scale requirements. With that in mind we have created the following roadmap for Chaos Genius. If you see something missing or wish to make suggestions, please drop us a line on our community Slack or raise an issue.

🐛 Contributing

Here's a shout out to all our contributors.

Want to contribute? Visit our Github repo and get started with:

Try Chaos Genius and share your feedback.
Submit an issue.
Create a pull request. Here's a list of issues to start with.
Share a part of the documentation that you find difficult to follow.
Translate our Readme.
Show us some love - Give us a star!

📜 License

Chaos Genius is licensed under the MIT license.

Contributors ✨

Thanks goes to these wonderful people (emoji key):

_pshrimal21 📆 📖 🤔 🎨	_{Harshit Surana} 💻 🔣 🔬 🐛	_{Manas Solanki} 💻 👀 🔧 🐛	_{Kartikay Bagla} 💻 🚧 🔬	_{Varun P} 💻 🚧 🔬	_{Keshav Pradeep} 💻 🔣 📖	_{Daj Katal} 🔌 📖
_{Amatullah Sethjiwala} 💻 🔣 ⚠️	_juzarbhori 💻 🎨	_{Amogh Dhar Diwan} 💻 🔣 🐛	_{Samyak Sarnayak} 💻 📦 🐛	_{Aayush Naik} 💻 🐛 📦	_{Kshitij Agarwal} 💻 🔧 🐛	_{Bhargav S. Kumar} 💻 📦 🐛
_{moghankumar06} 💻 🎨	_{Santhoshkumar1023} 💻 🎨	_{Mansi-Chauhan27} 🔌	_{davidhayter-karhoo} 🐛	_{Marijn van Aerle} 🐛	_gxu-kangaroo 🐛	_{RamneekKaur983} 💻
_arvind-27 🔣	_{Josh Taylor} 🐛	_ChartistDev 💻 🎨 🐛 👀