诊断和排查 Azure 时序见解第 2 代环境的问题
注意
时序见解服务将于 2024 年 7 月 7 日停用。 请考虑尽快将现有环境迁移到备用解决方案。 有关弃用和迁移的详细信息,请访问我们的文档。
本文汇总了在使用 Azure 时序见解第 2 代环境时可能会遇到的若干常见问题。 本文还介绍了每个问题的可能原因和解决方案。
问题:在第 2 代资源管理器中找不到环境
如果无权访问时序见解环境,则可能会发生此问题。 用户需要读者级别访问角色才能查看其时序见解环境。 若要验证当前访问级别并授予其他访问权限,请在 Azure 门户中转到时序见解资源上的“数据访问策略”部分。
问题:第 2 代资源管理器中未显示数据
有几种常见原因导致数据可能不会出现在 Azure 时序见解第 2 代资源管理器中。
事件源可能未接收数据。
验证事件源(即事件中心或 IoT 中心)是否从标记或实例接收数据。 若要进行验证,请转到 Azure 门户中资源的概览页。
事件源数据不是 JSON 格式。
时序见解仅支持 JSON 数据。 有关 JSON 示例,请阅读支持的 JSON 形状。
事件源密钥缺少所需权限。
提供的使用者组并非时序见解所独有。
IoT 中心或事件中心注册期间,请指定用于读取数据的使用者组。 此使用者组必须在环境中独一无二。 如果共享了此使用者组,则基础事件中心会随机自动断开一个读取器的连接。 请提供唯一的使用者组,供时序见解从中读取。
在预配时指定的时序 ID 属性不正确、缺失或为 null。
如果在预配环境时时序 ID 属性配置不正确,则可能会发生此问题。 有关详细信息,请阅读选择时序 ID 的最佳做法。 目前无法更新现有时序见解环境来使用其他时序 ID。
问题:显示了一些数据,但是还有一些数据缺失
可能在发送数据时没有提供时序 ID。
如果在发送事件时有效负载中没有时序 ID 字段,则可能会发生此问题。 有关详细信息,请阅读支持的 JSON 形状。
可能因环境受限而发生此问题。
注意
目前,时序见解支持的最大引入速率为 1 Mbps。
问题:以前可以显示数据,但引入现已停止
- 可能已重新生成事件源密钥,并且第 2 代环境需要新的事件源密钥。
如果创建事件源时提供的密钥不再有效,则会出现此问题。 你会在中心看到遥测数据,但不会在时序见解中收到入口接收的消息。 如果不确定是否重新生成了密钥,可以在事件中心的活动日志中搜索“创建或更新命名空间授权规则”或“为 IoT 中心创建或更新 IotHub 资源”。
若要用新密钥更新时序见解第 2 代环境,请在 Azure 门户中打开中心资源并复制新密钥。 导航到 TSI 资源,单击“事件源”。
选择已停止从其引入的事件源,粘贴新密钥,然后单击“保存”。
问题:事件源的时间戳属性名称不起作用
请确保名称和值符合以下规则:
- Timestamp 属性名称区分大小写。
- 来自事件源的 Timestamp 属性值(采用 JSON 字符串形式)的格式为
yyyy-MM-ddTHH:mm:ss.FFFFFFFK
。"2008-04-12T12:53Z"
是此类字符串的一个示例。
使用时序见解第 2 代资源管理器是确保捕获 Timestamp 属性名称并让该属性正常工作的最简单方法。 在时序见解第 2 代资源管理器中使用此图表,在提供 Timestamp 属性名称以后选择一个时间段。 右键单击所做的选择,然后选择“浏览事件”选项。 第一个列标头为 Timestamp 属性名称。 它应该有 ($ts)
位于 Timestamp
一词的旁边,而不是:
(abc)
,指示时序见解将数据值作为字符串来读取。- 日历图标,指示时序见解将数据值作为日期/时间来读取。
#
,指示时序见解将数据值作为整数来读取。
如果 Timestamp 属性未显式指定,则会将事件的 IoT 中心或事件中心的“排队时间”用作默认的时间戳。
问题:我无法在资源管理器中查看我的暖存储中的数据
- 你可能最近预配了你的暖存储,数据仍在流入。
- 你可能已删除了暖存储,这种情况下,你已经丢失了数据。
问题:无法查看或编辑时序模型
你可能在访问时序见解 S1 或 S2 环境。
时序模型仅在即用即付环境中受支持。
你可能无权查看和编辑此模型。
用户需要有参与者级别访问权限才能编辑和查看其时序模型。 若要验证当前访问级别并授予其他访问权限,请在 Azure 门户中转到时序见解资源上的“数据访问策略”部分。
问题:第 2 代资源管理器中的所有实例都缺少父级
如果环境未定义时序模型层次结构,则可能会发生此问题。 有关详细信息,请了解如何使用时序模型。
后续步骤
阅读有关如何使用时序模型的信息。
了解支持的 JSON 形状。
查看 Azure 时序见解第 2 代中的规划和限制。