Condux error monitoring

Condux

Condux 是一个源代码可用的错误监控平台，内置 AI 修复引擎。

SDK 会将错误报告到无状态接收中继。中继会验证 DSN，应用各套餐的速率限制和配额，并在通过 Redpanda 缓冲前清除 PII。消费者会为事件生成指纹并将其分组为问题，将时间序列写入 ClickHouse，并将问题状态写入 PostgreSQL。Next.js 仪表板会读取这些数据，并按分组问题展示堆栈跟踪、面包屑、标签分类和每小时图表；当出现新问题或问题复发时，系统会通过电子邮件、Slack、Discord 和 Webhook 发送告警。

The Conductor

修复引擎会将问题转化为草稿拉取请求。它会根据堆栈跟踪和项目的代码映射，整理出范围受限且已清除敏感信息的上下文，将其发送给 Claude 或组织提供的模型，并在新分支上应用模型返回的更改，创建草稿拉取请求。修复绝不会自动合并。

仓库访问通过 GitHub App 和短期有效的安装令牌实现；模型不会获得该令牌。修复 PR 合并后，验证循环会根据问题后续的事件数量进行比较，并在问题于配置的时间窗口内持续没有新事件时将其解决。

已连接仓库中尚未处理的 Dependabot 发现结果，也可以通过同一引擎转换为依赖项升级草稿 PR。

每次运行都会计入组织的月度额度和支出上限；每次运行的成本根据记录的模型令牌用量计算。

兼容性

接收端支持 Sentry envelope 和 store 格式，因此现有 Sentry SDK 只需更改 DSN，即可向 Condux 报告错误。系统也接受 OTLP/HTTP 日志，因此经过 OpenTelemetry 插桩的应用无需 SDK 即可报告错误。

我们为 JavaScript/Node、浏览器、edge、Next.js、Python、Go、Ruby、PHP、JVM 和 .NET 提供一方 SDK，并提供适用于 React、Express、Flask/Django/FastAPI、Rails、ASP.NET Core 和 Spring Boot 的框架适配器。SDK 采用 Apache-2.0 许可证；服务端采用 FSL 许可证。

MCP 端点

只读的 Model Context Protocol 端点可让 AI Agent 根据真实的生产错误进行调试。让 Claude、Cursor 或任何 MCP 客户端使用范围受限的令牌连接到项目后，即可列出问题、读取堆栈跟踪并分页浏览事件。此端点不提供写入工具，且每个令牌只能对应一个项目。

架构

基于 .NET 10 服务和 Next.js / React / TypeScript 仪表板。

 SDKs ──envelope──▶ [Relay] ──▶ [Redpanda] ──▶ [Consumer] ──▶ ClickHouse (events, time series)
                                                          └──▶ PostgreSQL (issues, orgs, audit)
 Dashboard ──▶ [ControlPlane] ──▶ [Conductor] ──▶ draft PR

Valkey 用于支持速率限制和月度配额。中继不保存任何状态。原始事件通过由列驱动的 ClickHouse TTL 按套餐过期，无需定时任务。

仓库结构

路径	内容
backend/	.NET 解决方案：Condux.Relay（接收）、Condux.ControlPlane（API）、Condux.Consumer、Condux.Conductor（修复引擎）、Condux.Core（敏感信息清除、分组、套餐、配额）
web/	Next.js 仪表板
sdks/	客户端 SDK 和框架适配器
packages/	前端共享包
proto/	Protobuf 契约
migrations/	PostgreSQL 和 ClickHouse 架构，带编号且可幂等执行
contracts/	导出的 OpenAPI 文档和 Postman 集合
deploy/	Docker Compose 堆栈和 Helm chart
examples/	用于报告错误的示例应用

要求

• .NET SDK 10.0 或更高版本
• Node 22 或更高版本，以及 pnpm
• Docker 和 Compose

运行

cp deploy/.env.example deploy/.env
docker compose --env-file deploy/.env -f deploy/docker-compose.yml up -d

仪表板位于 http://localhost:3200，API 位于 8080。

从源代码构建和测试：

cd backend && dotnet build Condux.sln -c Release
cd backend && dotnet test Condux.sln --filter "Category!=Integration"
cd web && pnpm install && pnpm build

集成测试会通过 Testcontainers 启动真实的数据存储，并绑定与 Compose 堆栈相同的端口，因此运行测试时请先停止该堆栈。

部署

deploy/docker-compose.yml 可在单台主机上运行整个平台。deploy/charts/condux 是一个 Helm 图表，可将服务部署到使用外部托管的 PostgreSQL、ClickHouse 和 Kafka-API 代理的环境中，而不是在集群内运行数据存储。该图表的 README.md 介绍了各项配置值，包括 config.ingestHost。此项为必填项，因为控制平面生成的每个 DSN 都会指向该地址。你需要自行构建并推送服务镜像；该图表不包含任何镜像。

安全

如需报告疑似漏洞，请按照 SECURITY.md 中的说明通过电子邮件私下报告，而不要通过公开议题或拉取请求报告。

许可证

Condux 采用功能源代码许可证（FSL-1.1-ALv2），源码可用。除提供有竞争关系的商业服务外，你可以出于任何目的阅读、可自托管和修改源码；每个版本发布两年后将转换为 Apache-2.0 许可证。

请参阅 LICENSE 了解许可条款，并参阅 LICENSING.md 查看通俗易懂的摘要。sdks/ 下的 SDK 采用 Apache-2.0 许可证。