Xử lý sự cố thường gặp

Tài liệu này mô tả các sự cố thường gặp trong vận hành hệ thống Traffic Tools V2, cách nhận biết và cách xử lý. Viết cho người vận hành — không cần biết code, chỉ cần biết làm gì khi có vấn đề.

Nhóm 1 — Sự cố Traffic giảm hoặc dừng

Traffic giảm đột ngột trong một giờ cụ thể

Nhận biết: Trong màn hình Thống kê hàng ngày, một hoặc nhiều giờ có traffic thấp bất thường so với các giờ xung quanh.

Nguyên nhân thường gặp và cách xử lý:

Server worker gặp sự cố trong giờ đó — Vào Tìm kiếm tự động → Server Performance, xem biểu đồ của giờ bị thiếu. Nếu server nào đó có số task xử lý bằng 0 trong giờ đó, server đó đã offline. Kiểm tra trạng thái server trong Quản lý Server. Nếu server offline, SSH vào server và khởi động lại Tools V2.

Proxy pool bị chặn hàng loạt — Nếu tỷ lệ thất bại tăng cao trong giờ đó, proxy đang bị chặn. Vào Quản lý Proxy, nhấn "Update Proxy" để kéo proxy mới. Xóa các proxy có tỷ lệ lỗi cao.

Múi giờ server bị cấu hình sai — Nếu traffic luôn bị thiếu vào cùng một khung giờ mỗi ngày (ví dụ: luôn thấp từ 0h-7h), kiểm tra múi giờ trên máy chủ API. Server đang dùng UTC+0 thay vì UTC+7 sẽ khiến giờ cao điểm lệch 7 tiếng.

Traffic dừng hoàn toàn

Nhận biết: Thống kê hàng ngày không có traffic từ một thời điểm nào đó đến hiện tại.

Kiểm tra theo thứ tự:

Kiểm tra server worker — Vào Quản lý Server, xem tất cả server có đang online không. Nếu tất cả offline, cần SSH vào từng server và khởi động lại.

Kiểm tra chiến dịch — Vào Thống kê hệ thống, kiểm tra các project có đang ở trạng thái "Hoạt động" không. Nếu tất cả project đã "Đã chết" (hết ngân sách), cần tạo chiến dịch mới.

Kiểm tra proxy — Vào Quản lý Proxy, kiểm tra số proxy đang hoạt động. Nếu không có proxy nào, hệ thống không thể thực thi task. Kéo proxy mới từ nhà cung cấp.

Kiểm tra profile — Vào Quản lý tài khoản Google, kiểm tra số profile đang hoạt động (không trong cooldown). Nếu tất cả profile đang trong cooldown hoặc bị vô hiệu hóa, hệ thống không có profile để dùng.

Kiểm tra kết nối API — Nếu Go API Backend gặp sự cố, Worker không nhận được task. Kiểm tra trạng thái API server.

Một chiến dịch cụ thể không chạy

Nhận biết: Các chiến dịch khác đang chạy bình thường nhưng một chiến dịch cụ thể không có traffic.

Kiểm tra:

Project có đang ở trạng thái "Hoạt động" không? Nếu "Không hoạt động", bật lại.

Project có đã "Đã chết" (hết ngân sách) không? Nếu vậy, tạo project mới với ngân sách mới.

Từ khóa có còn liên quan đến domain không? Nếu domain không còn xuất hiện trong kết quả tìm kiếm cho từ khóa đó, task sẽ liên tục thất bại với lý do "Không tìm thấy". Cần cập nhật từ khóa.

Khung giờ hoạt động có đúng không? Nếu project chỉ chạy từ 8h-22h mà hiện tại là 23h, đây là hành vi bình thường.

Nhóm 2 — Sự cố Proxy

Tỷ lệ CAPTCHA tăng cao

Nhận biết: Trong Server Performance, cột "Captcha" tăng cao bất thường. Tỷ lệ thành công giảm tương ứng.

Ý nghĩa: Google đang nghi ngờ các IP trong pool proxy. Khi nhiều request từ cùng một IP hoặc nhóm IP có hành vi bất thường, Google tăng cường kiểm tra bằng CAPTCHA.

Xử lý:

Vào Quản lý Proxy, xóa các proxy có tỷ lệ lỗi cao hoặc đã dùng quá nhiều lần.

Nhấn "Update Proxy" để kéo proxy mới từ nhà cung cấp.

Nếu tỷ lệ CAPTCHA vẫn cao sau khi thay proxy, có thể vấn đề nằm ở profile — xem phần xử lý sự cố profile.

Kiểm tra cấu hình Anti-Captcha API — nếu API key hết credit, hệ thống không giải được CAPTCHA và tất cả task gặp CAPTCHA sẽ thất bại.

Proxy bị lock sau server crash

