https://github.com/rootly-ai-labs/eventoroutage
EventOrOutage is leveraging LLMs to help SREs understand if a drop in traffic is due to an external event (holiday, election, sport event...) instead of an outage.
https://github.com/rootly-ai-labs/eventoroutage
Last synced: 12 months ago
JSON representation
EventOrOutage is leveraging LLMs to help SREs understand if a drop in traffic is due to an external event (holiday, election, sport event...) instead of an outage.
- Host: GitHub
- URL: https://github.com/rootly-ai-labs/eventoroutage
- Owner: Rootly-AI-Labs
- License: gpl-3.0
- Created: 2025-02-20T17:20:36.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-03-13T14:20:52.000Z (about 1 year ago)
- Last Synced: 2025-03-13T15:20:26.904Z (about 1 year ago)
- Language: Python
- Homepage: https://rootly.ai/
- Size: 2.27 MB
- Stars: 3
- Watchers: 0
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
EventOrOutage 🌎
EventOrOutage is leveraging LLMs to help SREs understand if a drop in traffic is due to an external event (holiday, election, sport event...) instead of an outage. For each event, it shows the probably that the event could have an impact on traffic, which geographies are impacted and how many people may be involved.
This standalone prototype shows how such a feature could be useful as part of an AI SRE or embedded in a monitoring tool.
```
$ eventoroutage -d "february 9th, 2025"
Super Bowl LVIII – 85%:
- Number of people involved: Over 100 million
- Countries involved: United States
Lunar New Year Celebrations – 80%:
- Number of people involved: Approximately 1.5 billion
- Countries involved: China, Singapore, Malaysia, Indonesia, Philippines
```
## Requirements 📋
* Python > 3.10
* A `.env` file with OpenAPI/Gemini/Anthropic API Key (at least one)
**Optional:**
* A `HOLIDAY_API_KEY` in the `.env` file [Holiday API](https://holidayapi.com/)
* A `CALENDARIFIC_API_KEY` in the `.even` file [Calendrific](https://calendarific.com/)
## Get started 🚀
Run the following in a terminal
```
python -m venv .venv
source .venv/bin/activate
pip install .
eventoroutage
```
## Examples 📖
Here are a few ways you can use EventOrOutage:
* `eventoroutage` – will look for events happening today
* `eventoroutage -d "February 14, 2025" -m "gpt-4o"` – look for events at a specific date, using a specific model
* `eventoroutage -l IN` – look for events in a specific location, here India
* * `eventoroutage -i "Social Media"` – look for events that could impact a specific industry, here social media websites
* `eventoroutage -f "artifacts/traffic_events.csv"` – analyze traffic logs from a file
* ` generatedata -d .` – generates synthetic traffic logs
## Stack 🛠️
- **LLMs:** GPT-4, Claude, Gemini and self-hosted (Deepseek).
- **Agent:** HuggingFace smolagents
- **Data Sources:** External APIs for holidays, news, and event tracking
## Backstory
Back when [Jeba](https://www.linkedin.com/in/graydot/) and [Sylvain](https://www.linkedin.com/in/sylvainkalache/) were working at LinkedIn, they faced a situation where a large chunk of the site traffic was gone. Leadership panicked, engineering could not find the cause.
Turns out a major holiday was happening in India and people were busy celebrating, instead of browsing LinkedIn. Knowing about every potential major event in every country your product is used for isn’t possible, but LLMs are great at this type of task.
## Future Improvements
- Add support for additional data sources such as everyeventapi, Google Calendar API for holidays etc
- Integration in data from logging tools such as Loggly, Splunk to analyze traffic anomalies
## About the Rootly AI Labs
This project was developed by the Rootly AI Labs. The AI Labs is a fellow-led program designed to redefine reliability and system operations. We develop innovative prototypes, create open-source tools, and produce research reports we share with the community.
