# yelparchive/elastalert

**Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/yelparchive-elastalert).**

_How this analysis was created: the description and tags below were written by an AI model that read this project's README and public documentation pages; stars, license and language come straight from the GitHub API. The model does not read the source code._

7,980 stars · 1,681 forks · Python · Apache-2.0

## Links

- GitHub: https://github.com/YelpArchive/elastalert
- Homepage: https://elastalert.readthedocs.org
- awesome-repositories: https://awesome-repositories.com/repository/yelparchive-elastalert.md

## Description

ElastAlert is a rule-based alerting framework for data stored in Elasticsearch. It runs as a Python command-line service that queries the data store on a schedule, hands the results to configured rules, and sends a notification when documents match a pattern such as a frequency spike, missing events, or a changed field value.

Its detection rules cover event volume (count thresholds, rate changes against a prior period, and the absence of expected events) and field values (blacklists and whitelists, changes for a shared key, never-before-seen terms, and shifts in distinct-value counts). Matches can be dispatched to email, chat tools, incident-management services, ticketing systems, text messages, or custom commands. Custom rule types, alert destinations, and match-enhancement modules can be added as plugins without changing the core engine.

Alerts can be batched into periodic reports, optionally on a cron-style schedule, or suppressed when the same rule fires again within a set window. Notification text can be customized, dashboard links added, and related events summarized. For testing, rules can be previewed without sending notifications, run against historical data between chosen timestamps, or checked against recent live data, and every query sent to the search backend can be logged. Large datasets are handled with date-based indexes, narrowed query windows, count queries, and terms aggregations.

Behavior is driven by text configuration files: a global settings file plus one file per rule. ElastAlert can be installed from a package manager or from source, or run from a prebuilt container image that also exposes a web API.

## Tags

### System Administration & Monitoring

