SuperAPI AI 工具集

cx-rum

数据与分析

查看项目

更新于 10-15 20:28

技能介绍

用途:查询并分析 Coralogix Real User Monitoring(RUM)数据,适用于前端错误、页面加载时间、Web Vitals、用户交互、网络请求等问题的排查。

主要能力:RUM 数据以普通日志形式存储在 cx_rum 子系统,可用与普通日志相同的查询方式访问。元数据($m.)和标签($l.)行为一致;RUM 专有字段位于 $d.cx_rum.*,包含事件类型、错误、会话、Web Vitals、交互等。可查询的事件类型包括 error、resources、network-request、user-interaction、web-vitals、longtask、life-cycle、dom、log、custom-measurement、mobile-vitals。错误检测的通用标记为 event_context.severity == 5,可用 rum_template_id 对错误分组去重。

用法:基本命令为 cx logs '<dataprime_query>',查询需包含 $l.subsystemname == 'cx_rum'。应用过滤应使用 $d.cx_rum.version_metadata.app_name,而非 $l.applicationname。常用选项:--start(默认 now-1h)、--end(默认 now)、--limit(默认 100)、--tier(frequent 或 archive)、-o/--output(text、json、agents)。Web Vitals 与页面性能查询建议使用较宽时间范围(如 --start now-7d),因为短时间范围产生的分位数不可靠。Web Vitals 使用 percentile(0.75, ...) 而非平均值。用户交互查询应聚合,按 interaction_context.target_element_inner_text 分组并过滤空值。页面性能按 page_context.page_fragments 分组,而非 page_url。

适用场景:前端错误与崩溃分析、错误影响用户数统计、慢加载页面识别、LCP/LT 等 Web Vitals 分析、失败网络请求排查、页面点击与输入行为分析。

限制:不支持会话回放和会话流分析,仅能查询单条 RUM 日志事件。按 cx_rum 字段过滤时只会显示 RUM/前端日志,隐藏后端日志,这是预期行为。若查询无结果,可逐一放宽时间范围、过滤条件或核对字段名。相关技能包括 cx-query-logs、cx-query-spans、cx-metrics-query、cx-telemetry-querying、cx-alerts。