Mọi tín hiệu. Một câu chuyện rõ ràng.
LogBrew liên kết log, trace, vấn đề và bản phát hành để mọi lỗi đều có lời giải thích.
Log
Tìm theo nội dung log, rồi mở trace khi một log giải thích được lỗi.
POST /webhooks/payments
{ "title": "POST /webhooks/payments", "project": "Checkout API", "duration": "12 ms", "spans": 3, "trace_id": "webhook-8e91", "issue_id": "PAY-1043", "request_id": "req-webhook-8e91", "release": "checkout-api@1.24.0", "environment": "production", "http": { "method": "POST", "route": "/webhooks/payments", "status_code": 400 }, "operations": [ { "span_id": "webhook", "parent_span_id": null, "name": "POST /webhooks/payments", "start_offset_ms": 0, "duration_ms": 12, "status": "error" }, { "span_id": "secret", "parent_span_id": "webhook", "name": "signing_key.load", "start_offset_ms": 0, "duration_ms": 3, "status": "ok" }, { "span_id": "verify", "parent_span_id": "webhook", "name": "signature.verify", "start_offset_ms": 3, "duration_ms": 9, "status": "error", "attributes": { "key_version": "v7", "signature_match": false, "payload_logged": false } } ], "logs": [ { "offset_ms": 0, "severity": "info", "message": "Payment webhook received; provider event evt-9032" }, { "offset_ms": 3, "severity": "info", "message": "Loaded signing key version v7 from runtime configuration" }, { "offset_ms": 12, "severity": "error", "message": "Signature verification failed; returned 400 without updating order state" } ] }
Đưa bằng chứng vào việc xử lý.
Tìm vấn đề lặp lại
Xem các vấn đề đã được gom lại và lần xảy ra gần nhất trước khi chọn điều cần điều tra.
Đọc hướng dẫn về vấn đềVấn đề
Tìm lỗi và mở ngữ cảnh trace.
| Lỗi | Checkout API | 3 | ||
| Nghiêm trọng | Checkout API | 18 | ||
| Cảnh báo | Checkout API | 6 | ||
| Thông tin | Checkout API | 12 |
Xem điều gì đã xảy ra trước đó
Lần theo log và breadcrumb đã ghi nhận quanh một lỗi. Luôn giữ ngữ cảnh request trong tầm mắt.
Đọc hướng dẫn điều traTrace
Mở một request để xem đường đi và các tín hiệu liên quan.
| Checkout API | Lỗi | 12 ms | 3 | |
| Checkout API | Ổn định | 46 ms | 3 | |
| Checkout API | Ổn định | 8 ms | 2 | |
| Checkout API | Lỗi | 2,548 ms | 4 |
Điều tra cùng agent
Đưa ngữ cảnh đã ghi nhận vào quy trình viết code của bạn. Xem lại bằng chứng trước khi quyết định thay đổi.
Đọc hướng dẫn cho agentPOST /webhooks/payments
{ "title": "POST /webhooks/payments", "project": "Checkout API", "duration": "12 ms", "spans": 3, "trace_id": "webhook-8e91", "issue_id": "PAY-1043", "request_id": "req-webhook-8e91", "release": "checkout-api@1.24.0", "environment": "production", "http": { "method": "POST", "route": "/webhooks/payments", "status_code": 400 }, "operations": [ { "span_id": "webhook", "parent_span_id": null, "name": "POST /webhooks/payments", "start_offset_ms": 0, "duration_ms": 12, "status": "error" }, { "span_id": "secret", "parent_span_id": "webhook", "name": "signing_key.load", "start_offset_ms": 0, "duration_ms": 3, "status": "ok" }, { "span_id": "verify", "parent_span_id": "webhook", "name": "signature.verify", "start_offset_ms": 3, "duration_ms": 9, "status": "error", "attributes": { "key_version": "v7", "signature_match": false, "payload_logged": false } } ], "logs": [ { "offset_ms": 0, "severity": "info", "message": "Payment webhook received; provider event evt-9032" }, { "offset_ms": 3, "severity": "info", "message": "Loaded signing key version v7 from runtime configuration" }, { "offset_ms": 12, "severity": "error", "message": "Signature verification failed; returned 400 without updating order state" } ] }
Kết nối ứng dụng
Chọn tích hợp cho ứng dụng của bạn và làm theo hướng dẫn thiết lập để gửi tín hiệu đầu tiên.
Đọc hướng dẫn thiết lập
Cho mọi tín hiệu một lối dẫn đến câu trả lời.
Mở LogBrew và biến câu hỏi tiếp theo về production thành một cuộc điều tra tập trung.
Câu hỏi thường gặp về LogBrew
Tìm hiểu cách kết nối ứng dụng, điều tra lỗi và làm việc cùng coding agent của bạn.
LogBrew giúp bạn điều tra lỗi ứng dụng bằng vấn đề được gom lại, log và trace. Mở một vấn đề để xem ngữ cảnh đã ghi nhận, hoặc tìm trong log một sự kiện cụ thể. Thông tin chi tiết có được hay không phụ thuộc vào tích hợp của bạn và dữ liệu ứng dụng gửi lên.
Log ghi lại từng sự kiện riêng lẻ, kể cả hoạt động bình thường. Theo dõi lỗi gom các lỗi liên quan thành vấn đề, để bạn xem các lần xảy ra lặp lại và lần gần nhất chúng xảy ra. Dùng vấn đề để chọn lỗi cần xử lý, rồi xem log liên quan để có thêm ngữ cảnh.
Bắt đầu từ một lần xảy ra đã ghi nhận và kiểm tra môi trường, bản phát hành, thông điệp và stack trace của nó. Xem log và bằng chứng trace liên quan nếu có. Các bản ghi này có thể thu hẹp phạm vi điều tra ngay cả khi bạn không tái hiện được lỗi ở máy local, nhưng chúng không bảo đảm tìm ra nguyên nhân gốc.
Khi tích hợp của bạn ghi nhận breadcrumb hoặc log liên quan, phần chi tiết vấn đề có thể hiển thị các sự kiện xung quanh lỗi. Một trace được liên kết có thể bổ sung thời gian của từng thao tác. LogBrew không thể dựng lại hoạt động mà ứng dụng của bạn không ghi nhận.
Log ghi lại một sự kiện. Stack trace cho thấy các lệnh gọi hàm gắn với một lỗi. Distributed trace theo dõi các thao tác liên quan trong một request hoặc tác vụ, có thể đi qua nhiều dịch vụ. Mỗi loại trả lời một câu hỏi khác nhau khi debug.
Dùng trang Vấn đề để xem các lỗi đã được gom lại, số lần xảy ra và lần xảy ra gần nhất. Thu hẹp kết quả theo dự án và khoảng thời gian, rồi kiểm tra từng lần xảy ra. Sự lặp lại giúp bạn nhận ra quy luật; tự nó không đo được tác động đến người dùng.
Các sự kiện liên quan có thể được liên kết khi các tích hợp của bạn ghi nhận và truyền đi ngữ cảnh trace khớp nhau. Trùng thời điểm hoặc thông điệp giống nhau chưa đủ để chứng minh hai sự kiện thuộc cùng một request. Làm theo hướng dẫn tracing của từng tích hợp.
Một lỗi có thể được ghi nhận khi không có ngữ cảnh trace đang hoạt động. Trace cũng có thể không khả dụng vào lúc bạn kiểm tra. Xem trạng thái bằng chứng trong chi tiết vấn đề và cấu hình tracing của tích hợp. SDK mới hơn không bổ sung ngữ cảnh trace cho các lần xảy ra cũ.
Có. Dùng ngữ cảnh điều tra sẵn có, CLI hoặc công cụ MCP để cung cấp cho agent bằng chứng trong phạm vi cần thiết. Hướng dẫn cho agent giải thích quy trình này. Kiểm tra dữ liệu bạn chia sẻ, không đưa thông tin xác thực vào prompt và xem lại thay đổi được đề xuất trước khi áp dụng.
Bạn có thể điều tra trực tiếp trên bảng điều khiển. Công cụ cho agent là tùy chọn. Cả hai cách đều nên dựa trên bằng chứng đã ghi nhận và luôn cho thấy ngữ cảnh còn thiếu hoặc bị giới hạn. LogBrew không bảo đảm sửa lỗi tự động.
Tạo dự án, chọn tích hợp cho ngôn ngữ hoặc framework của bạn, rồi làm theo hướng dẫn thiết lập. Gửi một sự kiện thử an toàn và xác nhận nó xuất hiện đúng dự án. Tín hiệu được hỗ trợ và cách cấu hình khác nhau giữa các tích hợp.
Trước tiên, kiểm tra dự án đã chọn, khoảng ngày và các bộ lọc khác. Sau đó kiểm tra cấu hình dự án và tín hiệu mà tích hợp của bạn gửi. Log, vấn đề và trace là các luồng riêng, nên trang Log trống không có nghĩa là chưa nhận được vấn đề nào.
Bạn có thể sắp xếp telemetry thành các dự án và dùng các chế độ xem được hỗ trợ để chọn một, nhiều hoặc tất cả dự án bạn có quyền truy cập. Dịch vụ xác định thành phần gửi dữ liệu trong một dự án. Phân biệt rõ các phạm vi này khi so sánh hoạt động của frontend, backend và worker.
Việc thu thập và gửi telemetry có dùng tài nguyên. Mức ảnh hưởng phụ thuộc vào SDK, cấu hình và lưu lượng sự kiện. Kiểm thử tích hợp với tải đại diện và dùng các tùy chọn kiểm soát được mô tả trong tài liệu của SDK đó. Đừng mặc định là không tốn chi phí.
Không đưa bí mật hoặc dữ liệu cá nhân không cần thiết vào thông điệp, thuộc tính hay ngữ cảnh lỗi. Xem các tùy chọn ghi nhận và che dữ liệu của SDK, rồi kiểm tra một sự kiện thử an toàn trước khi bật tích hợp trên production. Đừng mặc định mọi trường đều được tự động loại bỏ.
Xem trang Bảng giá để biết các gói hiện tại và hạn mức đi kèm. Sau khi đăng nhập, kiểm tra trang tài khoản và mức sử dụng để xem thông tin dành cho tài khoản của bạn. Hãy kiểm tra thông tin gói hiện tại thay vì mặc định là thu thập không giới hạn.