- [Elasticsearch Alerting Frameworks](https://awesome-repositories.com/f/system-administration-monitoring/elasticsearch-alerting-frameworks.md) — A rule-based framework that queries Elasticsearch on a schedule and alerts on frequency spikes, missing events, or changed field values.
- [Event Count Thresholds](https://awesome-repositories.com/f/system-administration-monitoring/alert-thresholds/event-count-thresholds.md) — ElastAlert triggers when at least a set number of matching documents occur within a timeframe, or when fewer than a set number appear. ([source](https://github.com/yelparchive/elastalert#readme))
- [Anomaly Detection Rule Types](https://awesome-repositories.com/f/system-administration-monitoring/anomaly-detection-rule-types.md) — Provides configurable rule types for spikes, flatlines, new terms, blacklists and whitelists, and field changes in Elasticsearch event data.
- [Elasticsearch Alerting](https://awesome-repositories.com/f/system-administration-monitoring/elasticsearch-alerting.md) — Watches data stored in Elasticsearch and sends notifications when events match patterns such as spikes, anomalies, or forbidden values.
- [Multi-Channel Alerting Engines](https://awesome-repositories.com/f/system-administration-monitoring/multi-channel-alerting-engines.md) — ElastAlert sends each match to one or more destinations such as email, chat tools, incident-management services, ticketing systems, text messages, or custom commands. ([source](https://github.com/yelparchive/elastalert#readme))
- [Multi-Channel Notification Dispatch](https://awesome-repositories.com/f/system-administration-monitoring/notification-channels/notification-channel-configuration/multi-channel-notification-dispatch.md) — Delivers each match to email, chat tools, incident-management services, ticketing systems, text messages, or custom commands from one dispatch layer.
- [Multi-Channel Alerting](https://awesome-repositories.com/f/system-administration-monitoring/notification-channels/slack-notifications/email-alert-notifications/multi-channel-alerting.md) — Delivers alerts to email, chat tools, ticketing systems, incident-management services, or text messages so the right people are notified.
- [Alert Aggregators](https://awesome-repositories.com/f/system-administration-monitoring/alert-aggregators.md) — ElastAlert collects alerts over a set period and sends them together as one periodic report, optionally on a cron-style schedule, with aggregate counts and per-key separation. ([source](https://github.com/yelparchive/elastalert#readme))
- [Duplicate Alert Suppression](https://awesome-repositories.com/f/system-administration-monitoring/alert-suppression-systems/duplicate-alert-suppression.md) — ElastAlert drops further alerts from the same rule within a minimum time window, optionally tracked per field value, to prevent duplicate notifications. ([source](https://github.com/yelparchive/elastalert#readme))
- [Alerting Daemons](https://awesome-repositories.com/f/system-administration-monitoring/alerting-daemons.md) — Runs as a Python command-line service that executes configured rules continuously, with options for single-rule runs, custom config files and dry-run testing.
- [Alerting Plugin Frameworks](https://awesome-repositories.com/f/system-administration-monitoring/alerting-plugin-frameworks.md) — Offers a plugin design for custom rule types, alert destinations, and match-enhancement modules that slot into the existing pipeline.
- [Blacklist and Whitelist Alerting](https://awesome-repositories.com/f/system-administration-monitoring/blacklist-and-whitelist-alerting.md) — ElastAlert checks a field's value against a blacklist or whitelist and triggers when an event contains a forbidden or unapproved value. ([source](https://github.com/yelparchive/elastalert#readme))
- [Custom Rule and Alerter Plugins](https://awesome-repositories.com/f/system-administration-monitoring/custom-rule-and-alerter-plugins.md) — Allows custom rule types and alert destinations to be added through imported or newly written modules without modifying the core. ([source](https://github.com/yelparchive/elastalert#readme))
- [Missing Event Alerts](https://awesome-repositories.com/f/system-administration-monitoring/missing-event-alerts.md) — ElastAlert triggers when documents stop arriving for a monitored query, after the rule has seen at least one matching document. ([source](https://github.com/yelparchive/elastalert#readme))
- [Alerting Rule Validators](https://awesome-repositories.com/f/system-administration-monitoring/monitoring-and-observability/rule-based-alerting-engines/alerting-rule-validators.md) — Tests new rules before production by previewing alerts without sending, backtesting against historical data, and logging every query.
- [New Term Alerting](https://awesome-repositories.com/f/system-administration-monitoring/new-term-alerting.md) — ElastAlert triggers when a never-before-seen term appears in a field within a monitored period. ([source](https://github.com/yelparchive/elastalert#readme))
- [Notification Noise Reduction](https://awesome-repositories.com/f/system-administration-monitoring/notification-noise-reduction.md) — Reduces alert volume by suppressing repeats within a time window and bundling many matches into periodic summary reports.

### Data & Databases

- [Anomaly Detection](https://awesome-repositories.com/f/data-databases/anomaly-detection.md) — Detects event-rate spikes, never-before-seen field values, and missing data soon after they begin.
- [Query Schedulers](https://awesome-repositories.com/f/data-databases/query-schedulers.md) — ElastAlert queries the data store at regular intervals with a configured filter and passes the results to a rule that decides whether a match occurred. ([source](https://github.com/yelparchive/elastalert#readme))

### Development Tools & Productivity

- [Field](https://awesome-repositories.com/f/development-tools-productivity/change-tracking/field.md) — ElastAlert alerts when a tracked field changes between documents that share the same key, such as one user appearing from two countries. ([source](https://github.com/yelparchive/elastalert#readme))

### DevOps & Infrastructure

- [File-Based Configuration](https://awesome-repositories.com/f/devops-infrastructure/configuration-management/file-based-configuration.md) — Behavior is driven entirely by text configuration files, with a global settings file and per-rule files that define filters, timestamps, and alert targets.
- [Event Rate Change Detection](https://awesome-repositories.com/f/devops-infrastructure/event-triggers/event-pattern-detection/event-rate-change-detection.md) — ElastAlert compares the current event rate with a prior window of equal length and triggers when the rate rises or falls beyond a configured factor. ([source](https://github.com/yelparchive/elastalert#readme))

### Software Engineering & Architecture

- [Pluggable Module Loading](https://awesome-repositories.com/f/software-engineering-architecture/pluggable-module-loading.md) — Lets new detection logic be written or imported as modules that plug into the shared matching pipeline without changing the core engine.
