# Thiết lập telemetry cho LogBrew
Chọn ứng dụng hoặc framework, tạo dự án và kiểm tra một tín hiệu an toàn.

# Chọn nền tảng
Chọn ứng dụng hoặc framework gửi telemetry. Dùng cùng lựa chọn đó ở trang Thêm dự án.

## Dịch vụ Node.js
Dùng package Node.js khi một dịch vụ backend cần log, span request, hành động, bản phát hành và chỉ số.

```bash
npm install @logbrew/sdk @logbrew/node
```
Next: Dùng hướng dẫn tín hiệu đầu tiên cho Node

## Dịch vụ Express
Dùng package Express khi một dịch vụ Node xử lý request qua middleware Express.

```bash
npm install @logbrew/sdk @logbrew/express express
```
Next: Mở trang Thêm dự án

## Dịch vụ Fastify
Dùng package Fastify khi một dịch vụ Node xử lý route qua plugin Fastify.

```bash
npm install @logbrew/sdk @logbrew/fastify fastify
```
Next: Mở trang Thêm dự án

## Ứng dụng JavaScript
Dùng package JavaScript cho trình duyệt với các trang frontend gửi hành động sản phẩm, log và tín hiệu nhẹ từ phía client.

```bash
npm install @logbrew/sdk @logbrew/browser
```
Next: Mở trang Thêm dự án

## Ứng dụng Next.js
Dùng package Next.js khi route, server rendering và hành động phía client cần chung một cách thiết lập.

```bash
npm install @logbrew/sdk @logbrew/next next react react-dom
```
Next: Mở trang Thêm dự án

## Ứng dụng React
Dùng package React cho ứng dụng web xây dựng theo component, gửi hành động người dùng và trạng thái UI.

```bash
npm install @logbrew/sdk @logbrew/react react
```
Next: Mở trang Thêm dự án

## Ứng dụng Angular
Dùng package Angular khi routing của framework và lỗi ứng dụng cần chung một cách thiết lập.

```bash
npm install @logbrew/sdk @logbrew/angular @angular/core
```
Next: Mở trang Thêm dự án

## Ứng dụng Vue
Dùng package Vue cho ứng dụng Vue cần hành động sản phẩm rõ ràng và tín hiệu phía trình duyệt.

```bash
npm install @logbrew/sdk @logbrew/vue vue
```
Next: Mở trang Thêm dự án

## Ứng dụng Svelte
Dùng package Svelte cho ứng dụng Svelte cần cách cài đặt SDK trực tiếp.

```bash
npm install @logbrew/sdk @logbrew/svelte svelte
```
Next: Mở trang Thêm dự án

## Dịch vụ NestJS
Dùng package NestJS khi một dịch vụ Node được tổ chức theo module Nest và cách xử lý request của Nest.

```bash
npm install @logbrew/sdk @logbrew/nestjs @nestjs/common @nestjs/core @nestjs/platform-express reflect-metadata rxjs
```
Next: Mở trang Thêm dự án

## Dịch vụ Python
Bắt đầu với package lõi cho worker và dịch vụ Python.

```bash
python3 -m pip install logbrew-sdk
```
Next: Mở trang Thêm dự án

## Ứng dụng Django
Dùng package Django cho tín hiệu request và ứng dụng từ một dự án Django.

```bash
python3 -m pip install logbrew-sdk logbrew-django
```
Next: Mở trang Thêm dự án

## Dịch vụ FastAPI
Dùng package FastAPI cho API Python có span request và hành động tường minh.

```bash
python3 -m pip install logbrew-sdk logbrew-fastapi
```
Next: Mở trang Thêm dự án

## Dịch vụ .NET
Cài package .NET khi một dịch vụ tự gửi tín hiệu phía server.

```bash
dotnet add package LogBrew
```
Next: Mở trang Thêm dự án

## Ứng dụng ASP.NET Core
Dùng package ASP.NET Core khi việc xử lý request .NET và tín hiệu ứng dụng web cần chung một cách thiết lập.

```bash
dotnet add package LogBrew.AspNetCore
```
Next: Mở trang Thêm dự án

## Dịch vụ Java
Dùng package JVM cho dịch vụ Java cần log do ứng dụng tự gửi, span request và hành động sản phẩm.

