Skip to main content
LogBrew dùng một thuật ngữ cho mỗi khái niệm sản phẩm. Trường API, flag CLI, giá trị enum, tên sự kiện và khóa thuộc tính giữ nguyên trong mọi ngôn ngữ.

​
Observability và giám sát

Để chọn tín hiệu và xem ví dụ cụ thể, đọc Telemetry.

​
Agent AI

Để kết nối một client, đọc Kết nối agent AI qua MCP.

​
Tín hiệu observability

Một lỗi đã gộp nhóm, có thể chứa nhiều lần xảy ra. Một lần xảy ra là một trường hợp đã ghi nhận của vấn đề đó. first_seen_at là thời điểm của lần xảy ra đầu tiên. last_seen_at là thời điểm của lần xảy ra gần nhất.
Một bản ghi sự kiện có dấu thời gian. Log có thể mang mức độ nghiêm trọng, dịch vụ, bản phát hành, môi trường, ngữ cảnh trace và các thuộc tính trong giới hạn quyền riêng tư.
Trace theo dấu công việc xuyên suốt một yêu cầu hoặc thao tác. Span là một thao tác có đo thời gian bên trong trace đó. Tương quan với một trace là bằng chứng về ngữ cảnh chung, không phải bằng chứng về nguyên nhân.
Một phép đo lúc ứng dụng chạy, có đơn vị, loại, phép tổng hợp và khoảng thời gian xác định. Điểm chỉ số không thể dùng thay cho số đếm log, trace hay vấn đề.
Phiên bản ứng dụng hoặc dịch vụ đã triển khai, được báo cáo kèm telemetry. Bản phát hành không phải cùng một đối tượng với dự án hay repository.
Một sự kiện sản phẩm đã được phân loại, chẳng hạn đăng ký, thanh toán, nhập dữ liệu hoặc tác vụ thất bại. Tính năng Phân tích phân loại hành động thành lượt xem trang, lượt xem màn hình hoặc tương tác. Hành động không phải lệnh tự động mà LogBrew chạy.

​
Điều tra vấn đề

Không phải lần xảy ra nào cũng chứa mọi trường. Dùng hướng dẫn Điều tra một vấn đề để biết thứ tự đọc và các trường trong phản hồi.

​
Định danh và tương quan

Giá trị bị thiếu không chứng minh hoạt động liên quan đã không xảy ra. Loại định danh cho biết ứng dụng đã phân loại chủ thể như thế nào. Nó không chứng minh dữ liệu là ẩn danh. ID ổn định vẫn có thể liên kết các hoạt động.

​
Phạm vi và chất lượng dữ liệu

​
Phép đo và thời gian

Không cộng thời lượng của các span con chồng lên nhau để tính tổng thời gian của yêu cầu. Không so sánh số sự kiện với số người dùng đã định danh.

​
Trạng thái bằng chứng

Các trạng thái này không thể thay thế cho nhau:
  • Đã ghi nhận: bằng chứng có mặt.
  • Chưa ghi nhận: bằng chứng chưa được ghi nhận.
  • Đã che: bằng chứng đã được cố ý che đi.
  • Bị cắt bớt: bằng chứng vượt quá giới hạn của phản hồi hoặc của việc ghi nhận.
  • Không khả dụng: thao tác đọc không thể cung cấp bằng chứng.
Likely cause (Nguyên nhân có thể) và likely fix area (Vùng mã có thể sửa) mô tả bằng chứng chẩn đoán có giới hạn, không phải nguyên nhân gốc đã được chứng minh. Reported impact (Tác động được báo cáo) do ứng dụng gửi báo cáo cung cấp, trừ khi đặc tả nêu rõ đó là phép đo của LogBrew.

​
Phân tích sản phẩm

Kỳ chưa kết thúc, thiếu định danh, ghi nhận thuộc tính chưa đầy đủ, lấy mẫu và cắt bớt đều giới hạn mức chắc chắn của kết quả. LogBrew hiển thị các giới hạn đó thay vì biến chúng thành số 0 hay sự chắc chắn. Đọc Phân tích sản phẩm để biết quy tắc đếm. Dùng Ghi nhận sự kiện sản phẩm để gửi hoạt động đã phân loại và định danh có kiểu.