SuperAPI AI 工具集

rum

前端与建站

查看项目

更新于 10-15 20:28

技能介绍

用途:使用 cx logs 命令和 DataPrime 语法查询并分析 Coralogix 真实用户监控(RUM)数据。RUM 采集浏览器与移动端的真实用户交互,包括错误、性能指标、网络请求、Web Vitals 和用户交互,数据存于 cx_rum 子系统,以普通日志形式查询。

主要能力:

  • 错误分析:以 event_context.severity == 5 作为通用错误标记,用 rum_template_id 将相似错误归组为独立问题。
  • Web Vitals:查询 LT、LCP、FID、CLS、FCP、INP、TTFB、TBT 等指标,使用 percentile(0.75, ...) 计算 p75。
  • 页面性能:用 LT(加载时间)分析页面加载,按 page_fragments 分组并附用户数。
  • 网络请求:按 network-request 类型和严重级别过滤失败请求,描述格式为 <method> <fragments> (status <status_code>)。
  • 用户交互:按 interaction_context.target_element_inner_text 聚合点击与输入,过滤空值。

使用方式:基本命令为 cx logs '<dataprime_query>',查询须包含 $l.subsystemname == 'cx_rum'。常用选项:--start(默认 now-1h)、--end(默认 now)、--limit(默认 100)、--tier(frequent 或 archive)、-o/--output(text、json 或 agents)。RUM 应用名用 $d.cx_rum.version_metadata.app_name,微前端标签用 $d.cx_rum.labels.mfeApp,不要用 $l.applicationname。

限制:仅可查询单条 RUM 日志事件,不支持会话重放和会话流。Web Vitals 和页面性能查询应使用 --start now-7d 或更长区间,短区间因数据点过少导致百分位不可靠。按 cx_rum 字段过滤时只显示 RUM/前端日志,属预期行为。无结果时建议逐一调整时间范围、过滤条件或字段名,或改用 --tier archive 查询更早数据。