文档中心

应用性能监控全链路版

使用指南

磁盘监控

磁盘占用过大会导致手机磁盘不足，影响App的性能，甚至用户会卸载App释放磁盘空间。磁盘监控可以帮助用户监控手机磁盘空间大小以及App占用磁盘大小，发现占用磁盘过大的文件夹和文件，以及一些被遗忘的过期文件。

前提条件

已接入磁盘监控。详情请参见Android SDK接入和iOS SDK接入。

已配置磁盘监控。详情请参见SDK上报配置。

磁盘指标

筛选条件

您可以通过以下筛选条件进行数据筛选。

Android系统支持的筛选维度：

时间、设备ID、User ID、系统版本、APP版本、APP小版本号、机型、APM SDK版本、下载渠道。

iOS系统支持的筛选维度：

时间、设备ID、User ID、越狱状态、系统版本、APP版本、APP小版本号、机型、APM SDK版本、下载渠道。

iOS磁盘指标

iOS磁盘指标展示了筛选条件下iOS磁盘指标的趋势图，默认展示了一些磁盘指标平均值和样本量。

单击指标详情，查看磁盘趋势图和多维分析。

指标说明：

指标	说明
手机磁盘大小	手机磁盘大小
手机剩余磁盘	手机剩余磁盘大小
App占用磁盘	沙盒内文件总大小
App磁盘使用占比	App占用磁盘/手机磁盘
App Library和Document占用磁盘大小	沙盒内Library和Document文件的总大小

Android磁盘指标

Android磁盘指标展示了筛选条件下Android磁盘指标的趋势图，默认展示了一些磁盘指标平均值和样本量。

单击指标详情，查看磁盘趋势图和多维分析。

指标说明：

指标	说明
手机磁盘大小	Environment.getDataDirectory().getTotalSpace() + Environment.getRootDirectory().getTotalSpace()
手机剩余磁盘	Environment.getDataDirectory().getFreeSpace()
App占用磁盘	context.getFilesDir().getParent() + context.getExternalFilesDir(null).getParentFile()
App磁盘使用占比	App占用磁盘/手机磁盘
App Cache占用磁盘	context.getCacheDir() + context.getExternalCacheDir()

目录分析

筛选条件

您可以通过以下筛选条件进行数据筛选。

Android系统支持的筛选维度：

时间、设备ID、User ID、系统版本、APP版本、APP小版本号、机型、APM SDK版本、下载渠道。

iOS系统支持的筛选维度：

时间、设备ID、User ID、越狱状态、系统版本、APP版本、APP小版本号、机型、APM SDK版本、下载渠道。

子目录趋势图

子目录分析趋势图可以分析App占用磁盘中占据磁盘较大的目录和文件，支持按照层级点开分析。

Android为了防止因为不同机型获取的目录前缀不同，目录前缀使用internal和external做了替代处理。

目录前缀	说明
根文件	代表App占用磁盘context.getFilesDir().getParent() + context.getExternalFilesDir(null).getParentFile()
internal	代表目录context.getFilesDir().getParent()
external	代表目录context.getExternalFilesDir(null).getParentFile()

指标说明：

指标	说明
上报量	目录上报次数
路径占比	当前目录大小/App占用磁盘
磁盘使用量	当前目录大小
上报用户数	目录上报用户数

子目录列表

参数说明：

参数	说明
平均大小	当前目录大小，上报的多个数据聚合的平均值。
大小占比	当前目录大小/App占用磁盘
加权平均大小	平均大小 ×（当前目录上报量/根文件上报量）为了防止目录只上报一次，但是文件很大，排序总是在前面这种场景。

磁盘异常

筛选条件

您可以通过以下筛选条件进行数据筛选。

Android系统支持的筛选维度：

时间、文件查询、设备ID、User ID、异常类型、issue新增状态、系统版本、机型、APP版本、APP小版本号、APM SDK版本、下载渠道、ROM信息、省份、厂商、issue状态、处理人、标签、自定义维度、PV自定义维度。

iOS系统支持的筛选维度：

时间、文件查询、设备ID、User ID、异常类型、issue新增状态、越狱状态、系统版本、机型、APP版本、APP小版本号、APM SDK版本、下载渠道、省份、issue状态、处理人、标签、自定义维度、PV自定义维度。

异常趋势

异常趋势主要分析对于App占用磁盘超过指定阈值的异常场景，分析当前的较大文件和文件夹，以及超过一定时间的过期文件。

异常分布

异常分布中可以查看App占用磁盘超过指定阈值的异常主要分布情况。

默认按照上报量展示分布情况，支持切换为用户量。

默认按照异常类型、系统版本、机型、APP版本展示分布情况，支持配置为APP小版本号、APM SDK版本、下载渠道、省份等维度。

异常文件列表

异常详情：单击进入异常详情页面。

异常详情

磁盘异常详情页面可以具体分析每一个磁盘异常的详细数据。

指标说明：

指标	说明
异常数	筛选条件下异常上报次数
异常率	筛选条件下异常上报次数/筛选条件下总PV
影响用户数	筛选条件下异常上报用户数
影响用户比例	筛选条件下异常上报用户数/筛选条件下总UV

详情页面支持查看异常文件、异常文件夹和过期文件的具体信息。

指标	Android端指标定义	iOS端指标定义
异常文件	命中“磁盘异常采样率”的用户，App占用磁盘超过“异常磁盘占用阈值”，App文件从大到小排序后获取最大的文件上报，个数为前“异常文件最大上报个数”。	命中“磁盘异常采样率”的用户，App占用磁盘超过“磁盘文件占用分析阈值”，App文件从大到小排序后获取最大的文件上报，个数为前“异常文件最大上报个数”。
异常文件夹	命中“磁盘异常采样率”的用户，App占用磁盘超过“异常磁盘占用阈值”，App文件夹超过“异常文件夹磁盘阈值”的子文件，个数为前“异常文件最大上报个数”。	命中“磁盘异常采样率”的用户，App占用磁盘超过“磁盘文件占用分析阈值”，当文件夹大小超过“异常文件夹磁盘阈值”或文件夹包含的子文件个数超过“异常文件夹数量阈值”时，定义为异常文件夹。按文件夹大小排序，取个数为前“异常文件最大上报个数”进行上报。
过期文件	命中“磁盘异常采样率”的用户，App占用磁盘超过“异常磁盘占用阈值”，App文件lastModified距今时间超过“文件过期时间阈值”的文件，个数为前“异常文件最大上报个数”。	命中“磁盘异常采样率”的用户，App 占用磁盘超过“磁盘文件占用分析阈值”，App 文件最后一次访问时间距今时间超过“文件过期时间阈值”的文件，个数为前“异常文件最大上报个数”。

最近更新时间：2026.02.10 19:56:18

这个页面对您有帮助吗？

有用

无用