---
title: Báo cáo lỗi
description: Gửi báo cáo lỗi từ admin console tới đội ngũ NexCMP qua ticket: biểu mẫu, dữ liệu gửi đi, dữ liệu không bao giờ gửi, giới hạn và cách khắc phục lỗi.
url: https://nexcmp.com/vi/docs/administration/report-a-bug/
applies_to: NexCMP 1.6.1
updated: 2026-11-02
---

# Báo cáo lỗi {#report-a-bug}

> **Vị trí trong admin:** Top bar › **Report a bug** (cạnh Docs; chỉ hiển thị với quản trị viên chính).

Bạn phát hiện lỗi trong NexCMP? Nhấn **Report a bug**, mô tả sự cố và gửi đi. Báo cáo sẽ được chuyển thẳng đến đội ngũ NexCMP dưới dạng một ticket trên tài khoản license của bạn chỉ trong một bước — không cần đăng nhập nơi khác, cũng không cần sao chép file log thủ công. Mọi gói đều có thể sử dụng: NexCMP Free hỗ trợ sửa lỗi, và NexCMP Source cũng vậy.

::: info Báo cáo lỗi không phải là yêu cầu hỗ trợ
NexCMP Free không đi kèm hỗ trợ kỹ thuật, vì vậy hãy dùng biểu mẫu này cho các lỗi phần mềm. Hỗ trợ cài đặt và di chuyển dữ liệu thuộc gói [NexCMP Source](https://nexcmp.com/pricing).
:::

## Yêu cầu {#requirements}

| Hạng mục | Yêu cầu |
|---|---|
| Phiên bản | NexCMP 1.5.2 trở lên |
| Ai có thể gửi | Tài khoản quản trị viên chính. Tài khoản nhân viên (chỉ đọc), reseller console, khách hàng và bản demo chỉ đọc không thể gửi |
| License | License đã kích hoạt (Free hoặc Source) và không bị tạm ngưng |
| Mạng | Máy chủ phải kết nối được tới `https://nexcmp.com` qua HTTPS (cùng địa chỉ dùng để kiểm tra license và cập nhật) |

## Gửi báo cáo {#send-a-report}

1. Nhấp vào **Report a bug** ở thanh trên cùng. Trên điện thoại, hãy mở menu và chọn **Report a bug**.
2. Nhập **Subject** ngắn gọn.
3. Tại mục **What happened**, hãy mô tả những việc bạn đã làm, kết quả bạn thấy và những gì bạn mong đợi.
4. Tùy chọn liệt kê **Các bước tái hiện**.
5. Chọn mức độ **Impact**: **Blocking** (không thể làm việc), **Major** (tính năng chính bị hỏng) hoặc **Minor** (sự cố nhỏ hoặc về giao diện).
6. Giữ bật tùy chọn **Attach diagnostics** (khuyến nghị) và đọc khung **What will be sent**.
7. Nhấp vào **Send report**.

Trong 1.6.1, phần thân biểu mẫu có thể cuộn trong khi các nút thao tác vẫn hiển thị, kể cả trên điện thoại. Các giá trị mật khẩu theo sau `password:` hoặc `password=` được che lại mà không xóa phần còn lại của báo cáo. Hãy kiểm tra lại nội dung trước khi gửi và lược bỏ dữ liệu khách hàng cùng thông tin xác thực.

![Hộp thoại Report a bug gồm tiêu đề, mô tả, mức độ ảnh hưởng và danh sách dữ liệu sẽ được gửi](https://nexcmp.com/vi/docs/images/administration/report-a-bug-01-dialog.webp)

Khi báo cáo được tiếp nhận, hộp thoại sẽ hiển thị mã ticket và đường liên kết. Thư phản hồi (nếu có) sẽ được gửi đến địa chỉ email của tài khoản license trên nexcmp.com, đồng thời ticket cũng được liệt kê tại mục **Support** khi bạn đăng nhập với tư cách chủ sở hữu license.

## Dữ liệu được gửi {#what-is-sent}

Khung **What will be sent** hiển thị chính xác các thông tin sau trước khi bạn nhấn Send:

| Thông tin gửi đi | Chi tiết |
|---|---|
| Nội dung bạn nhập | Tiêu đề, mô tả, các bước thực hiện và mức độ ảnh hưởng |
| Phiên bản, gói, domain | Phiên bản NexCMP, Free hoặc Source, cùng domain của hệ thống cài đặt |
| Trang hiện tại | Trang bạn đang mở trong admin, loại bỏ mọi ký tự đằng sau `?` hoặc `#` |
| Trình duyệt | Chuỗi user-agent của trình duyệt (tên, phiên bản và hệ điều hành), giới hạn tối đa 200 ký tự |
| Lỗi gần đây | Tối đa 5 lỗi gần nhất trong tab trình duyệt này. Với lỗi script thì chỉ gồm nội dung thông báo; với request thất bại thì chỉ gồm method, đường dẫn và mã trạng thái |

Bạn có thể tắt **Attach diagnostics**; khi đó chỉ có nội dung bạn nhập cùng phiên bản, gói và domain được gửi đi.

## Dữ liệu không bao giờ gửi {#what-is-never-sent}

- Mật khẩu, token, cookie và API key. Bất kỳ thông tin nào tương tự trong văn bản của bạn hoặc trong thông báo lỗi đều được che đi (hiển thị dạng `***` hoặc `[redacted]`) ngay trên máy chủ của bạn trước khi gửi.
- Nội dung của request và response — các request thất bại chỉ được ghi lại method, path và status.
- Dữ liệu khách hàng của bạn (tên, email, đơn hàng, hóa đơn) và địa chỉ IP của họ.
- Địa chỉ IP trình duyệt của bạn và bất kỳ tệp nào từ máy chủ. Giống như mọi lần kiểm tra license, máy chủ license sẽ thấy địa chỉ IP mà máy chủ của bạn kết nối đến.

Ticket được liên kết với bản cài đặt của bạn thông qua license token mà máy chủ đang lưu giữ, do đó phiên bản, domain và bản cài đặt được máy chủ thiết lập và không thể thay đổi từ trình duyệt.

## Giới hạn {#limits}

| Hạn mức | Giá trị |
|---|---|
| Subject | 150 ký tự |
| Description cùng với steps | Tổng cộng 8 KB |
| Reports | 5 mỗi giờ và 20 mỗi ngày cho toàn bộ bản cài đặt |

Gửi cùng một báo cáo hai lần (ví dụ sau lỗi mạng) sẽ không tạo ticket thứ hai.

## Xử lý sự cố {#troubleshooting}

| Thông báo | Nguyên nhân | Cách khắc phục |
|---|---|---|
| Kích hoạt license của bạn trước | Bản cài đặt chưa có license được kích hoạt | Mở **License & updates** và kích hoạt, sau đó gửi lại |
| Không thể kết nối đến license server | Máy chủ không thể kết nối tới `nexcmp.com` | Kiểm tra kết nối HTTPS chiều ra (outbound) và DNS từ máy chủ, sau đó nhấn lại **Send report** — nội dung bạn nhập vẫn được giữ nguyên |
| Quá nhiều báo cáo lỗi từ bản cài đặt này | Bạn đã đạt giới hạn 5 báo cáo mỗi giờ hoặc 20 báo cáo mỗi ngày | Hãy đợi rồi thử lại; thay vào đó, bạn có thể bổ sung các phát hiện mới vào ticket đang mở |
| License này đã bị tạm ngưng | License bị tạm ngưng hoặc đã hoàn tiền | Xem [Giấy phép và mua hàng](https://nexcmp.com/vi/docs/getting-started/license-and-purchase/) |
| Bản cài đặt này đã bị thu hồi | Bản cài đặt đã bị thu hồi trong cổng quản lý license | Kích hoạt lại từ **License & updates** |
| Không thể làm mới license token | Máy chủ không thể làm mới license token của mình | Mở **License & updates**, nhấn **Refresh**, sau đó gửi lại |
| Không có nút Report a bug | Bạn đang đăng nhập bằng tài khoản nhân viên, reseller hoặc khách hàng, hoặc đang ở bản demo chỉ đọc | Đăng nhập bằng tài khoản quản trị viên chính |

::: tip Dành cho AI assistant và API key
Trợ lý trong trang quản trị và admin API key không thể thay mặt bạn gửi báo cáo lỗi: nút này yêu cầu một người thực đăng nhập với tư cách quản trị viên chính.
:::