#Khai thác Classic UI để debug trên AEM hiện đại

Touch UI là giao diện chính thức, nhưng nhiều console Classic UI trong AEM 6.5 vẫn tồn tại và cho thông tin debug sâu hơn, nhanh hơn. Tiêu biểu là Workflow console và việc trace lịch sử publish của page. Note này liệt kê path, cách dùng, và mẹo khai thác cho công việc RCA.

Classic UI bị deprecated nhưng chưa bị gỡ trong 6.5. Dùng như công cụ debug nội bộ, không dùng cho author hàng ngày và không dựa vào nó cho giải pháp lâu dài.

#Vì sao Classic UI vẫn hữu ích

#Bản đồ path Classic UI

Gõ thẳng URL trên author. Nhiều path redirect tới JSP/console cũ vẫn hoạt động.

#Workflow console

Path: /libs/cq/workflow/content/console.html. Đây là nơi mạnh nhất để debug workflow.

#Trace một instance

Mở tab Instances hoặc Archive, click vào một instance để xem:

• History trace: từng step đã chạy, thời điểm, người/được giao.
• Payload: path nội dung mà workflow xử lý.
• Trạng thái hiện tại và step kế tiếp.

Vị trí lưu trong JCR khi cần soi sâu bằng CRXDE:

#Failures: xử lý workflow lỗi

Tab Failures cho phép thao tác hàng loạt khi job workflow chết.

• Step Retry: chạy lại step lỗi sau khi đã sửa nguyên nhân.
• Terminate: kết thúc instance treo không cứu được.
• Đọc cột error để lấy thông điệp lỗi, đối chiếu với error.log.

SAI: thay workflow treo thi xoa node /var/workflow/instances bang tay
  -> de lai trang thai khong nhat quan, mat lich su

DUNG: dung tab Failures de Terminate hoac Retry
  -> AEM don dep dung quy trinh, giu audit

#Trace lịch sử publish của page

Đây là tình huống Classic UI vượt trội: trả lời câu hỏi "page này được publish lúc nào, bởi ai, có lỗi replication không".

#Replication agent log

Path: /etc/replication/agents.author.html, click vào agent (thường là Default Agent), chọn tab Log hoặc View Queue.

Đọc log để biết một path cụ thể đã được gửi sang publish hay chưa, và phản hồi HTTP từ publish.

#RCA "page không lên publish"

Thứ tự kiểm tra trong Classic UI:

1. /etc/replication/agents.author.html
   -> Queue co bi blocked khong? Item dau queue loi gi?
2. Test Connection toi publish
   -> Loi auth/network thi ca queue dung
3. Doc Log cua agent
   -> Path co duoc gui khong, publish tra ve gi
4. Neu queue OK ma van thieu: kiem tra dispatcher cache (note Caching Layers)

SAI: page cu thi flush dispatcher ngay
  -> neu loi nam o replication queue, flush vo nghia

DUNG: xac nhan agent author da gui thanh cong truoc
  -> roi moi xet dispatcher va CDN

#Audit log

AEM ghi sự kiện page (tạo, sửa, activate, deactivate) vào audit. Soi bằng CRXDE:

Trong node audit có user, timestamp, loại event. Đây là nguồn để trả lời "ai deactivate page lúc nào".

#Version history và restore

Classic siteadmin cho xem và restore version nhanh. Trong Touch UI là Timeline, nhưng thao tác Classic đôi khi gọn hơn khi cần so sánh nhiều version.

Khi RCA "nội dung bị mất", version storage là nơi khôi phục. Đối chiếu timestamp version với audit log để biết thay đổi nào gây mất nội dung.

#Companion: CRXDE Lite và Felix

Hai công cụ không phải Classic UI nhưng luôn đi kèm khi debug.

#Tips khai thác cho AEM hiện đại

• Dùng Classic UI như dao mổ debug, không phải giao diện làm việc. Author thật vẫn dùng Touch UI.
• Trace publish luôn bắt đầu từ replication agent log trước khi nghi ngờ cache. Sai thứ tự RCA là mất thời gian.
• Kết hợp ba nguồn để dựng lại dòng thời gian một page: audit log (ai làm gì), version storage (nội dung từng lúc), agent log (đã publish hay chưa).
• Lưu sẵn bookmark các console. Trong incident, tốc độ truy cập quyết định.
• Classic UI deprecated: kiểm tra lại sau mỗi service pack xem path còn hoạt động, đừng xây tool nội bộ phụ thuộc vào nó.

#Liên quan

• Các lớp cache và RCA stale content: note Caching Layers.
• Cache API qua Cloudflare: note Cloudflare API Cache.