> ## Documentation Index > Fetch the complete documentation index at: https://docs.logbrew.co/llms.txt > Use this file to discover all available pages before exploring further. # Thuật ngữ observability và LogBrew > Tra cứu các loại tín hiệu, phạm vi dự án, định danh, trạng thái bằng chứng và thuật ngữ phân tích sản phẩm của LogBrew. 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 | Thuật ngữ | Ý nghĩa | | - | - | | Observability (khả năng quan sát) | Hiểu hành vi của ứng dụng từ bằng chứng mà ứng dụng tạo ra. | | Telemetry | Các tín hiệu mà ứng dụng báo cáo, chẳng hạn log, trace và chỉ số. | | Giám sát | Kiểm tra các điều kiện đã biết, chẳng hạn so một giá trị đo được với một ngưỡng. | | `o11y` | Dạng viết tắt của observability. Con số đếm 11 chữ cái nằm giữa `o` và `y`. | Để chọn tín hiệu và xem ví dụ cụ thể, đọc [Telemetry](/vi/concepts/telemetry). ## Agent AI | Thuật ngữ | Ý nghĩa | | - | - | | Máy chủ MCP | Máy chủ Model Context Protocol do LogBrew vận hành. Agent AI dùng máy chủ này để đọc các dự án đã duyệt. | | MCP client | Ứng dụng kết nối agent AI với máy chủ MCP, chẳng hạn Claude Code. | | Dự án đã duyệt | Dự án bạn đã chọn khi cấp quyền truy cập cho một MCP client. Client chỉ đọc được các dự án đã duyệt. | | Kết nối | Quyền truy cập bạn cấp cho 1 MCP client khi duyệt client đó. Kết nối kết thúc sau 30 ngày không dùng, sau 90 ngày, hoặc khi bạn thu hồi. CLI gọi đây là grant. | Để kết nối một client, đọc [Kết nối agent AI qua MCP](/vi/guides/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. | Thuật ngữ | Ý nghĩa | | - | - | | Mức độ nghiêm trọng | Mức khẩn cấp của một tín hiệu: `info`, `warning`, `error` hoặc `critical`. Khác với trạng thái vấn đề. | | Trạng thái vấn đề | Trạng thái trong quy trình xử lý của một vấn đề đã gộp nhóm: `unresolved`, `resolved` hoặc `archived`. Không phải kết quả của một yêu cầu. | | Vấn đề đã lưu trữ | Vấn đề mà nhóm đã đưa ra khỏi danh sách triage (xem xét và xếp thứ tự xử lý) đang hoạt động. Các phản hồi cũ gọi trạng thái này là `ignored`. | | Mức ưu tiên của vấn đề | Thứ tự triage của một vấn đề đã gộp nhóm: `high`, `medium` hoặc `low`. Mức này đi theo mức độ nghiêm trọng cho đến khi có người tự đặt. | | Nguồn mức ưu tiên | Nơi mức ưu tiên được lấy ra. `derived` đi theo mức độ nghiêm trọng: `error` và `critical` là `high`, `warning` là `medium`, và `info` là `low`. `manual` là mức ưu tiên do một người đặt. | | Người phụ trách vấn đề | 1 tài khoản hoặc 1 nhóm phụ trách bước tiếp theo của một vấn đề đã gộp nhóm. Tài khoản phải đọc được dự án. Nhóm phải thuộc tổ chức của dự án. | | Nhóm | Một nhóm thành viên có tên trong một tổ chức. Có thể giao vấn đề cho một nhóm, và quy tắc sở hữu có thể nêu tên nhóm đó. Tham gia một nhóm không cấp quyền truy cập dự án nào. | | Quy tắc sở hữu | Quy tắc của dự án, nối đường dẫn khung ngăn xếp, module, route, dịch vụ hoặc tag với các tài khoản hoặc nhóm sở hữu những vấn đề khớp với quy tắc. | | Chủ sở hữu được đề xuất | Tài khoản hoặc nhóm mà LogBrew đề xuất cho một vấn đề, dựa trên quy tắc sở hữu, một dòng trong CODEOWNERS hoặc hoạt động gần đây. Đây chỉ là đề xuất, không phải lượt giao. | | Hộp thư đến | Danh sách các vấn đề mà người khác đã giao cho bạn hoặc nhóm của bạn. LogBrew không gửi email cho danh sách này. | | Dấu vết ngăn xếp (stack trace) | Bằng chứng đã ghi nhận về các lời gọi hàm dẫn đến một lỗi. Khác với distributed trace. | | Khung ngăn xếp (stack frame) | Một mục trong dấu vết ngăn xếp. Có thể xác định hàm, module, tệp, dòng hoặc cột. | | Chuỗi ngoại lệ | Các ngoại lệ liên kết được báo cáo cùng nhau, chẳng hạn một lỗi và nguyên nhân của lỗi đó. Các mục chưa ghi nhận, đã che hoặc bị cắt bớt làm bằng chứng bị hạn chế. | | Khung mã ứng dụng | Khung ngăn xếp được đánh dấu là mã của ứng dụng. Khung này cho thấy chỗ mã cần xem xét. Nó không chứng minh lỗi nằm ở đó. | | Breadcrumb | Một sự kiện ngắn được ghi lại trước một lần xảy ra của vấn đề. Breadcrumb không phải bản ghi đầy đủ của một phiên. | | Ngoại lệ đã xử lý | Ngoại lệ mà ứng dụng báo cáo là đã xử lý. Không chứng minh thao tác đã thành công. | | Source map | Một artifact (tệp bản dựng) ánh xạ vị trí trong JavaScript được sinh ra về vị trí trong mã nguồn gốc. | | Khung đã symbolicate | Khung có vị trí được sinh ra đã được chuyển về thông tin mã nguồn gốc. | | Lần xảy ra mốc | Lần xảy ra đã ghi nhận được dùng làm mốc tham chiếu để tái hiện. | | Nguồn gốc | Nơi một đánh giá được đưa ra. `backend_observed` nghĩa là LogBrew đã quan sát. `application_reported` nghĩa là ứng dụng đã báo cáo và LogBrew chưa xác minh. | | Mức sẵn sàng tái hiện | Lần xảy ra mốc có đủ bằng chứng cần thiết để thử tái hiện hay không. Không phải một bài kiểm tra tái hiện đã đạt. | Dùng hướng dẫn [Điều tra một vấn đề](/vi/guides/investigate-an-issue) để 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. | Thuật ngữ | Ý nghĩa | | - | - | | Ngữ cảnh trace | Các định danh trace và span kết nối công việc giữa các tín hiệu. | | Span gốc | Span bắt đầu một trace và không có span cha. Span sớm nhất được trả về không nhất thiết là span gốc. | | Span con | Span có span cha trong cùng trace. | | Tương quan | Một mối quan hệ chính xác mà LogBrew trả về, chẳng hạn cùng trace ID. Không chứng minh nguyên nhân. | | Người dùng đã định danh | Chủ thể do ứng dụng cung cấp, có ID ổn định và loại `user`. | | Chủ thể ẩn danh | Chủ thể do ứng dụng cung cấp, có loại `anonymous`. Số đếm tách chủ thể này khỏi người dùng đã định danh. | | Loại định danh không xác định | Chủ thể không có loại đã biết. Không được tính là người dùng đã định danh. | | Thiếu chủ thể | Sự kiện không có chủ thể. Khác với chủ thể có loại không xác định. | 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 | Thuật ngữ | Ý nghĩa | | - | - | | Dự án | Ranh giới sản phẩm chính mà bạn sở hữu. Một dự án có thể chứa nhiều dịch vụ hoặc thành phần repository. | | Dịch vụ | Một runtime hoặc thành phần gửi báo cáo bên trong dự án. | | Môi trường | Một ngữ cảnh báo cáo chính xác, chẳng hạn production hoặc staging. | | Đã tiếp nhận | Đã được chấp nhận theo quy tắc tiếp nhận dữ liệu. Không hứa hẹn giữ lại dữ liệu vô thời hạn. | | Đã lập chỉ mục | Có sẵn cho chỉ mục hoặc truy vấn được chỉ định. Không đồng nghĩa với đã tiếp nhận. | | Được giữ lại | Có mặt trong khoảng dữ liệu được đánh giá. | | Đã lấy mẫu | Một phần telemetry đã được chọn trước hoặc trong khi thu thập. | | Độ bao phủ | Một tỷ lệ đo được, có tử số và mẫu số rõ ràng. | | Bị cắt bớt | Phản hồi đã chạm một giới hạn. Dữ liệu bị lược bỏ không nhất thiết là không tồn tại. | | Ước tính | Được tính theo phương pháp đã mô tả thay vì đếm chính xác. | | Khoảng thời gian | Khoảng thời gian chính xác mà một truy vấn đánh giá. | ## Phép đo và thời gian | Thuật ngữ | Ý nghĩa | | - | - | | Điểm dữ liệu | Một giá trị tại một thời điểm được báo cáo. Đọc tên và đơn vị của chỉ số trước khi so sánh các điểm dữ liệu. | | Chuỗi thời gian | Các giá trị của cùng một phép đo, sắp xếp theo thời gian. Khoảng trống không có nghĩa là giá trị bằng 0. | | Thời lượng | Thời gian trôi qua của một thao tác. Khác với thời điểm thao tác xảy ra. | | Phép tổng hợp | Một phép tính xác định trên nhiều phép đo, chẳng hạn tổng hoặc trung bình. | | Khoảng gộp | Một khoảng trong biểu đồ hoặc kết quả đã gộp nhóm. Điểm bắt đầu và kết thúc của nó xác định phạm vi. | | Kỳ chưa kết thúc | Một kỳ chưa hoàn tất. Không phải một kỳ đã hoàn tất với 0 hoạt động. | 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 | Thuật ngữ | Ý nghĩa | | - | - | | Sự kiện | Hoạt động sản phẩm đã được phân loại, có tên ổn định và chính xác. | | Thuộc tính | Khóa ngữ cảnh dùng để mô tả hoặc lọc một sự kiện. | | Phiên | Một lượt truy cập hoặc phiên ứng dụng, không phải một người. | | Nhóm người dùng (cohort) | Một nhóm có giới hạn, được xác định bằng tiêu chí chính xác. | | Phễu | Các bước có thứ tự dùng để đo tiến trình hoặc tỷ lệ chuyển đổi. | | Tỷ lệ quay lại | Hành vi quay lại, được đo với kỳ và mẫu số rõ ràng. | | Đường dẫn | Hành trình trong phiên trước hoặc sau một sự kiện được chọn. | | Vòng đời | Chia các chủ thể đã định danh trong mỗi kỳ thành Mới trong lịch sử quan sát, Quay lại, Hoạt động trở lại hoặc Không hoạt động. | | Mới trong lịch sử quan sát | Đang hoạt động và không có sự kiện được chọn nào trước đó trong khoảng lịch sử có giới hạn. Không có nghĩa là khách hàng lần đầu. | 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](/vi/concepts/product-analytics) để biết quy tắc đếm. Dùng [Ghi nhận sự kiện sản phẩm](/vi/guides/product-events) để gửi hoạt động đã phân loại và định danh có kiểu. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.