# LogBrew: Vietnamese > Agent-first observability for developers. Investigate issues and logs, follow exact trace evidence, and use product analytics from the website, CLI, or API. ## Vietnamese ### Hướng dẫn #### Bắt đầu - [Observability để điều tra ứng dụng với LogBrew](https://docs.logbrew.co/vi/introduction.md): So sánh observability với giám sát. Dùng log, trace, chỉ số và ngữ cảnh để xem xét hành vi của ứng dụng. - [Observability với LogBrew: bắt đầu nhanh với log Node.js](https://docs.logbrew.co/vi/quickstart.md): Tạo dự án, thiết lập ghi log Node.js, gửi một sự kiện SDK an toàn và đọc log đã lưu mà không làm lộ thông tin xác thực. #### Khái niệm - [Telemetry ứng dụng: log, trace và chỉ số](https://docs.logbrew.co/vi/concepts/telemetry.md): So sánh log, trace, chỉ số, vấn đề và hành động sản phẩm. Chọn tín hiệu LogBrew phù hợp cho việc điều tra. - [Structured logging, định dạng log và best practice](https://docs.logbrew.co/vi/concepts/structured-logging.md): Tìm hiểu structured logging (log có cấu trúc), chọn định dạng log JSON với các trường chuẩn, và áp dụng best practice để log dễ tìm kiếm. - [Distributed tracing: trace, span và ngữ cảnh](https://docs.logbrew.co/vi/concepts/distributed-tracing.md): Tìm hiểu cách trace và span liên kết yêu cầu, log, vấn đề, hành động và chỉ số trong LogBrew. - [Phân tích sản phẩm là gì? Chỉ số và người dùng quay lại](https://docs.logbrew.co/vi/concepts/product-analytics.md): Chọn dự án và khoảng ngày. Xem hoạt động, phễu, tỷ lệ quay lại và vòng đời. Kiểm tra độ bao phủ dữ liệu trước khi dựa vào kết quả. - [Theo dõi bản phát hành và giám sát triển khai phần mềm](https://docs.logbrew.co/vi/concepts/releases.md): Theo dõi bản phát hành trong LogBrew để tìm vấn đề, log, trace, hành động và chỉ số của một phiên bản mã. Đọc tỷ lệ lỗi và ngữ cảnh triển khai. - [Thiết lập dự án LogBrew và kiểm tra tín hiệu](https://docs.logbrew.co/vi/concepts/projects.md): Thiết lập dự án LogBrew. Chọn tên dịch vụ và môi trường, đọc trạng thái thiết lập và tìm sự kiện thử từ ứng dụng của bạn. #### Cài đặt và gửi dữ liệu - [Tích hợp SDK để gửi telemetry ứng dụng](https://docs.logbrew.co/vi/guides/sdk-ingestion.md): Chọn SDK LogBrew cho runtime của bạn. Cấu hình khóa gửi dữ liệu. Gửi telemetry ứng dụng và tìm sự kiện thử trong dự án. - [Kiểm tra thiết lập LogBrew bằng khóa đọc dữ liệu của dự án](https://docs.logbrew.co/vi/guides/verify-setup.md): Đọc lại sự kiện thử từ LogBrew bằng khóa đọc dữ liệu của dự án. Tìm hiểu mỗi loại khóa dự án làm được và không làm được gì. - [Che dữ liệu log: không để dữ liệu nhạy cảm lọt vào log](https://docs.logbrew.co/vi/guides/safe-capture.md): Chọn các trường log đã duyệt. Chạy thử cục bộ để tìm dữ liệu nhạy cảm. Xem giới hạn của tùy chọn kiểm soát ghi nhận LogBrew cho JavaScript, Node.js và trình duyệt. - [Xoay vòng khóa API: xoay vòng khóa gửi dữ liệu LogBrew](https://docs.logbrew.co/vi/guides/rotate-ingest-key.md): Xoay vòng khóa gửi dữ liệu LogBrew. Kiểm tra khóa thay thế trước khi thu hồi theo kế hoạch. Khắc phục lỗi mà không làm lộ thông tin xác thực. - [Hướng dẫn thiết lập theo dõi sự kiện cho Node.js](https://docs.logbrew.co/vi/guides/product-events.md): Gửi sự kiện sản phẩm đã phân loại từ Node.js, kèm người dùng có khai báo loại và phiên. Chạy thử ghi nhận cục bộ, rồi đọc kết quả bằng CLI. - [Ghi log React Native với LogBrew](https://docs.logbrew.co/vi/guides/react-native.md): Cài SDK React Native, gửi một log thử nghiệm và tìm log đó trong đúng dự án LogBrew. Cấu hình Expo an toàn và xử lý lỗi gửi dữ liệu. - [Logging và xử lý ngoại lệ Flask với LogBrew](https://docs.logbrew.co/vi/guides/flask.md): Cấu hình logging cho Flask, ghi nhận ngoại lệ chưa xử lý và trace của yêu cầu, rồi dùng LogBrew CLI xác minh từng tín hiệu đã lưu. - [Logging trong Python, mức log và xử lý lỗi](https://docs.logbrew.co/vi/guides/python-logging.md): Cấu hình logging trong Python với mức log phù hợp, xử lý lỗi và các loại ngoại lệ Python, rồi gửi log và crash đến LogBrew. - [Logging trong Node.js với Winston, Pino và Express](https://docs.logbrew.co/vi/guides/node-logging.md): Cấu hình logger Winston hoặc Pino trong Node.js và Express, chọn mức log, rồi gửi log có cấu trúc kèm trace ID đến LogBrew. - [Gửi dữ liệu OpenTelemetry đến LogBrew qua OTLP](https://docs.logbrew.co/vi/guides/opentelemetry.md): Gửi log, trace và chỉ số từ SDK hoặc Collector của OpenTelemetry đến LogBrew qua OTLP/HTTP mà không cần SDK LogBrew. - [Log drain của Supabase và ghi log Edge Functions với LogBrew](https://docs.logbrew.co/vi/guides/supabase.md): Gửi log nền tảng của Supabase đến LogBrew bằng log drain, và ghi nhận log và lỗi từ Supabase Edge Functions bằng SDK JavaScript. - [Source map JavaScript với Vite](https://docs.logbrew.co/vi/guides/source-maps.md): Tải source map JavaScript lên từ bản dựng Vite. Không để thông tin xác thực trong ứng dụng. Ánh xạ khung ngăn xếp đã minify về vị trí mã nguồn gốc. - [Báo cáo crash iOS: crash và treo ứng dụng trên Apple](https://docs.logbrew.co/vi/guides/apple-crashes-and-hangs.md): Thiết lập báo cáo crash cho ứng dụng iOS, tải lên dSYM khớp với bản dựng và đọc log crash iOS đã symbolicate trong LogBrew. - [Ghi lại lần triển khai và tải source map lên bằng GitHub Actions](https://docs.logbrew.co/vi/guides/github-action.md): Dùng GitHub Action của LogBrew để tải source map JavaScript và tệp gỡ lỗi của mã native lên, đồng thời ghi lại mỗi lần triển khai từ một workflow GitHub Actions. #### Điều tra - [Triage và giải quyết vấn đề trong LogBrew](https://docs.logbrew.co/vi/guides/issue-workflow.md): Quản lý vấn đề trong LogBrew. Đọc bằng chứng của lần xảy ra, tìm chủ sở hữu, rồi giải quyết, lưu trữ, mở lại, đặt mức ưu tiên hoặc giao vấn đề cho một người hay một nhóm. - [Gỡ lỗi production: điều tra lỗi với LogBrew](https://docs.logbrew.co/vi/guides/investigate-an-issue.md): Điều tra lỗi ứng dụng dựa trên bằng chứng đã ghi nhận. Chọn một lần xảy ra, xem stack và trace, rồi xác minh lần triển khai ứng viên. - [Khắc phục sự cố ứng dụng: tìm log ứng dụng bị thiếu](https://docs.logbrew.co/vi/guides/troubleshooting.md): Khắc phục tình trạng thiếu log ứng dụng, lỗi thiết lập dự án, bộ lọc, bằng chứng vấn đề và liên kết trace bằng các bước kiểm tra an toàn của LogBrew. #### CLI và agent - [Cài đặt và dùng LogBrew CLI](https://docs.logbrew.co/vi/guides/cli.md): Cài đặt LogBrew CLI trên macOS, Linux hoặc Windows. Đăng nhập, chọn dự án và điều tra vấn đề với đầu ra JSON. - [Debug có AI hỗ trợ với LogBrew](https://docs.logbrew.co/vi/guides/ai-agents.md): Cung cấp bằng chứng LogBrew trong phạm vi cho agent lập trình để điều tra lỗi ứng dụng, ghi lại dữ liệu bị thiếu và xem xét bản sửa ứng viên. - [Kết nối agent AI qua MCP](https://docs.logbrew.co/vi/guides/mcp.md): Kết nối Claude Code, Claude, VS Code, Cursor, Codex, ChatGPT hoặc bất kỳ MCP client nào khác với máy chủ MCP do LogBrew vận hành. Duyệt các dự án mà client được đọc, quyết định client có được thay đổi dữ liệu hay không, và quản lý kết nối trong Cài đặt hoặc CLI. #### Hỗ trợ - [Support API: tạo và theo dõi yêu cầu hỗ trợ](https://docs.logbrew.co/vi/guides/report-a-problem.md): Tạo yêu cầu hỗ trợ LogBrew từ CLI hoặc Support API. Thêm thông tin chẩn đoán an toàn, theo dõi trạng thái và gửi thêm ngữ cảnh. ### Tham khảo #### Tham khảo - [Thuật ngữ observability và LogBrew](https://docs.logbrew.co/vi/reference/terminology.md): 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. - [Tài liệu tham khảo LogBrew CLI: lệnh và bộ lọc](https://docs.logbrew.co/vi/reference/cli.md): Tra cứu các lệnh LogBrew, bộ lọc, phân trang bằng cursor, theo dõi trực tiếp, đầu ra JSON và lỗi. - [Yêu cầu, phản hồi và mã lỗi của Telemetry API](https://docs.logbrew.co/vi/reference/telemetry-api.md): Dùng API observability (khả năng quan sát) của LogBrew để gửi telemetry, đọc theo phạm vi, phân tích, cập nhật vấn đề và nhận lỗi máy đọc được. - [Tham số truy vấn API và phân trang bằng cursor](https://docs.logbrew.co/vi/reference/telemetry-api-filters.md): Lọc telemetry LogBrew theo dự án, dịch vụ, bản phát hành, môi trường, mức độ nghiêm trọng, trace, trạng thái vấn đề, mức ưu tiên, người phụ trách và thời gian. Đọc tiếp kết quả bằng cursor. - [Xử lý lỗi API và mã lỗi API](https://docs.logbrew.co/vi/reference/api-errors.md): Đọc mã lỗi, trạng thái HTTP và ví dụ JSON của API LogBrew. Dùng hướng dẫn khôi phục được trả về để sửa yêu cầu và thử lại an toàn. - [Định dạng phản hồi API và ví dụ phản hồi JSON](https://docs.logbrew.co/vi/reference/telemetry-response-shapes.md): Đọc phản hồi API của LogBrew cho danh sách telemetry, trang cursor, sự kiện trực tiếp, thao tác thay đổi, trạng thái thành công và lỗi. - [Account API và hạn mức sử dụng API](https://docs.logbrew.co/vi/reference/account-api.md): Đọc hạn mức sử dụng của tài khoản LogBrew, lịch sử hạn mức, trạng thái sẵn sàng của gói đăng ký, lời mời vào tổ chức và phản hồi đăng xuất. ## Optional - [Tài liệu cho agent](https://logbrew.co/llms.txt)