Nhận biết: Sau khi server khởi động lại, một số proxy có trạng thái "đang xoay" nhưng không tiến triển.

Nguyên nhân: Server crash giữa quá trình xoay IP, proxy bị đánh dấu "đang xoay" nhưng không bao giờ hoàn thành.

Xử lý: Vào Quản lý Proxy, tìm proxy có trạng thái "đang xoay" quá 10 phút. Reset thủ công proxy đó. Hệ thống sẽ thử xoay lại từ đầu.

Proxy hết hạn hàng loạt

Nhận biết: Số proxy hoạt động giảm đột ngột. Vào Quản lý Gói Proxy, thấy một hoặc nhiều gói đã hết hạn.

Xử lý:

Gia hạn gói proxy với nhà cung cấp.

Sau khi gia hạn, nhấn "Update Proxy" để kéo danh sách IP mới.

Xóa các proxy cũ đã hết hạn.

Phòng ngừa: Kiểm tra ngày hết hạn của các gói proxy mỗi tuần. Gia hạn trước ít nhất 3 ngày để tránh gián đoạn.

Nhà cung cấp proxy không phản hồi

Nhận biết: Nhấn "Update Proxy" nhưng không kéo được proxy mới. Log báo lỗi kết nối đến API nhà cung cấp.

Xử lý:

Kiểm tra trạng thái dịch vụ của nhà cung cấp (thường có trang status riêng).

Kiểm tra API key của nhà cung cấp trong cấu hình — có thể key đã hết hạn hoặc bị thu hồi.

Tạm thời dùng proxy từ nhà cung cấp khác trong khi chờ nhà cung cấp chính phục hồi.

Nếu vấn đề kéo dài, liên hệ nhà cung cấp để được hỗ trợ.

Nhóm 3 — Sự cố Google Profile

Nhiều profile bị vô hiệu hóa cùng lúc

Nhận biết: Vào Quản lý tài khoản Google, thấy nhiều profile chuyển sang trạng thái "Bị cấm" hoặc "Không hoạt động" trong cùng một khoảng thời gian.

Nguyên nhân thường gặp:

Google tăng cường kiểm tra — Khi Google phát hiện hành vi bất thường từ nhiều tài khoản, họ có thể khóa hàng loạt. Thường xảy ra sau khi hệ thống chạy quá nhiều task trong thời gian ngắn.

Tài khoản Google yêu cầu xác minh — Google yêu cầu xác minh số điện thoại hoặc email khôi phục. Worker không thể tự xác minh, nên đăng nhập thất bại 3 lần và profile bị vô hiệu hóa.

Mật khẩu bị thay đổi — Nếu ai đó đổi mật khẩu tài khoản Google, profile sẽ không đăng nhập được.

Xử lý:

Thêm profile mới để bù đắp số profile bị mất.

Kiểm tra xem có thể khôi phục tài khoản bị khóa không (đăng nhập thủ công, xác minh danh tính).

Giảm tốc độ thực thi task tạm thời để tránh kích hoạt thêm cơ chế bảo vệ của Google.

Profile không đủ — hệ thống thiếu profile khả dụng

Nhận biết: Log báo "không đủ profile khả dụng". Tỷ lệ thành công thấp dù proxy đang tốt.

Nguyên nhân: Pool profile quá nhỏ so với số task đồng thời. Khi tất cả profile đang trong cooldown, Worker không có profile để dùng và task phải chờ.

Xử lý:

Thêm nhiều profile hơn — đây là giải pháp đúng đắn nhất.

Không nên reset cooldown liên tục — cooldown tồn tại để bảo vệ tài khoản.

Tính toán số profile cần thiết: số task đồng thời × 3-5 = số profile tối thiểu.

App Password không hoạt động

Nhận biết: Profile dùng cho báo cáo email liên tục thất bại với lỗi xác thực SMTP.

Nguyên nhân:

App Password bị thu hồi khi tắt xác thực 2 bước

Tài khoản Google đổi mật khẩu (App Password cũng bị thu hồi)

App Password nhập sai (có khoảng trắng thừa)

Xử lý:

Đăng nhập vào tài khoản Google, vào Security → App passwords.

Xóa App Password cũ và tạo App Password mới.

Cập nhật App Password mới vào profile trong hệ thống.

Đảm bảo xác thực 2 bước vẫn đang bật.

Nhóm 4 — Sự cố Server Worker

Server worker offline

Nhận biết: Trong Quản lý Server, server hiển thị trạng thái offline. Telegram gửi thông báo "Server X offline".

Xử lý:

SSH vào server worker.

Kiểm tra xem process Tools V2 có đang chạy không: docker ps hoặc pm2 list.

Nếu process đã dừng, khởi động lại: docker compose up -d hoặc pm2 restart tools-v2.

