rustrak

自託管、開源的 Rust 版 Sentry 替代方案。在一個小型容器中整合錯誤追蹤、效能監控、日誌與 AI 代理追蹤,並可與 Sentry SDK 搭配使用

rustrak 是什麼?

自託管、開源的 Rust 版 Sentry 替代方案。在一個小型容器中整合錯誤追蹤、效能監控、日誌與 AI 代理追蹤,並可與 Sentry SDK 搭配使用。支援 SQLite 或 PostgreSQL。

rustrak 概覽

這是什麼

Rustrak 是一個用 Rust 撰寫、可自架(self-hosted)的開源錯誤追蹤器。它接受標準的 Sentry 協定,因此現有的 Sentry SDK 只需更改一行設定字串即可指向 Rustrak。預設以單一程序搭配 SQLite 執行,不需要獨立的資料庫或訊息佇列。它也處理日誌、交易(transactions)、發佈健康度(release health)以及 AI 代理程式軌跡(traces)。

主要功能

  • 接受標準 Sentry envelope 協定;任何 Sentry SDK 無需修改程式碼即可使用。
  • 接收採用兩階段處理:端點解析 envelope、寫入磁碟後立即回傳 200,再由衍生任務執行資料庫工作。
  • 儀表板是靜態檔案,由同一個程序提供;UI 與 API 運行在同一個容器中。
  • 錯誤透過確定性指紋(SDK 指紋,或例外類型 + 訊息第一行 + 交易名稱)分組為議題。
  • AI 代理程式軌跡有獨立頁面,顯示每個軌跡的瀑布圖、持續時間百分位、依呼叫數與 token 數排名的最佳模型,以及最佳工具。
  • 日誌作為第一級事件類型儲存,支援六種嚴重等級、每列保留型別的屬性,以及連結到來源 span 的 trace_id。
  • 警示規則可針對 new_issue、regression 或 unmute 事件觸發,目的地包括 Slack、SMTP 電子郵件或純 JSON webhook。
  • 專案支援三種角色(管理員、成員、檢視者)並可發送邀請。
  • 伺服器會回報儲存空間使用量,並強制執行可設定的保留期限,支援手動清理與 source map 垃圾回收。
  • 提供 REST API 型別客戶端與內建 MCP 端點,讓助理可直接對實例進行分類處理。

使用情境

  • 在現有硬體上自架錯誤追蹤,無需按事件計費或取樣。
  • 從 Sentry SaaS 遷移至自架實例,只需更改 DSN 字串。
  • 監控 AI 代理程式執行,包含 LLM 呼叫軌跡、token 計數與工具使用情況。
  • 在單一系統中同時收集結構化日誌、錯誤與效能 span。
  • 追蹤發佈健康度,檢視每個版本的無當機工作階段與使用者百分比。
  • 針對新議題、回歸或解除靜音的議題設定警示,並傳送至 Slack、電子郵件或 webhook。

快速開始

- SESSION_SECRET_KEY=${SESSION_SECRET_KEY}      - CREATE_SUPERUSER=${CREATE_SUPERUSER}    restart: unless-stoppedvolumes:  rustrak_data:``````bashexport SESSION_SECRET_KEY=$(openssl rand -hex 32)export [email protected]:changeme123docker compose up -d```開啟 http://localhost:8080 並使用上述憑證登入。若需使用 PostgreSQL,請使用 `docker-compose.postgres.yml` 搭配 `:postgres` 映像檔。

### 授權與價格

授權:AGPL-3.0。價格:開源(無按事件計費、無取樣、無座位費用)。

內容整理自該專案公開的 README 與儲存庫資訊。

將此徽章加入你的 README

Featured on YunoDB 徽章樣式與說明

你是這個專案的維護者嗎?展示它已收錄於 YunoDB。

Markdown[![Featured on YunoDB](https://yunodb.com/badge/rustrakrustrak.svg)](https://yunodb.com/tools/rustrakrustrak?utm_source=github&utm_medium=badge)
HTML<a href="https://yunodb.com/tools/rustrakrustrak?utm_source=github&utm_medium=badge"><img src="https://yunodb.com/badge/rustrakrustrak.svg" alt="Featured on YunoDB" height="20"></a>