> For the complete documentation index, see [llms.txt](https://docs.datasuite.vn/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.datasuite.vn/cac-tinh-nang/data-pipeline/troubleshooting.md).

# Troubleshooting

## Pipeline ở trạng thái "Setup Pending" và không có lần chạy nào

**Triệu chứng:** Danh sách pipeline hiển thị **Setup Pending** và phần Pipeline Run History trống.

**Nguyên nhân:** Pipeline được tạo từ template nhưng data agent chưa được kết nối. Pipeline không thể chạy cho đến khi các bảng dữ liệu thô được nạp đầy qua quá trình cài đặt ingestion.

**Cách xử lý:**

1. Nhấn vào tên pipeline để mở trang chi tiết.
2. Mở tab **Pipeline Ingestion**.
3. Làm theo **Hướng dẫn cài đặt** ở bên phải: tải file cấu hình agent, cài đặt và chạy Logstash agent với database của bạn.
4. Chờ cho dữ liệu xuất hiện trong các bảng dữ liệu thô ở bên trái.
5. Nhấn **Run Pipeline & Create Report** để bắt đầu lần chạy đầu tiên.

Trạng thái sẽ chuyển sang **Active** và lần chạy đầu tiên sẽ xuất hiện trong Pipeline Run History. Xem [Tạo pipeline từ report template](/cac-tinh-nang/data-pipeline/tao-pipeline-tu-template.md) để biết hướng dẫn chi tiết.

***

## Lần chạy theo lịch không được kích hoạt

**Triệu chứng:** Thời gian **Next Run** đã qua nhưng không có lần chạy mới nào trong lịch sử.

**Nguyên nhân:** Pipeline có thể đang ở trạng thái không hoạt động hoặc bị tạm dừng, hoặc đã xảy ra lỗi hệ thống.

**Cách xử lý:**

1. Kiểm tra cột **Status** của pipeline. Nếu hiển thị **Inactive**, kích hoạt lại pipeline.
2. Nhấn **Run Pipeline** để chạy thủ công và xác nhận pipeline thực thi thành công.
3. Nếu lần chạy thủ công cũng thất bại, kiểm tra chi tiết lần chạy để xem thông báo lỗi.

***

## Lần chạy thất bại với lỗi

**Triệu chứng:** Một lần chạy trong lịch sử hiển thị trạng thái **Failed**.

**Nguyên nhân:** Nguồn dữ liệu (database kết nối trực tiếp hoặc file) không khả dụng, hoặc cấu hình pipeline tham chiếu đến dataset không còn tồn tại.

**Cách xử lý:**

1. Nhấn vào hàng lần chạy thất bại để xem chi tiết lỗi.
2. Kiểm tra xem nguồn dữ liệu có truy cập được không. Với pipeline dùng database, liên hệ quản trị viên database của bạn.
3. Kiểm tra xem các dataset mà pipeline tham chiếu còn tồn tại trong Data Warehouse không. Xem [Quản lý và chỉnh sửa dataset](/cac-tinh-nang/ket-noi-va-chuan-bi-du-lieu/dataset.md).
4. Nhấn **Run Pipeline** để thử lại sau khi đã khắc phục sự cố.

***

## Nút "Run Pipeline & Create Report" không kích hoạt

**Triệu chứng:** Tab **Pipeline Ingestion** hiển thị các bảng dữ liệu thô nhưng nút **Run Pipeline & Create Report** bị mờ hoặc không hiển thị.

**Nguyên nhân:** Các bảng dữ liệu thô đang trống — data agent chưa kết nối thành công hoặc chưa đồng bộ dữ liệu nào.

**Cách xử lý:**

1. Kiểm tra container Logstash agent có đang chạy không: `docker logs <tên-container>` và tìm lỗi kết nối.
2. Xác minh thông tin kết nối database trong `agent.env` (host, port, tên database, tên đăng nhập, mật khẩu).
3. Xác nhận database có thể truy cập từ máy đang chạy agent.
4. Khi agent kết nối thành công, dữ liệu sẽ xuất hiện trong các bảng và nút sẽ kích hoạt.

***

## Không thể tạo pipeline thủ công

**Triệu chứng:** Bạn nhấn **Create Pipeline** trên trang Data Pipeline nhưng nút bị vô hiệu hóa.

**Nguyên nhân:** Tính năng tạo pipeline thủ công chưa có trong phiên bản hiện tại.

**Cách xử lý:** Cài đặt Report Template có kèm pipeline dựng sẵn. Xem [Tạo pipeline từ report template](/cac-tinh-nang/data-pipeline/tao-pipeline-tu-template.md).

***

## Tài nguyên liên quan

* [Data Pipeline — Tổng quan](/cac-tinh-nang/data-pipeline.md)
* [Tạo pipeline từ report template](/cac-tinh-nang/data-pipeline/tao-pipeline-tu-template.md)
* [Theo dõi lịch sử chạy pipeline](/cac-tinh-nang/data-pipeline/theo-doi-lich-chay-pipeline.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.datasuite.vn/cac-tinh-nang/data-pipeline/troubleshooting.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.