Analytics 常见问题解答

项目
03/15/2024

重要

Visual Studio App Center 计划于 2025 年 3 月 31 日停用。虽然可以继续使用 Visual Studio App Center，直到它完全停用，但你可以考虑迁移到几个建议的替代方法。

详细了解支持时间线和替代方案。

数据是否采样？

不会对数据进行采样。分析将使用发送的所有数据，除非以错误格式发送或达到某些已知限制。

发送的日志与其在分析仪表板中的表示之间的延迟是多少？

延迟通常为几分钟。

如果应用处于脱机状态，SDK 是否存储日志，并在其重新联机后发送日志？

是的。如果没有网络连接，SDK 默认在本地存储中保存最多 10 MB () 日志。可以通过 API 更改 setMaxStorageSize 存储大小。存储已满后，SDK 将开始放弃旧日志，为新日志腾出空间。还原网络连接后，SDK 会将这些日志发送到 App Center 后端。

会话持续时间未知，为什么？

会话定义为从应用进入前台到进入后台之前最后一个事件的时间。如果在会话中 5 分钟内未识别任何自定义事件，则不会对会话进行计数。

为什么我的“OS 分发”图表显示的设备数超过安装数？

OS 分发计数不是快照。它们是与所选时间段匹配的设备计数。例如，如果用户在所选时间段内从一个 OS 版本升级到较新版本，则会计入这两个 OS 版本。如果在时间段内有大量用户升级，则重叠可能会导致“OS 分发”图表中的设备明显多于安装数。

为什么未显示国家/地区信息？ / 国家/地区信息似乎不正确。

国家/地区由运营商国家/地区决定，并要求设备具有 SIM 卡。如果你使用的是没有 SIM 卡卡的平板电脑或设备，则不会报告国家/地区。如果使用模拟器，则国家/地区信息可能不准确。

每个应用可以发送的最大非重复事件数是多少？

对于 Analytics，我们每天跟踪的最大不同自定义事件数为 200。计数将在每天上午 12 点（UTC）重置。但是，每个设备发送的事件实例的最大数目没有限制。

一天 200 个不同事件的限制不适用于导出。我们导出所有接受的日志，即使未在 Analytics 中跟踪它们。

每个事件可以定义的最大事件属性数是多少？如果我发送的量超过限制，会发生什么情况？

事件属性的最大数目当前设置为 20。如果发送了超过 20 个属性，则会自动拒绝这些属性。

每个事件可以发送的最大属性值数是多少？

你将看到具有最高计数的 10 个属性值的计数。

为什么我在日志流中看不到任何数据？

日志流页将显示传入的日志。若要开始查看日志流，需要打开日志流页，然后开始从应用发送日志。

是否可以导出原始数据？

是的。在“应用设置”下，可以将所有 Analytics 原始数据导出到 Azure Blob 存储和 Application Insights 中。

将日志发送到 App Center 的时间段限制是什么？

App Center 后端将仅接受过去不超过 25 天或未来 3 天的日志。

分析 API `start` 和 `end` 参数的响应粒度如何？

分析 API 按天返回计数器。换句话说，将忽略输入的时间部分，在处理结果时仅考虑日期部分。

为什么 UserId 在分析事件、会话和其他分析数据中值为“None”？

目前，用户 ID 只能应用于诊断 (崩溃、错误) 。

解决方法是在“属性”中添加 userId，如下所示。

Map<String, String> properties = new HashMap<>();
properties.put("UserId", "your user Id");
Analytics.trackEvent("EventName", properties);

通过