内存存储可观察性

*此内容使用人工智能(Beta)翻译,可能包含错误。若要查看英文页面,请点按 此处

内存存储可观察性仪表板提供了实时的内存使用情况和 API 请求的图表。它还具有内置的警报系统,当出现问题时通过电子邮件通知您,帮助您同步故障排除。有关特定错误的更多信息,您可以查看您的 错误报告 以找到错误日志。

访问仪表板

内存存储可观察性仪表板适用于使用 MemoryStoreService 的任何游戏,但您必须是游戏所有者或拥有 分析组权限 才能访问该仪表板。

要访问仪表板:

  1. 创作者仪表板创作 页面上。
  2. 展开左上角的帐户切换器,选择您的帐户或拥有目标游戏的组。
  3. 选择游戏。
  4. 监控 下拉菜单中,选择 内存存储

可用图表

仪表板包括两类折线图:

  • 配额使用情况 图表,用于跟踪您的使用情况与 动态分配配额 的比较,这些配额是基于游戏中用户的数量计算的。
    • 内存使用情况 显示每分钟的内存使用量(以字节为单位)与剩余的分配配额的比较。
    • API 请求单元 显示每分钟的总请求单元与剩余的分配配额的比较。 该图表可以按每个 API 方法进行细分。
  • API 使用情况和性能 图表,用于监控基于 API 方法和响应状态的 API 使用模式和性能。

该图表包含过去 30 天的数据,您可以使用页面顶部的选择器选择查看自定义时间范围。如果您选择早于 30 天的时间范围,系统将返回 请求失败 错误。

响应状态代码

可观察性仪表板的 按状态的请求数量按 API x 状态的请求 图表包括 API 响应的状态代码,您可以利用这些状态代码来理解和排除错误。有关列出和描述所有这些状态代码的表,请参见 可观察性。此外,关于如何解决这些错误,或与之相关的特定配额或限制的信息,请参见 故障排除限制和配额

通知警报

电子邮件警报系统会自动检测并向您发送内存存储使用问题的警报,这些问题可能会损害游戏的性能。 有两种类型的警报:

  • 警告 是关于可能影响您游戏的问题的低优先级警报。您应该在它们变成严重问题之前解决它们。仪表板通过以黄色突出显示图表及警告消息来标记这些警报。
  • 严重 是关于直接影响您游戏的问题的高优先级警报。您应该尽快解决这些问题,以防止性能下降。仪表板通过以红色突出显示图表及错误消息来标记这些警报。

当您的游戏同时触发两种类型的警报时,仪表板将显示警报标题消息并突出显示图表区域,以引起您的注意,标记为 严重

目前,系统有四个内置的内存使用和 API 请求警报。如果您的游戏超过警报阈值,系统会每天最多通知您一次每个警报。当收到电子邮件警报时,您应该查看仪表板并采取措施以防止性能下降。

内存使用警报

系统发送以下内存使用警报:

  • 当您游戏的内存使用量在过去一小时内超过总配额的 70% 时,发送 警告 警报。

  • 当您游戏的内存大小配额在过去一小时内被超过时,发送 严重 警报。

这些问题通常发生在您过度填充内存存储数据结构时,即使您只对少数键发送请求,也会迅速消耗配额。例如,如果您对键设置了较长的过期时间,或未清除已处理数据,额外的数据可能会填满您的内存配额。

要防止和解决这些问题,请遵循 最佳实践,跟踪您正在积极使用的数据结构,并设置清除已处理数据的机制。

API 请求警报

系统发送以下 API 请求警报:

  • 当您内存存储请求失败的数量在过去一小时内超过 20% 时,发送 严重 警报。

  • 当过去一小时内,您内存存储请求的超过 10% 被限制时,发送 严重 警报。

    • 此警报基于 DataStructureRequestsOverLimit + TotalRequestsOverLimit 的数量,这些是指示您的游戏因发送过多请求而被限制的错误响应。
    • 此警报与请求大小无关,仅与数量相关。

所有 API 请求都有相应的 响应状态代码,因此您可以利用 按状态的请求数量 图表查看 成功 响应与所有错误响应的比例,以进行 故障排除

©2026 Roblox Corporation、Roblox、Roblox 标志及 Powering Imagination 是我们在美国及其他国家或地区的注册与未注册商标。