# Chẩn đoán và gửi nhật ký cho hỗ trợ

> Xem nhật ký lỗi trên máy, gửi nhật ký kèm mô tả sự cố để nhận mã hỗ trợ, bật/tắt báo cáo lỗi tự động.
Nguồn: https://studio.adayroi.online/docs/cai-dat-chan-doan

**Cài đặt → Chẩn đoán & hỗ trợ** giúp bạn và đội hỗ trợ tìm ra nguyên nhân khi app gặp sự cố. App ghi nhật ký hoạt động và lỗi trên máy, **giữ 14 ngày**, vẫn còn sau khi tắt mở lại.

![Cài đặt → Chẩn đoán & hỗ trợ](https://studio.adayroi.online/media/public/docs/guide/cai-dat-diagnostics.webp)

## Gửi nhật ký cho hỗ trợ

1. Bấm **Gửi nhật ký cho hỗ trợ…**
2. Mô tả sự cố (đang làm gì, bấm gì thì lỗi).
3. App gửi kèm nhật ký gần đây — **đã che mật khẩu, khoá API, đường dẫn tệp** — và trả về **một mã**.
4. Báo mã đó cho bộ phận hỗ trợ (khung chat hỗ trợ góc dưới phải, hoặc trang Liên hệ).

## Báo cáo lỗi tự động

- **Tự động gửi báo cáo lỗi** — khi app lỗi, bị đứng hoặc tắt đột ngột, gửi một báo cáo ngắn (thông báo lỗi, phiên bản, hệ điều hành). **Không gửi nội dung dự án.**
- **Gắn báo cáo với tài khoản của tôi** — để hỗ trợ liên hệ lại đúng bạn.
- **Ghi lại thao tác gần đây** — kèm vài thao tác cuối trước khi lỗi, giúp tái hiện lỗi.

Dòng **Mã máy** và **kênh** (bản phát hành / thử nghiệm) giúp hỗ trợ nhận ra máy của bạn.

## Nhật ký trên máy

- Lọc **Chỉ lỗi · Cảnh báo · Tất cả**, **Làm mới**, **Sao chép** (dán vào tin nhắn hỗ trợ), **Mở thư mục nhật ký**.
- Mỗi dòng cho biết mức (ERROR/WARN), nội dung, thời điểm và nguồn; dòng lặp lại được gộp với số lần (×246).

Một số lỗi hay gặp:

| Dòng nhật ký | Ý nghĩa |
| --- | --- |
| `[ui.freeze] Giao diện bị đứng khoảng … giây` | App bị treo một lúc (thường do cảnh 3D quá nặng hoặc máy hết RAM). |
| `[app.session] Lần chạy trước kết thúc bất thường` | Lần trước app bị tắt cưỡng bức, treo hoặc mất điện. |
| `Project persistence timed out` | Lưu dự án quá chậm — đĩa đầy hoặc dự án rất lớn. |

Xem thêm [Câu hỏi thường gặp](/docs/cau-hoi-thuong-gap).