Kiểm tra log để tìm nguyên nhân crash: docker logs tools-v2 hoặc xem log qua endpoint /logs.

Sau khi khởi động lại, server tự động đăng ký lại với Go API và bắt đầu nhận task.

Nguyên nhân crash thường gặp:

Hết RAM — Chrome tiêu thụ nhiều RAM, nếu server hết RAM, process bị kill. Giảm BROWSER_LIMIT_PER_PROCESS hoặc nâng cấp RAM server.

Lỗi MongoDB — Mất kết nối đến MongoDB. Kiểm tra MongoDB có đang chạy không.

Lỗi disk đầy — Log và screenshot tích lũy theo thời gian. Dọn dẹp định kỳ.

Server worker chạy nhưng không xử lý task

Nhận biết: Server online nhưng số task xử lý bằng 0 trong Server Performance.

Kiểm tra:

Gọi endpoint GET / của server worker để xem trạng thái: task.totalProcessRunning có bằng 0 không?

Nếu task.totalProcessRunning = 0 và task.maxProcess > 0, server đang không nhận được task từ Go API.

Kiểm tra kết nối từ server worker đến Go API — có thể firewall chặn kết nối.

Kiểm tra API_HOST trong cấu hình server worker có đúng không.

Kiểm tra API_KEY có khớp với cấu hình Go API không.

Server worker hết RAM

Nhận biết: Server crash liên tục, log báo "out of memory". Mỗi lần khởi động lại được một lúc rồi lại crash.

Xử lý:

Giảm BROWSER_LIMIT_PER_PROCESS trong cấu hình — mỗi Chrome instance tiêu thụ khoảng 300MB RAM.

Tính toán lại: RAM server - 2GB (cho hệ điều hành) = RAM khả dụng. RAM khả dụng / 300MB = số Chrome tối đa.

Ví dụ: Server 8GB RAM → (8GB - 2GB) / 300MB ≈ 20 Chrome instances tối đa.

Nếu cần chạy nhiều task hơn, nâng cấp RAM hoặc thêm server mới.

Disk đầy

Nhận biết: Server crash với lỗi "no space left on device". Log không được ghi thêm.

Xử lý:

SSH vào server, kiểm tra dung lượng: df -h.

Thư mục log thường chiếm nhiều nhất: storage/log/. Xóa log cũ hơn 30 ngày.

Thư mục screenshot cũng có thể lớn: storage/screenshots/. Xóa screenshot cũ.

Thư mục Chrome user profiles: tmp/user-data/. Có thể xóa an toàn khi server đang dừng.

Thiết lập log rotation tự động để tránh tái diễn.

Nhóm 5 — Sự cố Báo cáo bảo mật

Tỷ lệ báo cáo thất bại cao

Nhận biết: Trong Trung tâm Báo cáo → Tab Thống kê, tỷ lệ thất bại cao bất thường.

Nguyên nhân và xử lý:

Nền tảng thay đổi giao diện — Một số nền tảng thỉnh thoảng cập nhật form báo cáo. Worker không tìm thấy đúng element để điền. Cần cập nhật cấu hình của nền tảng đó.

CAPTCHA không giải được — Anti-Captcha API hết credit hoặc gặp sự cố. Kiểm tra số dư Anti-Captcha API. Nạp thêm credit nếu cần.

Proxy bị chặn bởi nền tảng — Một số nền tảng chặn IP datacenter. Cần dùng residential proxy cho báo cáo.

AI prompt không phù hợp — Nội dung báo cáo do AI tạo ra không đáp ứng yêu cầu của nền tảng. Vào Tab Trang Báo Cáo, cập nhật AI prompt cho nền tảng đó.

Báo cáo thất bại cho một nền tảng cụ thể

Nhận biết: Một nền tảng cụ thể liên tục thất bại trong khi các nền tảng khác bình thường.

Xử lý:

Vào Tab Trang Báo Cáo, tắt nền tảng đó tạm thời để không ảnh hưởng đến các nền tảng khác.

Xem ảnh bằng chứng của các lần thất bại gần nhất để hiểu lỗi xảy ra ở bước nào.

Nếu nền tảng đã thay đổi giao diện, cần cập nhật cấu hình.

Dùng "Bắn lại báo cáo thất bại" để thử lại sau khi đã sửa cấu hình.

Không có ảnh bằng chứng

Nhận biết: Báo cáo được đánh dấu thành công nhưng không có ảnh bằng chứng.

Nguyên nhân: Lỗi upload ảnh lên DigitalOcean Spaces hoặc Cloudinary.

Xử lý:

Kiểm tra cấu hình DigitalOcean Spaces — API key, bucket name, region có đúng không.

Kiểm tra Cloudinary (backup) — cloud name, API key, API secret có đúng không.

Kiểm tra kết nối từ server worker đến các dịch vụ lưu trữ.

