从 CloudWatch 到主屏幕
小组件定义CloudWatch 控制面板上的小组件、预设，或 AI 模型编写的小组件：采用 CloudWatch 自己的 JSON 格式，说明使用哪些指标或警报以及如何显示。
来自 CloudWatch 的数据使用小组件所属账户自己的登录身份获取，从你的设备直接连接 AWS。
快照已准备好绘制的值，保存在你的设备上。主屏幕小组件会以各种尺寸绘制它。
每次小组件刷新时，CloudPeek 会：
- 对于来自控制面板的小组件，重新读取控制面板（
GetDashboard）并在其中找到该小组件，这样你在控制台中或通过代码所做的编辑都会显示出来。预设和 AI 小组件没有控制面板，因此跳过这一步：AI 小组件将其定义与小组件一起保存，预设则会按当前版本 App 中的预设重新生成，同时保留其标题、区域和时间范围。 - 像 CloudWatch 控制台一样计算出查询：时间范围、周期、指标数学、
SEARCH以及每个指标的区域。请参阅小组件参考。 - 获取数据：对小组件使用的每个区域并行发出一个
GetMetricData请求。警报小组件则在每个警报所在的区域调用DescribeAlarms。 - 在你的设备上保存快照，存储位置只有 App 及其小组件可以读取，然后由小组件绘制它。
中间没有任何 CloudPeek 服务器：请参阅哪些数据会离开你的设备。
小组件何时刷新
- 按计划：默认每 30 分钟刷新一次。可在设置的主屏幕小组件下通过刷新更改：每 30 分钟，或每 1、2 或 6 小时，在 Android 上还可选择每 15 分钟。具体时间由 iOS 根据你查看小组件的频率决定，并会在繁忙的日子或低电量模式下分散刷新，因此请将该设置视为参考。对于你经常查看的小组件，iOS 每天大约给予 40 到 70 次刷新，少于每 15 分钟刷新所需的次数，因此 iPhone 和 iPad 不提供该选项：在早期版本中设为每 15 分钟的小组件会每 30 分钟刷新一次。在 Android 上，具体时间同样由系统决定，并且在手机省电时可能会推迟。
- AWS 更新数据较少时，刷新也较少：S3 每天报告一次存储桶大小和对象数量（
BucketSizeBytes和NumberOfObjects），因此这些数据最多每 6 小时刷新一次；AWS 每天更新几次预估费用（AWS/Billing），因此它最多每 3 小时刷新一次。更频繁地刷新只会显示相同的数字，还会再次计费。同时显示其他指标的小组件会按计划刷新。小组件的专属屏幕会说明何时适用此规则，例如“S3 每天更新一次此数据，因此它每 6 小时刷新一次，而非每 30 分钟。”；如果没有数据且已显示“S3 每天报告一次存储桶大小。”，则只显示“它每 6 小时刷新一次，而非每 30 分钟。” - 每次打开 CloudPeek 时，但上述小组件除外，直到其数据再次到期。
- 在你要求时：轻点中号或更大小组件上的刷新按钮、在“小组件”标签页上下拉、在小组件的更多菜单中选择刷新，或在“设置”中选择立即刷新小组件。这些操作会获取每个小组件的数据，即使是 AWS 较少更新其数据的小组件也不例外。你轻点了刷新按钮的小组件会显示正在刷新，直到新数据到达；在 Android 上，该按钮会变成一个旋转的圆圈，并且该小组件会先于其他小组件刷新。
过去五分钟内由 App 或其他小组件加载的数据会被重复使用，而不会重新获取和计费，除非你要求刷新，或此后有刷新失败。S3 存储和账单数据在再次到期之前也会以同样的方式重复使用。
警报通知来自这些刷新，因此只能与刷新一样及时：请参阅在警报触发时收到通知。
刷新失败时
- 小组件会保留最后的数据，并说明原因和数据的新旧程度：中号和大号小组件显示“登录已过期 · 数据截至周五 14:05”，小号小组件显示“自14:05起未更新”。
- 超过一天的数据会变淡显示，以免被误认为是当前数据。
- 网络或 AWS 出现短暂故障后，拥有近期数据的小组件会在 10 分钟内重试。其他失败（例如登录已失效）则会等到下一次计划刷新：这些情况需要你先采取行动。
- iPhone 或 iPad 重新启动后，在你首次解锁之前，小组件无法读取你的登录信息。它们起初每隔几分钟重试一次，之后重试频率会降低。
- 如果暂时无法读取 Android 的安全存储，小组件会显示“无法读取已保存的登录信息。稍后将重试。”，起初会在几分钟内重试，之后重试频率会降低。
所有消息及其处理方法，请参阅故障排除。
费用
CloudPeek 是免费的。它向 AWS 发出的请求按 CloudWatch 的常规价格计入你的 AWS 账户：
| 项目 | AWS 收费 |
|---|---|
指标小组件的每次刷新：每个区域一个 GetMetricData 请求 | 每请求 1,000 个指标 $0.01，隐藏的指标（例如指标数学读取的指标）以及 SEARCH 找到的每个指标都计算在内。一个含 5 个指标、每 30 分钟刷新一次的小组件每月大约请求 7,200 个指标：约 7 美分。S3 存储和账单小组件刷新频率较低，因此费用更少。 |
控制面板小组件的每次刷新还会读取其控制面板（GetDashboard）；警报小组件调用 DescribeAlarms 而不是 GetMetricData | API 请求，按请求次数而非指标数计费。CloudWatch 免费套餐涵盖每个账户每月的前一百万次请求。请参阅 CloudWatch 定价。 |
| 在小组件的屏幕上以其他时间范围查看它，或与前一周对比 | 你每轻点一个时间范围，就会多一次 GetMetricData 来获取其指标，与前一周对比时则多两次：请参阅其他时间范围和前一周。 |
| 你创建的控制面板 | 前三个免费；之后每个每月 $3。预设和 AI 小组件不需要控制面板。 |
| 编写一个 AI 小组件（一次性） | 使用 Amazon Bedrock 约 1 美分，计入该账户；使用 Claude Sonnet 5.5 则为几美分，计入你的 Anthropic 账户。请参阅 AI 小组件。 |
设置会在刷新下估算小组件的费用，并在你更改刷新间隔时更新估算，例如“你的 7 个小组件每次刷新请求 40 个指标：每 30 分钟刷新一次，每月约 $0.58。”它按每个小组件各自的间隔计算，并假定小组件按计划刷新。SEARCH 能找到多少个指标只有在运行时才知道，因此对于带搜索的小组件，它会说明找到的每个指标每月增加多少费用。
要随时关注费用，请添加 GetMetricData 调用次数预设：它会用图表显示你的账户每小时的 GetMetricData 调用次数。
控制面板发生变化时
来自控制面板的小组件会跟随控制面板：在控制面板小组件被移动、调整大小、更改标题或编辑后，它们会重新找到对应的小组件；如果找不到，则保留最后一个版本。详情请参阅更改如何同步到你的手机。