You need to enable JavaScript to run this app.
导航
veImageX
  • 文档首页
    • /veImageX/控制台指南/质量监控/客户状态监控
客户状态监控
最近更新时间：2025.01.22 16:12:14首次发布时间：2021.02.23 10:42:24
我的收藏

本节主要介绍客户状态监控功能，您可以在本页面根据所属应用、应用版本、平台等信息查询客户端指标数据。

前提条件

已创建应用，此应用（APPID）在客户端上传对应的参数。如未创建，请点击新建应用。

查询说明

  • 数据延迟约为 15 分钟；
  • 单次查询最大时间跨度为 93 天；
  • 支持查询近 90 天的历史数据；
  • 支持自定义添加页面查询条件；
  • 支持自定义页面查询指标；
  • 支持自定义选择查询时间粒度，支持 5min、1h、1d、7d；
  • 默认展示近 7 天数据；
  • 图片查询类型支持 GIF、PNG、JPEG、HEIF、HEIC、WEBP、AWEBP、VVIC、AVIF、AVIS、其他。

说明

查询文件大小 / 黑白屏率 / 降级率 TOP URL 时，其数据延迟约为 4 小时。

操作步骤

  1. 登录 veImageX 控制台。
  2. 在左侧导航栏选择质量监控 > 客户状态监控。
    Image

解码耗时

客户端解码成功的消耗时间平均值。

  • 支持展示均值趋势和分位趋势数据图。
  • 支持拆分查询维度。

说明

pct25 表示 25% 的用户上传耗时时间。

Image

加载耗时

图片加载请求开始到结束的时间。
加载耗时 = 查找缓存耗时 + 排队耗时 + 网络耗时 + 解码耗时

  • 支持展示均值趋势和分位趋势数据图。
  • 支持拆分查询维度。

Image

排队耗时

发起请求到真正开始下载等待的时间平均值。

  • 支持展示均值趋势和分位趋势数据图。
  • 支持拆分查询维度。

Image

图片样本量

客户状态监控日志采样的图片总数量。

  • 支持拆分查询维度。

Image

黑白屏监控

客户端解码后出现纯黑、纯白、透明图占上报图片总数量的比例。

  • 支持展示黑屏、白屏和透明图类别的趋势图。
  • 支持拆分查询维度。

Image

解码成功率

客户端解码成功率 = 1 - 解码失败次数 / 解码总次数

  • 支持拆分查询维度。

Image

处理降级率监控

图像处理发生降级比例。
处理降级率 = 处理降级的图片数量 / 预期处理的图片总数量

  • 支持展示 HEIC 降级、HEIF 降级和 AVIF 降级类别的趋势图。
  • 支持拆分查询维度。

Image

错误码分布

统计图片加载监控日志上报的错误码。

  • 支持展示错误码分布的趋势图及统计图。
  • 支持展示地区、域名和运营商类别的总上报量。

Image

用户感知失败率

用户感知到的图片加载失败率。
用户感知失败率 = 总失败率 - 用户取消和无网络造成的失败率

  • 支持拆分查询维度。

Image

文件大小分布

客户端上报的文件大小平均值。
文件大小分布 = 总文件大小 / 总有效文件大小

  • 支持展示均值趋势和分位趋势数据图。
  • 支持拆分查询维度。

Image

画质评估

画质评估是对图像的主观质量、大众美学、噪声强度等进行打分，分值越大越好。

  • 支持展示主观质量、大众美学和噪声强度模块的统计图。
  • 支持拆分查询维度。

Image

SDK 版本变化

统计使用不同 SDK 版本加载的图片样本数量。
Image

超分耗时

即图片在客户端超分过程中消耗的时间。

  • 支持展示均值趋势和分位趋势数据图。
  • 支持拆分查询维度。

说明

Android Glide 版本暂不支持查看该指标数据。

Image

超分成功率

超分成功率 = 超分成功次数 / 超分图片总数

  • 支持拆分查询维度。

说明

Android Glide 版本暂不支持查看该指标数据。

Image

自定义维度

  • Android 和 iOS 自定义维度

    自定义维度

    取值含义

    update_version_code

    SDK 版本

    exception_tag

    异常数据 tag，仅支持 iOS 使用。

    scene_tag

    场景，可以自定义的字段。

    access

    网络类型

    image_suffix

    图片 URL 的后缀

    load_status

    整体加载状态

    cdn_name

    参考 CDN 名称

    error_code

    加载错误码，一般是客户端返回的错误码。

    biz_tag

    渠道名称。支持自定义，在控制台可以用此值进行筛选。

    说明

    用于区分打点数据的告知 SDK 所处的频道，比如 feed、detail 等一般在 AB 实验的时候通过此来区分进入实验的用户的特定频道的数据。

    fail_phase

    失败阶段，发生在下载失败或解码失败。

  • web 自定义维度

    自定义维度

    取值说明

    update_version_code

    SDK 版本

    platform

    平台

    image_suffix

    图片后缀

    load_status

    加载状态

    access

    网络状态

    fail_phase

    失败阶段

    browser

    浏览器名称

常见问题

图片类型为其他时，表示加载失败吗？

  • Android 加载 SDK 上报数据有预加载复用缓存逻辑，当请求是复用缓存的数据，上报数据中图片类型会解析为其他。这部分数据需要从加载状态（自定义维度，单击添加查询条件 > 加载状态添加）判断图片加载情况，加载状态为成功代表图片为预加载复用缓存且不占用流量，加载状态为失败代表没有解析到图片类型。
  • iOS 加载 SDK 上报数据没有预加载复用缓存逻辑，图片类型为其他则表示图片加载失败。