Lỗi Binlog Database

Lỗi Database Connection do Binlog MariaDB trong EasyEngine

Tôi không rõ lý do vì sao nhóm phát triển EasyEngine cấu hình Global MariaDB theo cách hiện tại, nhưng có một lỗi mà rất nhiều người gặp phải khi triển khai EasyEngine. Do nó vốn dĩ dễ dàng như tên gọi, người dùng thường nhanh chóng triển khai nhưng sau đó lại gặp tình trạng server không thể hoạt động.

Biểu hiện phổ biến là website hiển thị lỗi 'Error establishing a database connection', trong khi container database liên tục khởi động lại.

Kinh nghiệm với LEMP stack truyền thống cũng khó giúp bạn khắc phục sự cố này. Lỗi này phổ biến đến mức nó trở thành một trong những nguyên nhân chính làm lu mờ nỗ lực và sự xuất sắc của EasyEngine 4.

Binlog MariaDB

Binary Log (Binlog) của MariaDB

MariaDB có một cơ chế ghi log hiện đại gọi là Binary Log (Binlog), giúp ghi nhận mọi thay đổi đối với dữ liệu, ngoại trừ các truy vấn chỉ đọc như SELECT. Binlog chủ yếu được sử dụng cho:

Replication: Đồng bộ dữ liệu giữa master và slave trong mô hình master-slave replication.
Khôi phục dữ liệu: Hỗ trợ phục hồi dữ liệu bằng cách phát lại các giao dịch từ binlog sau khi khôi phục từ backup.
Theo dõi thay đổi: Ghi lại lịch sử thay đổi dữ liệu để phân tích hoặc kiểm tra bảo mật.

Binlog Chiếm Hết Dung Lượng Ổ Cứng

Binlog bao gồm nhiều tệp nhị phân (.000001, .000002,…) và một tệp index (.index) lưu danh sách các file binlog. Các file này được lưu tại thư mục:

/var/lib/docker/volumes/global-db_db_logs/_data

Cấu hình mặc định của EasyEngine tạo các file binlog có kích thước gần 100MB. Theo thời gian, binlog chiếm một dung lượng lớn, và trong nhiều trường hợp, nó làm đầy ổ cứng, khiến container database liên tục khởi động lại.

Xóa Các File Binlog Để Giải Phóng Bộ Nhớ

Không thể xóa binlog thủ công vì điều này sẽ khiến MariaDB không hoạt động. Thay vào đó, chúng ta phải xóa bằng các lệnh SQL. Vì EasyEngine lưu database trong global services, chúng ta cần thực hiện các lệnh này trong container database.

1. Truy cập vào container MariaDB

EasyEngine lưu mật khẩu root của MariaDB trong biến MYSQL_ROOT_PASSWORD, ta có thể đăng nhập vào container bằng lệnh:

cd /opt/easyengine/services && docker-compose exec global-db bash -c 'mysql -uroot -p${MYSQL_ROOT_PASSWORD}'

2. Xóa các file binlog cũ bằng SQL

-- Xem danh sách các file binlog
SHOW BINARY LOGS;  

-- Xác định file binlog hiện tại (file này không được xóa)
SHOW MASTER STATUS;  

-- Xóa các file binlog cũ hơn `mariadb-bin.000200` để giải phóng dung lượng
PURGE BINARY LOGS TO 'mariadb-bin.000200';

Cấu Hình Lại MariaDB Trong EasyEngine Để Tránh Lặp Lại Lỗi

Để ngăn binlog tiếp tục chiếm đầy ổ cứng, chúng ta cần điều chỉnh cấu hình MariaDB của EasyEngine.

1. Chỉnh sửa file cấu hình MariaDB

Mở file cấu hình:

nano /var/lib/docker/volumes/global-db_db_conf/_data/conf.d/ee.cnf

2. Vô hiệu hóa binlog hoặc giới hạn thời gian lưu trữ

Thêm dấu # trước các dòng liên quan đến log_bin và sync_binlog. Đồng thời, đặt expire_logs_days = 1 để tự động xóa binlog sau 1 ngày:

[mysqld]
# log_bin                 = /var/log/mysql/mariadb-bin
log_bin_index           = /var/log/mysql/mariadb-bin.index
binlog_format           = statement
# Không tốt cho hiệu suất, nhưng an toàn hơn
# sync_binlog            = 1
expire_logs_days        = 1
max_binlog_size         = 100M

Sau khi chỉnh sửa, khởi động lại dịch vụ MariaDB để áp dụng thay đổi:

