Bật tính năng xoay nhật ký cho edge-message-processor.log

Bạn đang xem tài liệu về Apigee Edge.
Truy cập vào tài liệu Apigee X. thông tin

Quay vòng nhật ký – quy trình quay vòng nhiều tệp nhật ký trong và ngoài quá trình sử dụng – giúp đơn giản hoá việc quản trị các hệ thống tạo ra số lượng lớn tệp nhật ký. Tính năng quay vòng nhật ký cho phép tự động xoay, nén, xoá và gửi tệp nhật ký qua thư.

Trong Edge cho Đám mây riêng tư, một số tệp nhật ký chính trên mỗi thành phần apigee được định cấu hình bằng cơ chế xoay mặc định. Ví dụ: trên thành phần Message Processor, các tệp sau được định cấu hình bằng cơ chế xoay mặc định bằng cách sử dụng logback:

• /opt/apigee/var/log/edge-message-processor/logs/system.log
• /opt/apigee/var/log/edge-message-processor/logs/events.log
• /opt/apigee/var/log/edge-message-processor/logs/startupruntimeerrors.log
• /opt/apigee/var/log/edge-message-processor/logs/configurations.log
• /opt/apigee/var/log/edge-message-processor/logs/transactions.log

Các thành phần edge-* khác cũng có các tệp tương tự (tên bắt đầu bằng edge-), chẳng hạn như edge-management-server, edge-router, edge-postgres-server và edge-qpid-server.

Mỗi thành phần edge-* này cũng tạo ra một tệp nhật ký bổ sung là đầu ra được chuyển hướng của bảng điều khiển của thành phần tương ứng. Trong trường hợp của thành phần Message Processor, tệp này có tên là /opt/apigee/var/log/edge-message-processor/edge-message-processor.log. Các thành phần edge-* khác sẽ tạo một tệp tương tự. Việc xoay các tệp này không được thực hiện bằng thư viện logback mà bằng cách sử dụng logrotate và crontab.

Trước khi bắt đầu

• Nếu bạn chưa quen với các cấu hình logrotate, hãy đọc hướng dẫn về logrotate.
• Nếu bạn chưa hiểu rõ về cấu hình crontab, hãy đọc hướng dẫn về crontab.

Bật tính năng xoay nhật ký

Phần này áp dụng cho Edge cho Đám mây riêng tư phiên bản 4.50.00 và 4.51.00.

Quay vòng nhật ký là một cơ chế được thiết kế để giúp quản trị các hệ thống tạo ra số lượng lớn tệp nhật ký. Công cụ này cho phép tự động xoay, nén, xoá và gửi tệp nhật ký qua email.

Theo mặc định, một số tệp nhật ký chính trên mỗi thành phần apigee được định cấu hình bằng cơ chế xoay mặc định. Ví dụ: trên thành phần Message Processor, các tệp sau được định cấu hình bằng cơ chế xoay mặc định:

• /opt/apigee/var/log/edge-message-processor/logs/system.log
• /opt/apigee/var/log/edge-message-processor/logs/events.log
• /opt/apigee/var/log/edge-message-processor/logs/startupruntimeerrors.log
• /opt/apigee/var/log/edge-message-processor/logs/configurations.log
• /opt/apigee/var/log/edge-message-processor/logs/transactions.log

Tuy nhiên, các tệp nhật ký khác trong thành phần apigee không được định cấu hình với chế độ xoay mặc định. Ví dụ: theo mặc định, tính năng xoay vòng nhật ký không được định cấu hình trên tệp apigee Message Processor (Bộ xử lý thông báo) của thành phần edge-message-processor.log.

Bạn có thể bật tính năng xoay vòng nhật ký bằng nhiều tiện ích/khung như logrotate, logback hoặc log4j. Phần này giải thích cách định cấu hình tính năng xoay nhật ký cho tệp /opt/apigee/var/log/edge-message-processor/edge-message-processor.log bằng cách sử dụng logrotate và crontab.

Bật tính năng quay vòng nhật ký cho edge-message-processor.log trên Trình xử lý thông báo

Phần này giải thích cách bật tính năng xoay vòng nhật ký cho nhật ký /opt/apigee/var/log/edge-message- processor/edge-message-processor.log trên Bộ xử lý thông báo Edge.

Các bước sau đây mô tả cách bật tính năng quay vòng nhật ký cho tệp edge-message-processor.log:

1. Mở tệp /opt/apigee/edge-message-processor/logrotate/logrotate.conf trên máy Message Processor bằng một trình chỉnh sửa. Nếu tệp không tồn tại, hãy tạo tệp. Ví dụ:

   vi /opt/apigee/edge-message-processor/logrotate/logrotate.conf
   

2. Thêm một đoạn mã vào tệp tương tự như đoạn mã dưới đây:

   /opt/apigee/var/log/edge-message-processor/edge-message-processor.log {
       missingok
       copytruncate
       rotate 5
       size 10M
       compress
       delaycompress
       notifempty
       nocreate
       sharedscripts
       }

3. Lưu thay đổi.
4. Mở crontab của người dùng apigee bằng lệnh sau:

   sudo crontab -u apigee -e
   

5. Thêm dịch vụ chạy ngầm theo thời gian định trước sau vào crontab của người dùng apigee :

   0 0 * * * nice -n 19 ionice -c3 /usr/sbin/logrotate -s /opt/apigee/var/run/edge-message-processor/logrotate.status -f /opt/apigee/edge-message-processor/logrotate/logrotate.conf

6. Lưu crontab và theo dõi quá trình xoay vòng nhật ký trong lần chạy tiếp theo của lệnh cron.

Xác minh tính năng quay vòng nhật ký cho edge-message-processor.log trên Trình xử lý thông báo

1. Sau khi dịch vụ chạy ngầm theo thời gian định trước theo lịch chạy, tệp nhật ký sẽ được xoay vòng. Theo ví dụ trên, dịch vụ chạy ngầm theo thời gian định trước được lên lịch chạy hằng ngày vào lúc 00:00 sáng để xoay tệp edge-message- processor.log.

2. Chuyển đến thư mục /opt/apigee/var/log/edge-message-processor/ và xác minh rằng tệp edge-message-processor.log đã được xoay.

   Danh sách mẫu về tệp nhật ký

   ls -ltrh | grep 'edge-message-processor'
   

   -rw-r--r--. 1 apigee apigee  17K Feb  7 00:00 edge-message-processor.log.1.gz
   -rw-r--r--. 1 apigee apigee 5.3K Feb  7 09:12 edge-message-processor.log

   Đầu ra ở trên cho biết các tệp edge-message-processor.log được xoay vòng và lưu dưới dạng tệp GZ.

3. Nếu bạn không thấy các tệp edge-message-processor.log đang được xoay vòng, hãy xác minh rằng bạn đã làm theo tất cả các bước được nêu trong phần Bật tính năng xoay vòng nhật ký cho edge-message-processor.log trên Trình xử lý thông báo một cách chính xác. Nếu bạn bỏ lỡ bước nào, hãy lặp lại tất cả các bước một cách chính xác.
4. Nếu bạn vẫn không thể quay vòng nhật ký, hãy liên hệ với Nhóm hỗ trợ Apigee Edge.