Belvador là gì

Belvador bắt các lỗi ứng dụng của bạn gặp phải — ứng dụng hỏng trên trình duyệt, request máy chủ thất bại, lỗi bạn tự báo — gom chúng thành issue và báo cho đội của bạn. Ngoài lỗi, Belvador còn giữ traces và log OpenTelemetry, theo dõi cron job, kiểm tra URL và theo dõi SLO. Điểm khác với các công cụ theo dõi lỗi khác: các dữ liệu này nằm trên một máy chủ trong chính tài khoản Hetzner Cloud của bạn, và Belvador tự dựng, tự bảo trì máy chủ đó giúp bạn.

Các phần kết nối với nhau thế nào#

ứng dụng ──(SDK + DSN)──▶ ingest.belvador.dev ──▶ node của bạn, trong project Hetzner của bạn                                                        ▲trình duyệt ──▶ ứng dụng Belvador ──▶ edge.belvador.dev ┘  vé đọc có chữ ký

1. Ứng dụng của bạn gửi lỗi bằng SDK Belvador. DSN của project cho SDK biết gửi về đâu.

2. Edge nhận lỗi tại https://ingest.belvador.dev kiểm khoá DSN và giới hạn của bạn, rồi chuyển từng lỗi tới node. Nếu node tạm mất kết nối, edge giữ dữ liệu đã mã hoá bằng khoá riêng của node — Belvador không đọc được — và chuyển khi node kết nối lại.

3. Node của bạn là một máy chủ nhỏ trong project Hetzner của bạn. Node lọc dữ liệu nhạy cảm thêm một lần, gom lỗi thành issue và lưu lại.

4. Ứng dụng Belvador hiển thị issue, trang Fleet và sức khoẻ node. Trình duyệt đọc dữ liệu lỗi thẳng từ node qua edge.belvador.dev bằng vé có chữ ký, hết hạn sau vài phút. Cơ sở dữ liệu của Belvador chỉ giữ thông tin tài khoản, project và cấu hình.

Bạn làm gì, Belvador làm gì#

Bạn không cần SSH, Docker hay đăng nhập máy chủ để bắt đầu. Việc dựng và bảo trì đều làm từ ứng dụng Belvador.

Belvador bắt gì — và không bắt gì#

• Lỗi từ SDK Belvador, traces và log từ OpenTelemetry. SDK 0.x gửi event lỗi và check-in của cron; tracing, session replay, log và profiling riêng của SDK bị bỏ ngay trong ứng dụng, trước khi bất cứ thứ gì rời khỏi đó. Traces và log đến từ SDK OpenTelemetry chuẩn với khoá ingest của project và cũng được lưu trên node của bạn. Xem Traces và log.

• Tự động bắt là những phần bạn đã nối. Trên trình duyệt, lỗi chưa bắt và promise bị từ chối không xử lý được bắt ngay khi SDK khởi động. Error boundary và root hook của React, router và middleware của TanStack Start, wrapper của Cloudflare Workers mỗi thứ bắt phần của nó khi bạn thêm vào. Xem Chọn SDK phù hợp.

• Lỗi đã xử lý thì vẫn là đã xử lý. Lỗi mà code của bạn bắt và tự xử lý sẽ không được gửi, trừ khi bạn tự gọi captureException.

• Dữ liệu nhạy cảm được lọc hai lần — ở SDK và một lần nữa trên node. Bộ lọc dựa vào tên trường và mẫu ký tự, nên giảm rủi ro nhưng không thể nhận ra mọi bí mật. Xem Bảo vệ dữ liệu.

Hiện có những gì#

Belvador đang ở giai đoạn beta và miễn phí trong beta; bạn trả tiền máy chủ cho Hetzner. Belvador không tính tiền theo số event.

Đọc tiếp#

• Mới bắt đầu? Làm theo Bắt đầu nhanh — từ đăng ký tới issue đầu tiên.

• Cài vào ứng dụng? Bắt đầu với Chọn SDK phù hợp.

• Dựng máy chủ? Đọc Kết nối Hetzner và dựng node.

• Dùng AI agent lập trình? Đưa cho agent Hướng dẫn cho AI agent.

• Chưa thấy lỗi về? Xem Khắc phục sự cố.