Dữ liệu được thu thập
Trang này nói rõ Phillip gửi gì từ máy bạn, gửi đến đâu và phần nào bị bỏ trước khi lưu. Đọc xong bạn biết dữ liệu nào rời máy, dữ liệu nào thật sự nằm lại ở Ryoma, và chỗ nào còn giới hạn.
Tóm tắt
Ryoma chỉ lưu số đếm và metadata. Phillip không bật các biến ghi nội dung prompt, câu trả lời hay kết quả tool. Collector của Ryoma dùng danh sách trắng: chỉ những trường cần cho việc đo mới được ghi xuống đĩa, còn email, mã tài khoản, body log và mọi trường lạ đều bị bỏ. Có một điểm cần đọc kỹ ở mục Tham số của tool: tham số tool có thể đi qua đường truyền tới Collector, rồi bị bỏ ở đó.
Khi nào dữ liệu được gửi
Dữ liệu chỉ được gửi khi bạn chạy Claude Code qua ph và đã đăng nhập Tara. Lúc đó Phillip đặt các biến môi trường OpenTelemetry cho phiên, và dữ liệu đi tới Ryoma bằng OTLP qua HTTP, xác thực bằng token Tara của bạn. Chưa đăng nhập Tara thì không có gì được gửi. Bạn kiểm tra kết nối bằng ph forge doctor, ở dòng Ryoma và Collector.
Cấu hình exporter đặt trong .claude/settings.json của repo không có hiệu lực, nên repo không tắt được telemetry. Ngược lại, nếu bạn chạy claude trực tiếp mà không qua ph thì Phillip không bật telemetry cho phiên đó. Quản trị có thể ép buộc bằng managed settings.
Vuốt ngang để xem hết sơ đồ.
Máy bạn gửi những gì?
Claude Code phát ra hai nhóm dữ liệu là số đo (metric) và sự kiện (log). Các bảng dưới đây liệt kê những gì máy bạn gửi tới Collector. Phần Ryoma lưu hẹp hơn nhiều, và được nói riêng ở mục sau.
Số đo
| Số đo | Nội dung |
|---|---|
| Token | Số token theo loại (đầu vào, đầu ra, đọc cache, tạo cache), model, nguồn truy vấn, và tên skill, plugin, agent nếu có |
| Chi phí | Chi phí quy đổi ước tính theo giá API |
| Phiên | Số phiên, thời gian hoạt động |
| Đầu ra thô | Số dòng mã thay đổi, số commit, số PR |
| Chấp nhận sửa | Số lần bạn chấp nhận hoặc từ chối một thay đổi |
Sự kiện
| Sự kiện | Nội dung |
|---|---|
| Yêu cầu tới model | Token theo loại, chi phí, model, thời gian xử lý |
| Skill, plugin, subagent | Tên tài nguyên được nạp hoặc dùng, và do ai kích hoạt (bạn gõ hay Claude tự gọi) |
| Quyết định về tool, hook, an toàn | Tên tool, kết quả cho phép hay từ chối, số lần hook chạy |
| Quyết định Guardrails | Mỗi lần chặn, hỏi lại hay che: mã luật, quyết định, mức độ, tên policy, repo, mã task, tên tool. Không có nội dung |
Định danh và ngữ cảnh
Mỗi bản ghi mang thêm vài thuộc tính để gắn với người, dự án và task. Đó là mã phiên do Claude Code cung cấp, địa chỉ repo (Phillip bật biến gửi repo để Ryoma ánh xạ repo sang dự án và tổ chức), và mã task forge.issue lấy từ tên nhánh lúc Phillip khởi chạy Claude Code. Danh tính người gửi (forge.user_id, forge.org_id) do máy chủ gắn từ token Tara của bạn, chứ Ryoma không tin trường nào do máy khách tự khai.
Khi bạn đăng nhập Claude bằng OAuth, Claude Code có thể đính kèm user.email và mã tài khoản vào bản ghi. Collector bỏ các trường này, cùng mọi trường ngoài danh sách trắng, trước khi ghi, nên chúng không có trong dữ liệu thô của Ryoma. Số liệu được tính từ danh tính trong token, không dùng email.
Những gì Phillip không bật
Phillip không bật bốn biến cho phép Claude Code gửi nội dung. Đó là nội dung prompt của bạn, nội dung câu trả lời của model, nội dung đầu vào và đầu ra của tool, và thân yêu cầu cùng phản hồi API thô. Vì vậy mã nguồn, nội dung file, prompt và câu trả lời không nằm trong telemetry của Phillip.
Tham số của tool
Để biết skill, plugin, agent nào của Tara đang được dùng, Phillip bật chế độ chi tiết tool. Chế độ này làm Claude Code đính kèm tên tool và tên MCP, và cũng có thể đính kèm lệnh shell, tham số tool và nội dung lỗi, mỗi lần vài KB. Những trường đó có thể chứa secret hoặc dữ liệu khách hàng.
Việc lọc diễn ra ở phía máy chủ, nên các trường này có thể rời máy bạn và tới Collector của Ryoma. Tại đây Collector áp danh sách trắng. Chỉ những trường Ryoma cần mới được ghi xuống đĩa: mã phiên, model, số token, chi phí, tên skill, plugin, agent, repo, mã task, quyết định Guardrails (mã luật, quyết định, mức độ) và danh tính do máy chủ gắn. Mọi thứ còn lại bị bỏ, gồm tham số tool, lệnh, lỗi, user.email, mã tài khoản và cả body của bản ghi. Tên tool và MCP không nằm trong danh sách nên cũng không được lưu.
Nói cho chính xác thì nội dung tham số tool không được lưu, nhưng nó có thể đi qua đường truyền đến Collector. Vì lọc bằng danh sách trắng, trường mới mà một bản Claude Code sau này thêm vào sẽ bị bỏ mặc định, không cần chờ ai cập nhật danh sách. Ngoài danh sách trắng, Collector còn một lớp xóa riêng các khóa nội dung đã biết, phòng khi danh sách trắng bị sửa nhầm.
Vì tham số tool vẫn có thể đi qua đường truyền, bạn nên chạy Ryoma qua HTTPS, và để Guardrails che secret trước khi chúng xuất hiện trong lệnh hay kết quả tool.
Dữ liệu nằm ở đâu, giữ bao lâu?
Dữ liệu thô nằm trong kho phân tích của Ryoma (ClickHouse), và quản trị đặt thời gian giữ bằng RYOMA_RAW_TTL. Số liệu tổng hợp như Flow, AI và sức khỏe dự án nằm trong cơ sở dữ liệu của Ryoma. Ryoma cũng đồng bộ task từ GitHub hoặc GitLab bằng token chỉ đọc của dịch vụ, gồm tiêu đề, nhãn, người phụ trách và mốc thời gian. Nội dung mã nguồn không được đồng bộ để tính số liệu.
Tara còn lưu gì?
Tara đếm lượt tải theo version và ghi nhật ký audit cho các thay đổi quản trị. Knowledge base chỉ chứa tài liệu mà tổ chức hoặc dự án chủ động đưa lên, và được đọc theo quyền của space. Thông báo qua Telegram, email, Slack, Zalo chỉ chứa metadata như mã task, tiêu đề và đường dẫn.
Xem dữ liệu của bạn
Bạn xem mức dùng AI của mình theo dự án và theo ngày bằng ph ryoma, còn trạng thái gửi telemetry thì xem bằng ph forge doctor. Muốn đối soát số liệu Ryoma với nhật ký cục bộ của Claude Code trên máy, bạn chạy ph ryoma verify.