https://github.com/keephq/keep Skip to content Navigation Menu Toggle navigation Sign in * Product + GitHub Copilot Write better code with AI + Security Find and fix vulnerabilities + Actions Automate any workflow + Codespaces Instant dev environments + Issues Plan and track work + Code Review Manage code changes + Discussions Collaborate outside of code + Code Search Find more, search less Explore + All features + Documentation + GitHub Skills + Blog * Solutions By company size + Enterprises + Small and medium teams + Startups By use case + DevSecOps + DevOps + CI/CD + View all use cases By industry + Healthcare + Financial services + Manufacturing + Government + View all industries View all solutions * Resources Topics + AI + DevOps + Security + Software Development + View all Explore + Learning Pathways + White papers, Ebooks, Webinars + Customer Stories + Partners * Open Source + GitHub Sponsors Fund open source developers + The ReadME Project GitHub community articles Repositories + Topics + Trending + Collections * Enterprise + Enterprise platform AI-powered developer platform Available add-ons + Advanced Security Enterprise-grade security features + GitHub Copilot Enterprise-grade AI features + Premium Support Enterprise-grade 24/7 support * Pricing Search or jump to... Search code, repositories, users, issues, pull requests... Search [ ] Clear Search syntax tips Provide feedback We read every piece of feedback, and take your input very seriously. [ ] [ ] Include my email address so I can be contacted Cancel Submit feedback Saved searches Use saved searches to filter your results more quickly Name [ ] Query [ ] To see all available qualifiers, see our documentation. Cancel Create saved search Sign in Sign up Reseting focus You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session. You switched accounts on another tab or window. Reload to refresh your session. Dismiss alert {{ message }} keephq / keep Public * Notifications You must be signed in to change notification settings * Fork 706 * Star 5.2k The open-source alert management and AIOps platform keephq.dev License View license 5.2k stars 706 forks Branches Tags Activity Star Notifications You must be signed in to change notification settings * Code * Issues 166 * Pull requests 14 * Discussions * Actions * Projects 0 * Security * Insights Additional navigation options * Code * Issues * Pull requests * Discussions * Actions * Projects * Security * Insights keephq/keep main BranchesTags [ ] Go to file Code Folders and files Last Last Name Name commit commit message date Latest commit History 1,743 Commits .github .github assets assets docker docker docs docs ee ee examples/workflows examples/workflows keep-ui keep-ui keep keep keycloak keycloak otel-shared otel-shared proxy proxy scripts scripts templates templates tests tests .dockerignore .dockerignore .gitignore .gitignore .pre-commit-config.yaml .pre-commit-config.yaml .python-version .python-version CHANGELOG.md CHANGELOG.md CONTRIBUTING.md CONTRIBUTING.md LICENSE LICENSE README.md README.md STRESS.md STRESS.md docker-compose-with-arq.yml docker-compose-with-arq.yml docker-compose-with-auth.yml docker-compose-with-auth.yml docker-compose-with-otel.yaml docker-compose-with-otel.yaml docker-compose.common.yml docker-compose.common.yml docker-compose.dev.yml docker-compose.dev.yml docker-compose.yml docker-compose.yml poetry.lock poetry.lock pyproject.toml pyproject.toml render.yaml render.yaml start.sh start.sh View all files Repository files navigation * README * Code of conduct * License [keep] The open-source alert management and AIOps platform Single pane of glass, alert deduplication, enrichment, filtering and correlation, bi-directional integrations, workflows, dashboards. PRs Welcome Join Slack GitHub commit activity [6874747073] Docs * Try it out * Report Bug * Book a Demo * Website Sneak preview screenshot * 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 - GitHub Actions for your monitoring tools * AIOps 2.0 - AI-powered correlation and summarization See full platform documentation. Supported Integrations View the full list in our documentation Missing a provider? Submit a new provider request and we'll add it quickly! Observability Tools AppDynamics Axiom Azure Monitoring Centreon Checkmk Cilium AppDynamics Axiom Azure Monitoring Centreon Checkmk Cilium CloudWatch Coralogix Datadog Dynatrace Elastic GCP Monitoring CloudWatch Coralogix Datadog Dynatrace Elastic GCP Monitoring Grafana Graylog Kibana Netdata New Relic OpenObserve Grafana Graylog Kibana Netdata New Relic OpenObserve Parseable Pingdom Prometheus Rollbar Sentry SignalFX Parseable Pingdom Prometheus Rollbar Sentry SignalFX Site24x7 Splunk StatusCake SumoLogic UptimeKume VictoriaMetrics Site24x7 Splunk StatusCake SumoLogic UptimeKume VictoriaMetrics Zabbix Zabbix Databases & Data Warehouses BigQuery ClickHouse MongoDB MySQL PostgreSQL Snowflake BigQuery ClickHouse MongoDB MySQL PostgreSQL Snowflake Communication Platforms Discord Google Chat Mailchimp Mailgun Mattermost Ntfy.sh Discord Google Chat Mailchimp Mailgun Mattermost Ntfy.sh Pushover Resend SendGrid Slack SMTP Teams Pushover Resend SendGrid Slack SMTP Teams Telegram Twilio Telegram Twilio Incident Management Grafana Incident Grafana OnCall Ilert Incident.io AWS Incident Manager OpsGenie Grafana Incident Grafana OnCall Ilert Incident.io AWS Incident Manager OpsGenie PagerDuty Pagertree SINGL4 Squadcast Zenduty PagerDuty Pagertree SINGL4 Squadcast Zenduty Ticketing Tools GitHub GitLab Jira Linear LinearB Microsoft Planner GitHub GitLab Jira Linear LinearB Microsoft Planner Redmine ServiceNow Trello Redmine ServiceNow Trello Container Orchecstration Platforms Azure AKS GKE Kubernetes OpenShift Azure AKS GKE Kubernetes OpenShift Data Enrichment Bash OpenAI Python QuickChart SSH Webhook Bash OpenAI Python QuickChart SSH Webhook 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. 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 - 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 - 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. * Running Keep on Kubernetes. * Running Keep with Docker. * Running Keep on AWS ECS. * Running Keep on OpenShift. Keepers Top Contributors A special thanks to our top contributors who help us make Keep great. You are more than awesome! * Furkan * Asharon 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 [6874747073] About The open-source alert management and AIOps platform keephq.dev Topics python alarm alerts monitoring alerting python3 workflow-automation monitoring-tool alarms aiops Resources Readme License View license Code of conduct Code of conduct Activity Custom properties Stars 5.2k stars Watchers 23 watching Forks 706 forks Report repository Releases 66 v0.30.6 Latest Nov 28, 2024 + 65 releases Packages 0 No packages published Contributors 88 * @talboren * @shahargl * @Matvey-Kuk * @VladimirFilonov * @GlebBerjoskin * @Kiryous * @pehlicd * @dependabot[bot] * @35C4n0r * @ezhil56x * @asharonbaltazar * @rajesh-jonnalagadda * @srikary12 * @mobley-trent + 74 contributors Languages * Python 57.8% * TypeScript 41.3% * JavaScript 0.3% * CSS 0.3% * Shell 0.2% * SCSS 0.1% Footer (c) 2024 GitHub, Inc. Footer navigation * Terms * Privacy * Security * Status * Docs * Contact * Manage cookies * Do not share my personal information You can't perform that action at this time.