# YelpArchive/elastalert

Easy & Flexible Alerting With ElasticSearch

Repository: https://github.com/YelpArchive/elastalert
Canonical: https://ross.abutalabs.com/products/elastalert
Homepage: https://elastalert.readthedocs.org
Language: Python
License: Apache-2.0
License Family: permissive
Last push: 2024-08-07T06:30:10+00:00

## Health v2 (maintenance only)
Score: 23/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 0, release rhythm 8, longevity 100
- inputs: {"age_days": 4300, "days_push": 756, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 7987, forks 1686 (observed 2026-08-28T04:10:10.557456+00:00)

## What it is
ElastAlert is a Python framework for alerting on anomalies, spikes, and other patterns in data stored in Elasticsearch, with configurable rule types and many alert channels like Slack, PagerDuty, and email. The original Yelp project is no longer maintained; users should use the community fork ElastAlert2 instead.

## Use cases
- alert when error logs spike in elasticsearch
- notify slack when log pattern matches
- detect flatline in event rate
- blacklist monitoring on log fields
- send pagerduty alerts from elasticsearch queries

## When to choose
- you are already on an old ElastAlert deployment and need reference material
- you want to understand rule-based Elasticsearch alerting concepts

## When to avoid
- starting a new project - use ElastAlert2 instead
- you need maintained software or security fixes
- your data is not in Elasticsearch

## Facets
- artifact type: framework
- maturity: abandoned
- function: alerting, monitoring, search-engine, logging
- domain: monitoring, analytics
- platform: python, self-hosted
- tags: elasticsearch, log-alerting, anomaly-detection, deprecated, elastalert2-successor, devops, search, docker

## Member repositories
- YelpArchive/elastalert (main) score 23

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:10:10.557456+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T17:32:34.449020+00:00, confidence not recorded.
  - readme: https://github.com/YelpArchive/elastalert (fetched 2026-08-28T04:10:10.557456+00:00, sha eaef0eba14a9)
- Data as of 2026-08-30T08:39:29.467469+00:00.