```bash
implementation("co.logbrew:logbrew-sdk:0.1.0")
```
Next: Mở trang Thêm dự án

## Dịch vụ Go
Thêm package Go khi một dịch vụ tự quản lý log, span, chỉ số và ngữ cảnh trace một cách tường minh.

```bash
go get github.com/LogBrewCo/sdk/go/logbrew@v0.1.3
```
Next: Mở trang Thêm dự án

## Ứng dụng PHP
Dùng Composer cho dịch vụ PHP và tín hiệu request do ứng dụng tự gửi.

```bash
composer require logbrew/sdk
```
Next: Mở trang Thêm dự án

## Dịch vụ Ruby
Dùng gem Ruby cho dịch vụ Ruby cần tín hiệu ứng dụng và request tường minh.

```bash
gem install logbrew-sdk
```
Next: Mở trang Thêm dự án

## Dịch vụ Rust
Thêm crate Rust cho dịch vụ tự tạo log, span, hành động và chỉ số.

```bash
cargo add logbrew
```
Next: Mở trang Thêm dự án

## Ứng dụng iOS
Dùng package cho nền tảng Apple với ứng dụng iOS gửi tín hiệu sản phẩm tường minh.

```bash
.package(url: "https://github.com/LogBrewCo/sdk.git", from: "0.1.1")
```
Next: Mở trang Thêm dự án

## Ứng dụng Android
Dùng package Android cho ứng dụng gửi tín hiệu do ứng dụng tự tạo từ runtime Android.

```bash
implementation("co.logbrew:logbrew-kotlin:0.1.0")
```
Next: Mở trang Thêm dự án

## Ứng dụng React Native
Dùng package React Native cho ứng dụng di động dùng chung hành động sản phẩm viết bằng JavaScript.

```bash
npm install @logbrew/sdk @logbrew/react-native react react-native
```
Next: Mở trang Thêm dự án

## Ứng dụng Unity
Dùng package Unity cho game hoặc mô phỏng gửi hành động sản phẩm và tín hiệu runtime.

```bash
"co.logbrew.unity": "file:../Packages/co.logbrew.unity"
```
Next: Mở trang Thêm dự án

## Ứng dụng C
Dùng mã nguồn C cho dịch vụ native hoặc ứng dụng nhúng cần kiểm soát tín hiệu trực tiếp.

```bash
cc -std=c99 -Wall -Wextra -Wpedantic -Iinclude src/logbrew.c src/logbrew_metric.c src/logbrew_recording_transport.c src/logbrew_timeline.c src/logbrew_trace.c your_app.c -o your_app
```
Next: Mở trang Thêm dự án

## Ứng dụng C++
Chạy kế hoạch CLI đã phát hành trong một dự án CMake 3.16+ dùng C++17. Liên kết LogBrew::LogBrew. Chỉ bật LogBrew::HttpTransport và libcurl khi cần gửi dữ liệu lên dịch vụ được lưu trữ.

```bash
logbrew setup --json
```
Next: Mở trang Thêm dự án

## Tổng quan các bước thiết lập
Làm theo thứ tự này để đi từ tài liệu đến một hành động sản phẩm đã được kiểm tra mà không rời luồng thiết lập.

- Cài đặt. Thêm package: Bắt đầu với package SDK cho runtime của bạn.
- Tạo. Tạo dự án: Mở trang Thêm dự án và sao chép thông tin xác thực của dự án. Thông tin này chỉ hiển thị một lần.
- Gửi. Gửi một hành động sản phẩm: Chạy một hành động sản phẩm không chứa bí mật trước khi tích hợp vào ứng dụng.
- Kiểm tra. Kiểm tra log: Xác nhận tín hiệu trong log hoặc bằng CLI.

# Lần chạy SDK thành công đầu tiên
Giữ phiên đầu tiên thật gọn: cài package, tạo dự án, gửi một hành động sản phẩm không chứa bí mật, rồi xác nhận trong LogBrew.

## Những gì cần cho tín hiệu đầu tiên
Gửi dữ liệu trực tiếp từ SDK giúp quá trình thiết lập ngắn gọn.

