Lưu trữ nhật ký cục bộ AkaBot Studio/Agent

Phần này giúp bạn hiểu các tệp nhật ký được tạo ra trong quá trình sử dụng AkaBot Studio/Agent.

Nội dung chính

1. Giải thích nhật ký AkaBot Studio/Agent là gì ?

2. Vị trí lưu nhật ký (Log Output Locations)

3. Các loại nhật ký (Types of Logs)

4. Gửi Nhật Ký (Sending Logs)

1. Giải thích

Mỗi khi AkaBot Studio hoặc Agent thực hiện một thao tác, hệ thống sẽ tự động tạo ra nhiều tệp nhật ký (log) và ghi thông tin vào các tệp này.

Phần này sẽ giúp bạn:

• Hiểu các vị trí lưu trữ log trên máy tính.

• Biết được các loại log mà hệ thống tạo ra.

* Lưu ý: Nội dung này được kiểm chứng trên AkaBot Studio phiên bản 2.2.0.1.
* Lưu ý: Một số thuật ngữ có thể khác nhau dựa trên phiên bản phần mềm mà bạn đang sử dụng.

2. Vị trí lưu trữ nhật kí (Log Output Locations)

Có 3 vị trí mà các tệp nhật kí của AkaBot Studio/Agent được lưu trữ.
* Hãy thay cụm từ "PC Username" bằng tên người dùng hệ điều hành đang chạy AkaBot Studio/Agent trên máy của bạn.

* Các tệp JSON được liệt kê không phải là log, nhưng có thể cần thiết để kiểm tra thông tin cấu hình, vì vậy chúng vẫn được đưa vào danh sách.

Nếu bạn cài đặt “Trình quản lý tệp” (File Explorer) để hiển thị “tệp ẩn”, bạn có thể mở các thư mục này trực tiếp từ Explorer.
* Cách bật chế độ hiển thị “tệp ẩn”, vui lòng tham khảo hướng dẫn “Hiển thị tệp ẩn” (Show hidden files) Microsoft.

Ngoài ra, nếu bạn nhấp vào “Mở nhật ký” (Open Log) ngay trên màn hình của AkaBot Studio, thư mục log số 1 "C:\Users\PC Username\AppData\Local\akabot\Logs" sẽ được mở ra ngay lập tức.

3. Các loại nhật ký (Types of Logs)
Đối với thư mục số 1 "C:\Users\PC Username\AppData\Local\akabot\Logs": Đây là nơi lưu trữ các tệp nhật ký chính được xuất ra từ AkaBot Studio hoặc Agent, và chúng sẽ được lưu tự động.

Ví dụ các tệp nhật ký:

• yyyy-MM-dd_BotService.log

• yyyy-MM-dd_Studio.log

• yyyy-MM-dd_BotAgent.log

• yyyy-MM-dd_BotExecutor.log

• yyyy-MM-dd_HHmmss_Studio_[WorkflowName].[count].log

• yyyy-MM-dd_HHmmss_Agent_[WorkflowName].[count].log

Một số tệp nhật ký có thể không được tạo tùy thuộc vào trạng thái thực thi.
* Thời điểm ghi nhật ký cũng sẽ khác nhau tùy loại nhật ký.

* Kích thước tối đa của mỗi tệp nhật ký khoảng 10MB. Khi vượt quá dung lượng này, các thông tin tiếp theo sẽ được ghi vào một tệp nhật ký mới.

Mỗi khi một tệp mới được tạo, phần “số thứ tự” (count) trong tên tệp sẽ tăng thêm 1.

Các loại nhật ký, cách đặt tên tệp và thời điểm ghi nhật ký có thể thay đổi tùy phiên bản AkaBot Studio/Agent.

Ví dụ với phiên bản 2.1.1.2:

• yyyy-MM-dd_Activation.log

• yyyy-MM-dd_BotService.log

• yyyy-MM-dd_Studio.log

• yyyy-MM-dd_BotAgent.log

• yyyy-MM-dd_BotExecutor.log

• yyyy-MM-dd_Studio_Execution.log.{count}

• yyyy-MM-dd_Execution.log.{count}

Đối với thư mục số 2 "C:\Users\PC Username\AppData\Local\AkaBot"

Trong thư mục này sẽ có tệp "settings.json" được tạo ra. Tệp này lưu trữ thông tin chi tiết, bao gồm cả cấu hình của Agent và sẽ được ghi khi robot được thực thi bởi Agent.

* Mặc dù đây không phải là tệp nhật ký, nhưng chúng vẫn cần thiết khi bạn muốn kiểm tra thông tin cấu hình, vì vậy chúng được liệt kê trong tài liệu này.

Đối với thư mục số 3 "C:\ProgramData\AkaBot\Logs": Các tệp nhật ký tại đây tương tự với thư mục số 1 "C:\Users\PC Username\AppData\Local\AkaBot\Logs", nhưng chứa nhiều thông tin hệ thống chi tiết hơn.

Ví dụ các tệp nhật ký:

• yyyy-mm-dd_InstallUtil.log

• yyyy-mm-dd_BotService.log

Một số tệp nhật ký có thể không được tạo, tùy vào trạng thái thực thi.

4. Gửi Nhật Ký (Sending Logs)

Khi bạn liên hệ bộ phận hỗ trợ vì gặp sự cố với AkaBot Studio/Agent, hãy cung cấp thông tin chi tiết về tình huống và toàn bộ các tệp nhật ký trong ngày sự cố xảy ra. Ngay cả khi các tệp nhật ký có dung lượng 0KB (trống), bạn vẫn nên gửi kèm theo.

Khi gửi, tốt nhất nên sắp xếp lại các thư mục để cho thấy rõ mỗi tệp nhật ký nằm ở thư mục nào, sau đó nén chúng thành một tệp ZIP trước khi gửi.

Ví dụ cấu trúc thư mục trong tệp ZIP nếu sự cố xảy ra vào ngày 01/07/2022:

Logs

 ┗UserFolder_AkaBotlogs

  ┗2022-07-01_Activation.log

  ┗2022-07-01_BotService.log

   ・

   ・

   ・

 ┗UserFolder_AkaBot

  ┗settings.json

 ┗ProgramFolder_AkaBotlogs

  ┗2022-07-01_InstallUtil.log

  ┗2022-07-01_BotService.log

   ・

   ・

   ・