docker-compose restart global-db

Tham Khảo

Không chế các file log không phình ra vô hạn với logrotate

Ngoài binlog của MaridaDB, cac file log nginx và php của website, nginx-prooxy cũng có thể có kích thước lớn lên theo thời gian, đặc biệt là các site có nhiều truy cập hoặc sile có lỗi truy cập. Trong trường hợp này, logrotate là chương trình được khuyến nghị sử dụng.

1. Logrotate là gì?

Logrotate là công cụ quản lý tệp log, giúp luân chuyển (rotate), nén, và xóa các tệp log cũ để tránh chiếm quá nhiều dung lượng.

2. Cách hoạt động cơ bản

Chạy định kỳ: Logrotate thường được lên lịch chạy hàng ngày qua cron (/etc/cron.daily/logrotate).
Dựa trên cấu hình: Đọc các tệp cấu hình trong /etc/logrotate.conf và /etc/logrotate.d/ để biết cách xử lý từng loại log.
Quy trình:
1. Kiểm tra điều kiện luân chuyển (thời gian, kích thước, v.v.).
2. Đổi tên tệp log hiện hành (ví dụ: access.log → access.log.1).
3. Tạo tệp log mới (nếu có tùy chọn create).
4. Nén tệp cũ (nếu bật compress).
5. Xóa tệp quá cũ (dựa trên rotate).
6. Chạy script bổ sung (nếu có postrotate).

3. Cấu hình logrotate cho EasyEngine

Với nginx-proxy log:

nano /etc/logrotate.d/ee-nginx-proxy-log

~/etc/logrotate.d/ee-nginx-proxy-log

/opt/easyengine/services/nginx-proxy/logs/*.log {
    weekly
    missingok
    copytruncate
    rotate 12
    compress
    delaycompress
    notifempty
    create 0640 www-data adm
    sharedscripts
}

Với các log website trên EasyEngine:

nano /etc/logrotate.d/ee-sites-log

Nội dung file:

~/etc/logrotate.d/ee-sites-log

var/lib/docker/volumes/*log_php/_data/*.log                                                                                                                          >
/var/lib/docker/volumes/*log_nginx/_data/*.log {
        weekly
        missingok
        rotate 12
        compress
        delaycompress
        notifempty
        sharedscripts
        postrotate
            for site in $(/usr/local/bin/ee site list --format=text --enabled); do
                absolute_site_php=$(echo $site | sed -e 's/\.//g' )-php-1
                absolute_site_nginx=$(echo $site | sed -e 's/\.//g' )-nginx-1
                $(docker inspect -f '{{ .State.Pid }}' $absolute_site_nginx | xargs kill -USR1) || echo "ok"
                $(docker inspect -f '{{ .State.Pid }}' $absolute_site_php | xargs kill -USR1) || echo "ok"
                echo "$(date +'[%d/%m/%Y %H:%M:%S]') LogRotate.INFO: Rotated logs for $site" >> /opt/easyengine/logs/ee.log
            done
        endscript
}

Mẫu log: /var/lib/docker/volumes/*log_nginx/_data/*.log – áp dụng cho tất cả tệp .log của tất cả các sites trong EasyEngine.
Tùy chọn:
- daily, weekly, monthly: Tần suất xoay.
- rotate <số>: Số bản cũ giữ lại.
- compress: Nén tệp cũ (thường thành .gz).
- create <quyền> <user> <group>: Tạo tệp log mới.
- postrotate: Thông báo dịch vụ (như Nginx) reload log.

4. Quy trình thực tế

Giả sử có access.log:
1. Logrotate đổi tên: access.log → access.log.1.
2. Tạo access.log mới (nếu có create).
3. Nếu access.log.1 đã tồn tại, nó thành access.log.2, và cứ thế.
4. Nén access.log.2 thành access.log.2.gz (nếu bật compress).
5. Xóa tệp vượt quá rotate (ví dụ: access.log.8 nếu rotate 7).

5. Lệnh hữu ích

Chạy thủ công: logrotate /etc/logrotate.conf
Ép buộc chạy: logrotate -f /etc/logrotate.d/ee-sites-log
Xem mô phỏng: logrotate -d /etc/logrotate.d/ee-sites-log (debug mode).
Kiểm tra trạng thái: Xem /var/lib/logrotate/status.

Lần cuối cập nhật lúc tháng 4 25, 2025

Triển khai với Wordpress SSL, Redirects