Nhóm 6 — Sự cố Thông báo

Không nhận được thông báo Telegram

Nhận biết: Hệ thống gặp sự cố nhưng không có thông báo Telegram.

Kiểm tra:

Bot Telegram có đang hoạt động không — thử gửi tin nhắn cho bot.

Chat ID có đúng không — mỗi kênh (chung, báo cáo, lỗi) có Chat ID riêng.

Bot có được thêm vào group/channel không.

Kiểm tra cấu hình Telegram trong Go API Backend.

Nhận quá nhiều thông báo

Nhận biết: Telegram bị spam thông báo, khó theo dõi thông báo quan trọng.

Xử lý:

Kiểm tra xem có sự cố đang lặp đi lặp lại không (ví dụ: server liên tục online/offline do kết nối không ổn định).

Giải quyết sự cố gốc rễ thay vì tắt thông báo.

Nếu thông báo quá nhiều do hệ thống đang hoạt động bình thường (ví dụ: báo cáo mỗi task), điều chỉnh ngưỡng thông báo trong cấu hình.

Bảng tóm tắt — Sự cố và hành động nhanh

Triệu chứng	Kiểm tra đầu tiên	Hành động
Traffic giảm đột ngột	Server Performance theo giờ	Kiểm tra server worker, proxy
Traffic dừng hoàn toàn	Trạng thái server, proxy, profile	Khởi động lại server, kéo proxy mới
CAPTCHA tăng cao	Tỷ lệ thành công theo server	Thay proxy mới, kiểm tra Anti-Captcha credit
Nhiều profile bị vô hiệu hóa	Log đăng nhập thất bại	Thêm profile mới, giảm tốc độ task
Server offline	Docker/PM2 process	Khởi động lại, kiểm tra RAM và disk
Báo cáo thất bại hàng loạt	Tab Thống kê báo cáo	Kiểm tra Anti-Captcha, proxy, AI prompt
Không có ảnh bằng chứng	Cấu hình cloud storage	Kiểm tra DigitalOcean/Cloudinary credentials
Không nhận Telegram	Bot token, Chat ID	Kiểm tra cấu hình Telegram
Proxy bị lock	Trạng thái proxy trong Quản lý Proxy	Reset thủ công proxy bị lock
Disk đầy	`df -h` trên server	Xóa log cũ, screenshot cũ

Xử lý sự cố thường gặp

Nhóm 1 — Sự cố Traffic giảm hoặc dừng#

Traffic giảm đột ngột trong một giờ cụ thể#

Traffic dừng hoàn toàn#

Một chiến dịch cụ thể không chạy#

Nhóm 2 — Sự cố Proxy#

Tỷ lệ CAPTCHA tăng cao#

Proxy bị lock sau server crash#

Proxy hết hạn hàng loạt#

Nhà cung cấp proxy không phản hồi#

Nhóm 3 — Sự cố Google Profile#

Nhiều profile bị vô hiệu hóa cùng lúc#

Profile không đủ — hệ thống thiếu profile khả dụng#

App Password không hoạt động#

Nhóm 4 — Sự cố Server Worker#

Server worker offline#

Server worker chạy nhưng không xử lý task#

Server worker hết RAM#

Disk đầy#

Nhóm 5 — Sự cố Báo cáo bảo mật#

Tỷ lệ báo cáo thất bại cao#

Báo cáo thất bại cho một nền tảng cụ thể#

Không có ảnh bằng chứng#

Nhóm 6 — Sự cố Thông báo#

Không nhận được thông báo Telegram#

Nhận quá nhiều thông báo#

Bảng tóm tắt — Sự cố và hành động nhanh#

Nhóm 1 — Sự cố Traffic giảm hoặc dừng

Traffic giảm đột ngột trong một giờ cụ thể

Traffic dừng hoàn toàn

Một chiến dịch cụ thể không chạy

Nhóm 2 — Sự cố Proxy

Tỷ lệ CAPTCHA tăng cao

Proxy bị lock sau server crash

Proxy hết hạn hàng loạt

Nhà cung cấp proxy không phản hồi

Nhóm 3 — Sự cố Google Profile

Nhiều profile bị vô hiệu hóa cùng lúc

Profile không đủ — hệ thống thiếu profile khả dụng

App Password không hoạt động

Nhóm 4 — Sự cố Server Worker

Server worker offline

Server worker chạy nhưng không xử lý task

Server worker hết RAM

Disk đầy

Nhóm 5 — Sự cố Báo cáo bảo mật

Tỷ lệ báo cáo thất bại cao

Báo cáo thất bại cho một nền tảng cụ thể

Không có ảnh bằng chứng

Nhóm 6 — Sự cố Thông báo

Không nhận được thông báo Telegram

Nhận quá nhiều thông báo

Bảng tóm tắt — Sự cố và hành động nhanh