Condux error monitoring

Condux

Condux は、AI 修正エンジンを内蔵したソースコードを公開しているエラー監視プラットフォームです。

SDK はエラーをステートレスな取り込みリレーに報告します。リレーは DSN を認証し、プランごとのレート制限とクォータを適用してから、Redpanda を介してバッファリングする前に PII を除去します。コンシューマーはイベントのフィンガープリントを作成して問題ごとにグループ化し、時系列データを ClickHouse に、問題の状態を PostgreSQL に書き込みます。Next.js ダッシュボードは、スタックトレース、パンくずリスト、タグのファセット、時間ごとのグラフとともにグループ化された問題を表示します。新規および再発した問題は、メール、Slack、Discord、Webhook に通知されます。

Conductor

修正エンジンは、問題からプルリクエストのドラフトを作成します。スタックトレースとプロジェクトのコードマッピングから対象を絞り、機密情報を除去したコンテキストを組み立て、Claude または組織が指定したモデルに送信します。返された変更は新しいブランチに適用され、プルリクエストのドラフトとして作成されます。修正が自動的にマージされることはありません。

リポジトリへのアクセスには、短期間有効なインストールトークンを使う GitHub App を使用します。モデルにトークンが渡されることはありません。修正プルリクエストがマージされた後、検証ループはその後のイベント件数に基づいて問題の状態を比較し、設定された期間にわたってイベントが発生しなければ問題を解決済みにします。

接続済みリポジトリで未解決の Dependabot の検出結果は、同じエンジンを通じて依存関係更新のプルリクエストのドラフトに変換できます。

各実行は、組織の月間利用枠と支出上限に対して計上されます。実行ごとのコストは、記録されたモデルのトークン使用量から算出されます。

互換性

取り込みでは、Sentry のエンベロープ形式とストア形式を受け付けるため、既存の Sentry SDK は DSN を変更するだけで Condux に報告できます。OTLP/HTTP ログも受け付けるため、OpenTelemetry で計装されたアプリケーションは SDK なしで報告できます。

JavaScript/Node、ブラウザー、エッジ、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 エージェントが実際の本番エラーを調査できます。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 チャート
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 は、データストアをクラスター内で実行するのではなく、外部で管理される PostgreSQL、ClickHouse、Kafka-API ブローカーに対してサービスをデプロイする Helm チャートです。チャートの README.md では、config.ingestHost を含む値について説明しています。この値が必要なのは、コントロールプレーンが生成するすべての DSN がその値を参照するためです。サービスイメージは自分でビルドしてプッシュする必要があります。チャートにはイメージは含まれていません。

セキュリティ

脆弱性が疑われる場合は、公開のイシューやプルリクエストではなく、SECURITY.md の説明に従ってメールで非公開に報告してください。

ライセンス

Condux は Functional Source License (FSL-1.1-ALv2) の下でソースを公開しています。競合する商用サービスを提供する場合を除き、あらゆる目的で閲覧、セルフホスト、変更できます。また、各リリースは公開から 2 年後に Apache-2.0 に切り替わります。

ライセンス条項については LICENSE を、平易な言葉での概要については LICENSING.md をご覧ください。sdks/ 内の SDK は Apache-2.0 です。