https://github.com/keephq/keep
The open-source AIOps and alert management platform
https://github.com/keephq/keep
aiops alarm alarms alerting alerts monitoring monitoring-tool python python3 workflow-automation
Last synced: 6 months ago
JSON representation
The open-source AIOps and alert management platform
- Host: GitHub
- URL: https://github.com/keephq/keep
- Owner: keephq
- License: other
- Created: 2023-02-04T18:43:27.000Z (almost 3 years ago)
- Default Branch: main
- Last Pushed: 2025-05-13T16:27:06.000Z (6 months ago)
- Last Synced: 2025-05-13T17:36:05.450Z (6 months ago)
- Topics: aiops, alarm, alarms, alerting, alerts, monitoring, monitoring-tool, python, python3, workflow-automation
- Language: Python
- Homepage: https://keephq.dev
- Size: 77.7 MB
- Stars: 10,139
- Watchers: 35
- Forks: 964
- Open Issues: 285
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
- awesome-platform-engineering-tools - Keep - CLI for alerting
- awesome-opensource-israel - keep - The open-source alerts management and automation platform   (Projects by main language / python)
- awesome - keephq/keep - The open-source AIOps and alert management platform (Python)
- awesome-github-repos - keephq/keep - The open-source AIOps and alert management platform (Python)
- jimsghstars - keephq/keep - The open-source alert management and AIOps platform (Python)
- awesome-repositories - keephq/keep - The open-source AIOps and alert management platform (Python)
- awesome-ops - keephq/keep - 02-04|2025-06-30 | 开源 AIOps 和警报管理平台 | (Monitor)
- awesome-safety-critical-ai - `keephq/keep` - source AIOps and alert management platform (<a id="tools"></a>🛠️ Tools / Bleeding Edge ⚗️)
- AiTreasureBox - keephq/keep - 11-03_10869_0](https://img.shields.io/github/stars/keephq/keep.svg)|The open-source alert management and AIOps platform| (Repos)
README
The open-source AIOps and alert management platform
Single pane of glass, alert deduplication, enrichment, filtering and correlation, bi-directional integrations, workflows, dashboards.
Docs
·
Try it out
·
Report Bug
·
Book a Demo
·
Website
- 🔍 **Single pane of glass** - Best-in-class customizable UI for all your alerts and incidents
- 🛠️ **Swiss Army Knife for alerts** - Deduplication, correlation, filtering and enrichment
- 🔄 **Deep integrations** - Bi-directional syncs with monitoring tools, customizable workflows
- ⚡ **[Automation](#workflows)** - GitHub Actions for your monitoring tools
- 🤖 **AIOps 2.0** - AI-powered correlation and summarization
> See full [platform documentation](https://docs.keephq.dev).
## Supported Integrations
> View the full list in our [documentation](https://docs.keephq.dev/providers/documentation)
> Missing a provider? [Submit a new provider request](https://github.com/keephq/keep/issues/new?assignees=&labels=provider&projects=&template=new_provider_request.md&title=) and we'll add it quickly!
### AI Backends for Enrichments, Correlations and Incident Context Gathering
Anthropic
OpenAI
DeepSeek
Ollama
LlamaCPP
Grok
### Observability Tools
AppDynamics
Axiom
Azure Monitoring
Centreon
Checkmk
Cilium
Checkly
CloudWatch
Coralogix
Dash0
Datadog
Dynatrace
Elastic
GCP Monitoring
Grafana
Grafana Loki
Graylog
Kibana
LibreNMS
NetBox
Netdata
New Relic
OpenSearch Serverless
Parseable
Pingdom
Prometheus
Rollbar
Sentry
SignalFX
OpenObserve
Site24x7
Splunk
StatusCake
SumoLogic
ThousandEyes
UptimeKuma
VictoriaLogs
VictoriaMetrics
Wazuh
Zabbix
### Databases & Data Warehouses
BigQuery
ClickHouse
Databend
MongoDB
MySQL
PostgreSQL
### Communication Platforms
Discord
Google Chat
Mailgun
Mattermost
Ntfy.sh
Pushover
Resend
SendGrid
Slack
SMTP
Teams
Zoom
### Incident Management
Grafana Incident
Grafana OnCall
Ilert
Incident.io
AWS Incident Manager
OpsGenie
PagerDuty
Pagertree
SINGL4
Squadcast
Zenduty
Flashduty
### Ticketing Tools
Asana
GitHub
GitLab
Jira
Linear
LinearB
Microsoft Planner
Monday
Redmine
ServiceNow
Trello
YouTrack
### Container Orchecstration Platforms
Azure AKS
ArgoCD
GKE
Kubernetes
OpenShift
### Data Enrichment
Bash
OpenAI
Python
QuickChart
SSH
Webhook
### Workflow Orchestration
### Queues
## Workflows
Keep is GitHub Actions for your monitoring tools.
A Keep Workflow is a declarative YAML file that automates your alert and incident management. Each workflow consists of:
- **Triggers** - What starts the workflow (alerts, incidents, schedule or manual)
- **Steps** - Read or fetch data (enrichment, context)
- **Actions** - Execute operations (update tickets, send notifications, restart servers)
Here's a simple workflow that creates a Jira ticket for every `critical` alert from `sentry` for `payments` and `api` services.
For more workflows, see [here](https://github.com/keephq/keep/tree/main/examples/workflows).
```yaml
workflow:
id: sentry-alerts
description: create ticket alerts for critical alerts from sentry
triggers:
- type: alert
# customize the filter to run only on critical alert from sentry
filters:
- key: source
value: sentry
- key: severity
value: critical
# regex to match specific services
- key: service
value: r"(payments|ftp)"
actions:
- name: send-slack-message-team-payments
# if the alert is on the payments service, slack the payments team
if: "'{{ alert.service }}' == 'payments'"
provider:
type: slack
# control which Slack configuration you want to use
config: " {{ providers.team-payments-slack }} "
# customize the alert message with context from {{ alert }} or any other {{ step }}
with:
message: |
"A new alert from Sentry: Alert: {{ alert.name }} - {{ alert.description }}
{{ alert}}"
- name: create-jira-ticket-oncall-board
# control the workflow flow with "if" and "foreach" statements
if: "'{{ alert.service }}' == 'ftp' and not '{{ alert.ticket_id }}'"
provider:
type: jira
config: " {{ providers.jira }} "
with:
board_name: "Oncall Board"
custom_fields:
customfield_10201: "Critical"
issuetype: "Task"
# customize the summary
summary: "{{ alert.name }} - {{ alert.description }} (created by Keep)"
description: |
"This ticket was created by Keep.
Please check the alert details below:
{code:json} {{ alert }} {code}"
# enrich the alerts with more context. from now on, the alert will be assigned with the ticket id, type and url
enrich_alert:
- key: ticket_type
value: jira
- key: ticket_id
value: results.issue.key
- key: ticket_url
value: results.ticket_url
```
## Enterprise Ready
- **Developer First** - Modern REST APIs, native SDKs, and comprehensive documentation for seamless integration
- **[Enterprise Security](https://docs.keephq.dev/deployment/authentication/overview)** - Full authentication support (SSO, SAML, OIDC, LDAP) with granular access control (RBAC, ABAC) and team management
- **Flexible Deployment** - Deploy on-premises or in air-gapped environments with cloud-agnostic architecture
- **[Production Scale](https://docs.keephq.dev/deployment/stress-testing)** - High availability, performance-tested infrastructure supporting horizontal scaling for enterprise workloads
## Getting Started
> Need help? Can't find your environment listed? Reach out on Slack and we'll help you quickly.
Keep can run in various environments and configurations. The easiest way to start is with Keep's Docker Compose.
- Running Keep [locally](https://docs.keephq.dev/development/getting-started).
- Running Keep on [Kubernetes](https://docs.keephq.dev/deployment/kubernetes/installation).
- Running Keep with [Docker](https://docs.keephq.dev/deployment/docker).
- Running Keep on [AWS ECS](https://docs.keephq.dev/deployment/ecs).
- Running Keep on [OpenShift](https://docs.keephq.dev/deployment/kubernetes/openshift).
## 🫵 Keepers
### Top Contributors
A special thanks to our top contributors who help us make Keep great. You are more than awesome!
- [Furkan](https://github.com/pehlicd)
- [Asharon](https://github.com/asharonbaltazar)
Want to become a top contributor? Join our Slack and DM Tal, Shahar, or Furkan.
### Contributors
Thank you for contributing and continuously making Keep better, you're awesome 🫶
