# Processor Groups

### Tổng quan

Processor Group: cho phép bạn chỉ định nơi lấy dữ liệu log (source log project), nơi lưu trữ dữ liệu đã parse (destination log project) và những log nào sẽ được parse khi thoả mãn filter.

***

### Khởi tạo Processor Groups

Processor Group: cho phép bạn chỉ định nơi lấy dữ liệu log (source log project), nơi lưu trữ dữ liệu đã parse (destination log project) và những log nào sẽ được parse khi thoả mãn filter.

Để tạo processor group, hãy làm theo hướng dẫn bên dưới:

1\. Đăng nhập vào [https://hcm-3.console.vngcloud.vn/vmonitor](https://hcm-3.console.vngcloud.vn/vmonitor/).

2\. Chọn thư mục **Log**, sau đó chọn menu **Log pipeline**.

3\. Chọn một **Log pipeline** đã được tạo trước đó.

4\. Chọn **Create a processor group** hoặc **Process Group Library** trong đó:

* **Create a processor group**: tạo mới hoàn toàn processor group.
* **Process Group Library**: tạo processor group từ những thư viện có sẵn do GreenNode hỗ trợ.

<details>

<summary>Tạo một processor group</summary>

1. Nhập tên processor **Group name**. Tên Group name phải tuân thủ theo quy định của chúng tôi, chi tiết xem tại [Phạm vi giới hạn Log pipeline](https://docs.vngcloud.vn/pages/viewpage.action?pageId=49650030).
2. Nhập **Description** cho processor group này.
3. Chọn **Source** và **Destination log project** mà bạn muốn thực hiện pipeline trong danh sách các log project đang tồn tại trên account của bạn. <mark style="color:red;">**Source log project và Destination log project không thể là cùng một log project mà bắt buộc bạn phải chọn chúng là những log project khác biệt. Nếu Destination log project đã có dữ liệu thì việc tạo luồng pipeline cho project này có thể gây mất đồng bộ dữ liệu.**</mark>
4. Nhập điều kiện **Filter** cho log nếu có. Bạn có thể nhập điều kiện lọc cho log bằng một trong 2 cách: **Suggestion mode** hoặc **Editor mode**. Cách sử dụng 2 phương thức này và chuyển đổi qua lại giữa 2 phương thức đã được chúng tôi mô tả ở các tính năng [Search logs](https://docs-admin.vngcloud.vn/display/VPV/Search+logs).
5. Chọn **Create.**

![](https://docs-admin.vngcloud.vn/download/attachments/49650043/image2023-7-31_14-9-40.png?version=1\&modificationDate=1690787381000\&api=v2)

</details>

<details>

<summary>Process Group Library</summary>

Hiện tại GreenNode hỗ trợ thư viện cho 2 ứng dụng phổ biến là **Apache, Nginx**. Khi bạn chọn **Process Group Library**, tiếp tục thực hiện các bước dưới đây để hoàn thành tạo processor group

1. Chọn <img src="https://docs-admin.vngcloud.vn/download/thumbnails/49650043/image2023-3-27_9-48-38.png?version=1&#x26;modificationDate=1679885318000&#x26;api=v2" alt="" data-size="line">(**Duplicate this group)** để tạo Processor Group từ Library này.

<img src="https://docs-admin.vngcloud.vn/download/attachments/49650043/image2023-8-2_15-6-24.png?version=1&#x26;modificationDate=1690963585000&#x26;api=v2" alt="" data-size="original">

2. Nhập các thông tin bao gồm:

* **Group name**: nhập tên processor group. Tên group phải tuân thủ theo quy định của chúng tôi, chi tiết xem tại [Phạm vi giới hạn Log pipeline](https://docs.vngcloud.vn/pages/viewpage.action?pageId=49650030).
* **Description**: nhập mô tả processor group này
* Chọn **Source** và **Destination log project** mà bạn muốn thực hiện pipeline trong danh sách các log project đang tồn tại trên account của bạn. <mark style="color:red;">**Source log project và Destination log project không thể là cùng một log project mà bắt buộc bạn phải chọn chúng là những log project khác biệt. Nếu Destination log project đã có dữ liệu thì việc tạo luồng pipeline cho project này có thể gây mất đồng bộ dữ liệu.**</mark>
* Nhập điều kiện **Filter** cho log nếu có. Bạn có thể nhập điều kiện lọc cho log bằng một trong 2 cách: **Suggestion mode** hoặc **Editor mode**. Cách sử dụng 2 phương thức này và chuyển đổi qua lại giữa 2 phương thức đã được chúng tôi mô tả ở các tính năng [Search logs](https://docs-admin.vngcloud.vn/display/VPV/Search+logs).

3. Chọn **Duplicate**.

![](https://docs-admin.vngcloud.vn/download/attachments/49650043/image2023-8-2_15-2-28.png?version=1\&modificationDate=1690963350000\&api=v2)

Sau khi bạn sao chép thành công:

* Đối với thư viện **Apache**, hệ thống sẽ tự tạo một **3 Processor** loại: **Grok Parser, GeoIP Parse, User-Agent Parser**. Nếu các cấu hình parser này chưa như bạn mong muốn, bạn có thể chỉnh sửa các **Processor** này theo hướng dẫn tại [Processor](https://docs-admin.vngcloud.vn/display/VPV/Processor).
* Đối với thư viện **Nginx**, hệ thống sẽ tự tạo một **4 Processor** loại: **Grok Parser, Field Remapper Parser, GeoIP Parse, Date Parser**. Nếu các cấu hình parser này chưa như bạn mong muốn, bạn có thể chỉnh sửa các **Processor** này theo hướng dẫn tại [Processor](https://docs-admin.vngcloud.vn/display/VPV/Processor).

<img src="https://docs-admin.vngcloud.vn/download/attachments/49650043/image2023-8-2_15-8-35.png?version=1&#x26;modificationDate=1690963717000&#x26;api=v2" alt="" data-size="original">

![](https://docs-admin.vngcloud.vn/download/attachments/49650043/image2023-8-2_15-9-10.png?version=1\&modificationDate=1690963751000\&api=v2)

</details>

***

### Chỉnh sửa Processor Groups

Để chỉnh sửa Processor group trong Log pipeline, hãy làm theo hướng dẫn bên dưới

1. Đăng nhập vào <https://hcm-3.console.vngcloud.vn/vmonitor>. Nếu bạn chưa có tài khoản, đăng ký miễn phí tại [tại đây](https://register.vngcloud.vn/signup).
2. Chọn thư mục **Log.**
3. Chọn **Log pipeline.**
4. Trong danh sách log pipeline đang có, chọn **Log pipeline** chứa **Processor group** mà bạn muốn chỉnh sửa.
5. Tại **Processor group** mà bạn muốn chỉnh sửa, chọn <img src="https://3672463924-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FB0NrrrdJdpYOYzRkbWp5%2Fuploads%2FM0htYOlkZQzClLStnGpq%2Fimage.png?alt=media&#x26;token=978b5221-e697-4b44-80fb-671aba835d4b" alt="" data-size="line">
6. Chọn **Edit group**.
7. Chỉnh sửa các thông số cho **Processor group** mà bạn mong muốn. Bạn có thể chỉnh sửa tất cả các trường thông tin trong cấu hình một processor group. Việc chỉnh sửa này tương tự như khi bạn thực hiện tạo mới một Processor group theo hướng dẫn bên trên.
8. Chọn **Save.**

***

### Xóa Processor Groups

Khi bạn không có nhu cầu sử dụng một Processor group tùy chỉnh nữa, bạn có thể thực hiện xóa Processor group khỏi hệ thống theo hướng dẫn bên dưới:

1. Đăng nhập vào <https://hcm-3.console.vngcloud.vn/vmonitor>. Nếu bạn chưa có tài khoản, đăng ký miễn phí tại [tại đây](https://register.vngcloud.vn/signup).
2. Chọn thư mục **Log.**
3. Chọn **Log pipeline** chứa processor group mà bạn muốn thực hiện xóa.
4. Chọn **Processor group.**
5. Tại **Processor group** mà bạn muốn xóa, chọn <img src="https://3672463924-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FB0NrrrdJdpYOYzRkbWp5%2Fuploads%2FM0htYOlkZQzClLStnGpq%2Fimage.png?alt=media&#x26;token=978b5221-e697-4b44-80fb-671aba835d4b" alt="" data-size="line">
6. Chọn **Delete**.
7. Tại màn hình xác nhận xóa Processor group, chọn **Delete**.

Sau khi bạn thực hiện xóa thành công thì Processor group của bạn sẽ bị xóa hoàn toàn khỏi hệ thống của chúng tôi đồng thời tất cả các processor bên trong một processor group cũng sẽ bị xóa. Bạn không thể khôi phục lại Processor group đã xóa nên hãy lưu ý cẩn thận khi sử dụng tính năng này.

<br>


---

# Agent Instructions: 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:

```
GET https://docs.vngcloud.vn/vng-cloud-document/vn/vmonitor/dashboards/logs/lam-viec-voi-log-pipeline/processor-groups.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