- Collector: Không cần agent cục bộ. Cài package SDK và gửi trực tiếp đến API của LogBrew.
- Thông tin xác thực: Một thông tin xác thực cho mỗi dự án. Chỉ sao chép từ trang Thêm dự án khi tạo hoặc thiết lập dự án đó.
- Bằng chứng: Kiểm tra trong log. Gửi một tín hiệu info, rồi xác nhận trước khi instrument rộng hơn.

## Ngữ cảnh cho trợ lý AI
Đưa cho agent bản đồ LogBrew công khai trước khi nó sửa ứng dụng hoặc lệnh thiết lập của bạn.

```bash
curl -L https://logbrew.co/llms.txt
```

### prompt cài đặt
```bash
Đọc https://logbrew.co/llms.txt, rồi chọn thẻ SDK phù hợp tại https://logbrew.co/en/docs#docs-sdk-choice-title. Chỉ dùng npm install @logbrew/sdk @logbrew/node cho dịch vụ Node.js phía server; với Next.js, React, iOS, Android hoặc React Native, hãy dùng thẻ đã chọn và prompt trong trang Thêm dự án. Đề nghị người dùng đã đăng nhập mở trang Thêm dự án và chỉ đặt thông tin xác thực vào môi trường của đúng ứng dụng đó. Với Node.js phía server, biến môi trường là LOGBREW_SERVER_API_KEY. Chỉ chạy node node_modules/@logbrew/node/examples/first-useful-telemetry.mjs cho dịch vụ Node, rồi kiểm tra bằng logbrew logs info --json. Không yêu cầu thông tin xác thực qua chat hoặc trong commit.
```
Next: Mở hướng dẫn cho agent

## Cài đặt SDK
Dùng các package Node cho dịch vụ backend cần log, span, hành động, bản phát hành và chỉ số.

```bash
npm install @logbrew/sdk @logbrew/node
```


## Tạo dự án
Mở trang Thêm dự án, chọn nền tảng và sao chép thông tin xác thực gửi dữ liệu. Bảng thiết lập chỉ hiển thị nó một lần.

Next: Mở trang Thêm dự án

## Gửi một hành động sản phẩm
Chạy ví dụ đi kèm package trước khi tích hợp vào mã production, để biết trước cấu trúc dữ liệu đầu tiên và không cần token.

```bash
node node_modules/@logbrew/node/examples/first-useful-telemetry.mjs
```


## Kiểm tra trong LogBrew
Đọc tín hiệu info đầu tiên trong log trước khi instrument thêm.

```bash
logbrew logs info --json
```


# Gửi tín hiệu Node SDK đầu tiên đến LogBrew
Thiết lập một dịch vụ Node.js và kiểm tra telemetry đầu tiên của nó. Trang Thêm dự án tạo dự án và hiển thị thông tin xác thực gửi dữ liệu một lần. Các bước dưới đây hướng dẫn cài đặt và kiểm tra.

## Thêm các package JavaScript SDK
Bắt đầu với SDK lõi và helper Node khi một dịch vụ backend cần log, span request, hành động, bản phát hành và chỉ số.

```bash
npm install @logbrew/sdk @logbrew/node
```

## Tạo dự án từ trang Thêm dự án
Đăng nhập, mở trang Thêm dự án, chọn nền tảng và sao chép thông tin xác thực gửi dữ liệu. Thông tin này chỉ hiển thị một lần. Website sẽ không hiển thị lại sau khi bạn rời bảng thiết lập.


## Chạy ví dụ tín hiệu SDK đầu tiên
Dùng ví dụ trong package đã cài để xem cấu trúc của bản phát hành, môi trường, span request, hành động sản phẩm, mốc mạng và chỉ số trước khi tích hợp vào ứng dụng.

```bash
node node_modules/@logbrew/node/examples/first-useful-telemetry.mjs
```

## Đọc tín hiệu đầu tiên trong LogBrew
Sau khi SDK gửi một tín hiệu info kèm thông tin xác thực của dự án, dùng CLI hoặc chế độ xem log trên bảng điều khiển để xác nhận tín hiệu đã đến trước khi instrument thêm.

```bash
logbrew logs info --json
```

