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.
Chuyển đến tài liệu về Apigee X. thông tin

Luân chuyển nhật ký (log rotation) – quy trình luân chuyển nhiều tệp nhật ký đang sử dụng và không 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 xoay nhật ký cho phép tự động xoay, nén, xoá và gửi tệp nhật ký.

Trong Edge for Private Cloud, 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 Trình xử lý thông báo, các tệp sau được định cấu hình bằng cơ chế xoay mặc định bằ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 tệp tương tự tồn tại cho các thành phần edge-* khác (có 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 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 thành phần Trình xử lý thông báo, tệp này được gọi 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 do thư viện logback thực hiện mà là do logrotate và crontab thực hiện.

Trước khi bắt đầu

• Nếu bạn chưa quen với cấu hình logrotate, hãy đọc hướng dẫn về logrotate.
• Nếu bạn chưa quen với 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 for Private Cloud phiên bản 4.50.00 và 4.51.00.

Xoay nhật ký là một cơ chế được thiết kế để dễ dàng quản trị các hệ thống tạo ra một lượng lớn tệp nhật ký. Tính năng này cho phép tự động xoay, nén, xoá và gửi tệp nhật ký.

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 Trình xử lý thông báo, 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ụ: tính năng xoay vòng nhật ký không được định cấu hình theo mặc định trên tệp Trình xử lý thông báo của thành phần apigee 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 khác nhau 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 logrotate và crontab.

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

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 Trình xử lý thông báo Edge.

Các bước sau đây mô tả cách bật tính năng xoay 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 của Trình xử lý thông báo trong 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 các 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 công việc cron 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 việc xoay vòng nhật ký trong lần chạy tiếp theo của công việc cron.

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

1. Sau khi công việc cron theo lịch chạy, tệp nhật ký sẽ được xoay vòng. Từ ví dụ trên, công việc cron được lên lịch chạy mỗi ngày lúc 00:00 để xoay vòng 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 của 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

   Kết quả trên cho biết các tệp edge-message-processor.log được xoay 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 đúng tất cả các bướ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. Nếu bạn bỏ lỡ bất kỳ 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ể xoay vòng nhật ký, hãy liên hệ với Nhóm hỗ trợ Apigee Edge.