诊断和排查 Azure 时序见解第 2 代环境问题

注意

时序见解服务将于 2024 年 7 月 7 日停用。 请考虑尽快将现有环境迁移到备用解决方案。 了解更多有关弃用和迁移的信息，请访问我们的 文档。

本文总结了使用 Azure 时序见解 Gen2 环境时可能会遇到的几个常见问题。 本文还介绍了每个问题的潜在原因和解决方案。

问题：在 Gen2 资源管理器中找不到我的环境

如果没有访问时序见解环境的权限，可能会出现此问题。 用户需要具有阅读器级别访问权限的角色才能查看其时序洞察环境。 若要验证当前访问级别并授予其他访问权限，请转到 azure 门户 中时序见解资源的 数据访问策略 部分。

问题：Gen2 浏览器中未显示任何数据

数据可能不会显示在 Azure 时序见解第 2 代资源管理器中的原因有多种。

• 事件源可能未接收数据。

  验证事件源（事件中心或 IoT 中心）是否正在从标记或实例接收数据。 若要验证，请转到 Azure 门户中资源的概述页。

  

• 事件源数据不采用 JSON 格式。

  Time Series Insights 仅支持 JSON 数据。 对于 JSON 示例，请阅读 支持的 JSON 形状。

• 事件源密钥缺少所需的权限。

  • 对于 IoT 中心，需要提供具有 服务连接 权限的密钥。

    

    • 策略 iothubowner 和 服务 都能够正常工作，因为它们具有 服务连接 权限。

  • 对于事件中心，需要提供具有 侦听 权限的密钥。

    

    • 读取 和 管理 策略都有效，因为它们具有 侦听 权限。

• 提供的消费者组并非时序洞察专用。

  在注册 IoT 中心或事件中心期间，可以指定用于读取数据的使用者组。 此使用者组在每个环境中必须是唯一的。 如果共享使用者组，基础事件中心会自动随机断开其中一个读取器的连接。 为时序洞察提供一个唯一的消费者组以进行读取。

• 预配时指定的时序 ID 属性不正确、缺失或为 null。

  如果在预配环境时配置了错误时序 ID 属性，则可能会出现此问题。 有关详细信息，请阅读 选择时序 ID的最佳做法。 当前，无法将现有的 Time Series Insights 环境更新为使用不同的时序 ID。

问题：某些数据显示，但有些数据缺失

你可能发送的数据没有时序 ID。

• 当您在有效负载中发送缺少时序 ID 字段的事件时，可能会出现此问题。 有关详细信息，请阅读 支持的 JSON 格式。

• 由于环境受到限制，因此可能会出现此问题。

  注意

  目前，Time Series Insights 支持的最大导入速率为 1 Mbps。

问题：数据已显示，但现在导入已停止

• 事件源密钥可能已重新生成，Gen2 环境需要新的事件源密钥。

创建事件源时提供的密钥不再有效时，会出现此问题。 你将在中心看到遥测数据，但在时序洞察中看不到传入消息。 如果不确定是否已重新生成密钥，则可以在事件中心的活动日志中搜索“创建或更新命名空间授权规则”，或者搜索 IoT 中心的“创建或更新 IotHub 资源”。

若要使用新密钥更新时序见解 Gen2 环境，请在 Azure 门户中打开中心资源并复制新密钥。 导航到 TSI 资源，然后单击“事件源”。

选择那些已停止引入数据的事件源，粘贴新的密钥，然后点击“保存”。

问题：我的事件源的 Timestamp 属性名称不起作用

确保名称和值符合以下规则：

• Timestamp 属性名称区分大小写。
• 作为 JSON 字符串来自事件源的 Timestamp 属性值具有格式 yyyy-MM-ddTHH:mm:ss.FFFFFFFK。 此类字符串的示例是 "2008-04-12T12:53Z"。

确保“时间戳”属性名称被正确捕获并正常工作的最简单方法是使用时序洞察 Gen2 资源管理器。 在 Time Series Insights Gen2 浏览器中，提供 Timestamp 属性名称后，使用图表选择一个时间段。 右键单击所选内容，然后选择 浏览事件 选项。 第一个列标题是您的 Timestamp 属性的名称。 它应该在 Timestamp这个词旁边标注 ($ts)，而不是：

• (abc)，表示 Time Series Insights 将数据值读取为字符串。
• 日历 图标，用于表明时间序列洞察将数据值读取为日期时间。
• 时序洞察读取数据值为整数，#表示这一点。

如果未显式指定 Timestamp 属性，将使用事件的 IoT 中心或事件中心的排队时间作为默认时间戳。

问题：无法在资源管理器中查看暖存储中的数据

• 你可能最近配置了你的暖存储，并且数据仍在不断流入。
• 你可能已经删除了温存储，这种情况下数据可能会丢失。

问题：无法查看或编辑时序模型

• 您可能正在访问 Time Series Insights（时序见解）S1 或 S2 环境。

  时序模型仅在按需付费环境中受支持。 有关如何从时序洞察 Gen2 Explorer 访问 S1 或 S2 环境的详细信息，请阅读 在 Explorer 中可视化数据。

  

• 你可能无权查看和编辑模型。

  用户需要参与者级访问权限才能编辑和查看其时序模型。 若要验证当前访问级别并授予其他访问权限，请转到 Azure 门户中时序见解资源上的 数据访问策略 部分。

问题：第 2 代资源管理器中的所有实例都缺少父级

如果环境未定义时序模型层次结构，则可能会出现此问题。 有关详细信息，请阅读有关如何 使用时序模型。

后续步骤

• 了解如何 使用时序模型。

• 了解 支持的 JSON 形状。

• 在 Azure 时序见解第 2 代中查看 规划和限制。