# Chọn hướng đi
## Kiểm tra LogBrew đã sẵn sàng chưa
Chạy status trước để xác nhận kết nối, trạng thái đăng nhập và lần đọc an toàn tiếp theo.

```bash
logbrew status --json
```

## Bắt đầu từ lỗi mới nhất
Đọc log lỗi gần đây, rồi chuyển sang vấn đề hoặc trace khi một bản phát hành hay dự án cần thêm ngữ cảnh.

```bash
logbrew logs error --json
```

## Chia sẻ chế độ xem vấn đề ổn định
Liệt kê các vấn đề đang mở khi đồng nghiệp cần xem cùng các nhóm lỗi.

```bash
logbrew issues open --json
```

# Bản đồ lệnh
## Trạng thái
Kiểm tra xác thực cục bộ, kết nối tới API và các bước khôi phục trước mọi lần đọc dữ liệu riêng tư.

```bash
logbrew status --json
```

## Log
Bắt đầu với lỗi gần đây khi một bản phát hành, dự án hoặc trace cần ngữ cảnh.

```bash
logbrew logs error --json
```

## Vấn đề
Liệt kê các nhóm lỗi đang mở trước khi quyết định giải quyết, đóng, bỏ qua hay mở lại.

```bash
logbrew issues open --json
```

## Chi tiết trace
Đọc một trace id đã biết khi log hoặc vấn đề chỉ đến một request bị lỗi.

```bash
logbrew trace <trace_id> --json
```

## Hành động
Lọc sự kiện người dùng theo tên khi ngữ cảnh quan trọng là một hành động sản phẩm.

```bash
logbrew actions --name checkout_failed --json
```

## Bản phát hành
So sánh ngữ cảnh triển khai với số log, vấn đề, span trace và hành động.

```bash
logbrew releases --json
```

## Kiểm tra xác thực cục bộ và kết nối tới API
Lần đọc đầu tiên cần cho bạn biết CLI có kết nối được API của LogBrew hay không mà không làm lộ token.

- Dùng chế độ JSON khi script hoặc tự động hóa cần các trường ổn định.
- Dùng đầu ra dễ đọc khi lập trình viên cần lệnh tiếp theo.
- Khi cần khôi phục xác thực, luôn hướng về login và status.

## Đọc tín hiệu production theo tài nguyên
Bắt đầu với tín hiệu trả lời được câu hỏi của bạn. Mở chi tiết để xem bằng chứng liên quan.

- Log giữ các bộ lọc mức độ, bản phát hành, môi trường, dự án, trace và tìm kiếm.
- Kiểm tra trạng thái và lần xảy ra gần nhất của vấn đề trước khi điều tra.
- Trace giữ tên span, ngữ cảnh bản phát hành, ngữ cảnh môi trường và phạm vi dự án.

## Gửi ngữ cảnh hữu ích mà không làm lộ dữ liệu dự án
Dùng tài liệu công khai, Markdown và các lệnh có thể sao chép khi ai đó cần trợ giúp thiết lập hoặc bàn giao an toàn.

- Chia sẻ liên kết tài liệu khi bước tiếp theo là thiết lập hoặc tìm lệnh.
- Chia sẻ Markdown khi văn bản thuần dễ dùng hơn ảnh chụp màn hình.
- Chỉ chia sẻ dữ liệu dự án riêng tư với người có quyền xem.

## Chọn dự án và khoảng thời gian
Dùng tài liệu tham khảo API telemetry để xem các route, bộ lọc được hỗ trợ cùng ví dụ thành công và lỗi.

- Xác thực trước khi yêu cầu dữ liệu dự án riêng tư.
- Chọn dự án và khoảng thời gian trước khi so sánh kết quả.
- Làm theo các bước khôi phục được trả về khi request thất bại.
- Tách bằng chứng bị thiếu khỏi bằng chứng không tải được.

## Public agent links
- Full docs site: https://docs.logbrew.co
- Docs: https://logbrew.co/vi/docs
- Docs Markdown: https://logbrew.co/vi/docs.md
- Agent guide: https://logbrew.co/vi/agents
- Home Markdown: https://logbrew.co/vi/page.md
- llms.txt: https://logbrew.co/llms.txt
- Sitemap: https://logbrew.co/sitemap.xml