Hướng dẫn nhật ký sự kiện ứng dụng

Nhật ký sự kiện ứng dụng giúp khắc phục sự cố khi tự động hóa hoặc xuất dữ liệu không hoạt động như mong đợi. Bạn có thể xuất nhật ký từ ứng dụng và chia sẻ với bộ phận hỗ trợ để điều tra.

Nhật ký hoạt động và nhật ký sự kiện ứng dụng

Nhật ký hoạt động là lịch sử chạy hướng tới người dùng cho một tự động hóa. Mở từ màn hình cấu hình tự động hóa (Xem nhật ký hoạt động). Chúng hiển thị các lần chạy theo nhóm thời gian, với sự kiện thông tin, cảnh báo và lỗi chỉ cho tự động hóa đó. Bạn xem trong ứng dụng; chúng được lưu theo từng tự động hóa.

Nhật ký sự kiện ứng dụng là nhật ký chẩn đoán kỹ thuật cho toàn bộ ứng dụng (tự động hóa, xuất thủ công, truy vấn HealthKit, tải lên và luồng liên quan). Chúng được lưu dạng JSONL và xuất dưới dạng ZIP cho hỗ trợ. Xuất nhật ký sự kiện ứng dụng không thay thế việc đọc nhật ký hoạt động trong ứng dụng — hãy dùng cả hai khi báo cáo sự cố.

Nhật ký sự kiện ứng dụng bao gồm gì

Nhật ký sự kiện ứng dụng gồm các sự kiện chẩn đoán do luồng ứng dụng tạo, chẳng hạn:

• Lần chạy tự động hóa
• Xuất thủ công
• Hoạt động máy chủ
• Lỗi xử lý và xác thực xuất dữ liệu
• Chẩn đoán truy vấn và tải lên HealthKit

ZIP đã xuất dùng để khắc phục sự cố. Có thể gồm dấu thời gian, tên sự kiện và ngữ cảnh chẩn đoán không phải dữ liệu sức khỏe. Gói cũng có thể gồm:

• manifest với siêu dữ liệu ứng dụng và môi trường
• Ảnh chụp automations đã chỉnh sửa (cấu hình không có thông tin đăng nhập hoặc bí mật)
• Trường cài đặt IAP gốc và grandfathering cho chẩn đoán hỗ trợ mua hàng

Nhật ký đã xuất không gồm mẫu HealthKit thô hoặc giá trị dữ liệu sức khỏe của bạn.

Xuất từ đâu

Có ba cách xuất nhật ký chẩn đoán. Chọn theo mức chi tiết bạn cần.

ZIP chẩn đoán đầy đủ (khuyến nghị cho hỗ trợ qua chat)

Gói đầy đủ gồm events.jsonl toàn ứng dụng (và khối xoay vòng nếu có), manifest.json và automations.json đã chỉnh sửa.

Xuất từ một trong các vị trí sau:

1. Cài đặt → Nâng cao → Export Event Logs
2. Tự động hóa → Xem nhật ký hoạt động → chia sẻ (thanh công cụ) — xuất cùng ZIP đầy đủ như Nâng cao, không phải tệp chỉ cho một tự động hóa

Chia sẻ ZIP qua Mail, AirDrop hoặc mục tiêu chia sẻ khác.

Chỉ nhật ký miền tự động hóa

Automation Settings → Export Automation Logs chỉ xuất các dòng liên quan tự động hóa từ nhật ký sự kiện ứng dụng (lọc theo subsystem). Dùng khi bạn muốn gói nhỏ hơn, tập trung tự động hóa. Với hầu hết trường hợp hỗ trợ, hãy dùng ZIP chẩn đoán đầy đủ từ Nâng cao hoặc chia sẻ nhật ký hoạt động.

Khi nào nên xuất nhật ký sự kiện ứng dụng

Xuất nhật ký khi bạn có thể tái hiện sự cố, ví dụ:

• Tự động hóa không chạy ổn định
• Tải lên lên đích đám mây thất bại lặp lại
• Xuất dữ liệu thất bại bất ngờ
• Hành vi kết nối máy chủ không giải thích được
• Lần chạy tự động hóa chậm (cũng kiểm nhật ký hoạt động để xem cảnh báo truy vấn chậm)

Cách xuất nhật ký sự kiện ứng dụng (từng bước)

ZIP chẩn đoán đầy đủ:

1. Mở Health Auto Export.
2. Vào Cài đặt → Nâng cao → Export Event Logs, hoặc mở tự động hóa → Xem nhật ký hoạt động → chạm chia sẻ trên thanh công cụ.
3. Chia sẻ ZIP đã tạo qua Mail, AirDrop hoặc mục tiêu chia sẻ khác.

Chỉ miền tự động hóa:

1. Mở Automation Settings (từ khu vực tự động hóa).
2. Chạm Export Automation Logs.
3. Chia sẻ ZIP đã tạo.

Trước khi chia sẻ nhật ký

Kèm theo xuất nhật ký các thông tin sau:

• Bạn mong đợi điều gì xảy ra
• Thực tế đã xảy ra gì
• Thời gian xấp xỉ khi sự cố xảy ra
• Loại tự động hóa hoặc xuất dữ liệu liên quan
• Phiên bản iOS và model thiết bị
• Ảnh chụp màn hình nhật ký hoạt động của tự động hóa bị ảnh hưởng khi phù hợp

Ngữ cảnh này giúp hỗ trợ liên kết báo cáo của bạn với các sự kiện đã xuất.

Hướng dẫn liên quan

• Hướng dẫn khắc phục sự cố
• Hướng dẫn người dùng xuất thủ công
• Tổng quan tự động hóa