VersusControl/versus-incident

这是什么？

核心功能

• 01AI 代理学习正常日志模式，为新出现的异常创建事件。
• 02接收 Alertmanager、Grafana、Sentry、CloudWatch SNS、FluentBit 等工具的 Webhook。
• 03可将事件发送到 Slack、Microsoft Teams、Telegram、Viber、邮件和飞书。
• 04未确认的事件可升级至 PagerDuty、Opsgenie、incident.io、ServiceNow 或 AWS Incident Manager。
• 05使用 Go 模板自定义告警消息。
• 06通过 YAML 配置并支持环境变量。

适用场景

• 将多个监控工具的告警汇总到同一条通知链路。
• 在无需维护告警规则的情况下，发现应用日志中的意外错误。
• 为使用 PagerDuty 或 Opsgenie 的团队配置值班升级。
• 在一个面板中查看 Kubernetes 集群、工作负载和 Helm 发布情况。

快速上手

1. 1

   启动 Redis 用于保存代理的读取位置

   docker run -d --name versus-redis -p 6379:6379 redis:7
2. 2

   以训练模式运行启用 AI 代理的 Versus

   docker run -p 3000:3000 -e GATEWAY_SECRET=change-me -e AGENT_ENABLE=true -e AGENT_MODE=training -e REDIS_HOST=host.docker.internal -e REDIS_PORT=6379 -v $(pwd)/config:/app/config -v $(pwd)/data:/app/data ghcr.io/versuscontrol/versus-incident
3. 3

   在 localhost:3000 打开管理仪表板查看已学习的模式

使用前须知

• !代理运行前需要配置指向你日志的 config.yaml 和 agent_sources.yaml。
• !目前只实现了文件存储后端，redis 和 database 仅为配置占位。
• !AI 代理还需要一个运行中的 Redis 实例来保存日志源读取位置。

标签

常见问题

versus-incident 是什么？

自托管的 AI SRE 代理，学习日志正常模式，自动为新异常创建事件，并将告警推送到各通知渠道和值班系统。 Versus Incident 是一个自托管的事件管理服务，面向运维团队。事件有两种来源：一是 AI SRE 代理，它读取 Elasticsearch、本地文件等日志源，学习正常模式，在出现新错误时自动创建事件；二是接收 Alertmanager、Grafana、Sentry、CloudWatch SNS、FluentBit 等工具的 Webhook 告警，并通过 Go 模板格式化。

versus-incident 可以免费使用吗？用的什么许可证？

versus-incident 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。

versus-incident 还在维护吗？

活跃维护中。versus-incident 最近一次提交是在 2026年10月17日。

versus-incident 适合用来做什么？

将多个监控工具的告警汇总到同一条通知链路。 在无需维护告警规则的情况下，发现应用日志中的意外错误。 为使用 PagerDuty 或 Opsgenie 的团队配置值班升级。 在一个面板中查看 Kubernetes 集群、工作负载和 Helm 发布情况。

versus-incident 怎么安装和运行？

启动 Redis 用于保存代理的读取位置: docker run -d --name versus-redis -p 6379:6379 redis:7 以训练模式运行启用 AI 代理的 Versus: docker run -p 3000:3000 -e GATEWAY_SECRET=change-me -e AGENT_ENABLE=true -e AGENT_MODE=training -e REDIS_HOST=host.docker.internal -e REDIS_PORT=6379 -v $(pwd)/config:/app/config -v $(pwd)/data:/app/data ghcr.io/versuscontrol/versus-incident 在 localhost:3000 打开管理仪表板查看已学习的模式

在哪里获取 versus-incident？

源代码和安装说明在 GitHub 上：https://github.com/VersusControl/versus-incident