Event Or Outage
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.
Ask AI about Event Or Outage
Powered by Claude Β· Grounded in docs
I know everything about Event Or Outage. Ask me about installation, configuration, usage, or troubleshooting.
0/500
Reviews
Documentation
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
.envfile with OpenAPI/Gemini/Anthropic API Key (at least one)
Optional:
- A
HOLIDAY_API_KEYin the.envfile Holiday API - A
CALENDARIFIC_API_KEYin the.evenfile Calendrific
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 todayeventoroutage -d "February 14, 2025" -m "gpt-4o"β look for events at a specific date, using a specific modeleventoroutage -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 filegeneratedata -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 and Sylvain 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.

