诊断和排查 Azure 时序见解第 2 代环境的问题Diagnose and troubleshoot an Azure Time Series Insights Gen2 environment

本文汇总了在使用 Azure 时序见解第 2 代环境时可能会遇到的若干常见问题。This article summarizes several common problems you might encounter when you work with your Azure Time Series Insights Gen2 environment. 本文还介绍了每个问题的可能原因和解决方案。The article also describes potential causes and solutions for each problem.

问题:在第 2 代资源管理器中找不到环境Problem: I can't find my environment in the Gen2 Explorer

如果无权访问时序见解环境,则可能会发生此问题。This problem might occur if you don't have permissions to access the Time Series Insights environment. 用户需要读者级别访问角色才能查看其时序见解环境。Users need a reader-level access role to view their Time Series Insights environment. 若要验证当前访问级别并授予其他访问权限,请在 To verify the current access levels and grant additional access, go to the Data Access Policies section on the Time Series Insights resource in the Azure portal.

验证数据访问策略。Verify data access policies.

问题:第 2 代资源管理器中未显示数据Problem: No data is seen in the Gen2 Explorer

有几种常见原因导致数据可能不会出现在 Azure 时序见解第 2 代资源管理器中。There are several common reasons why your data might not appear in the Azure Time Series Insights Gen2 Explorer.

  • 事件源可能未接收数据。Your event source might not be receiving data.

    验证事件源(即事件中心或 IoT 中心)是否从标记或实例接收数据。Verify that your event source, which is an event hub or an IoT hub, is receiving data from your tags or instances. 若要进行验证,请转到 Azure 门户中资源的概览页。To verify, go to the overview page of your resource in the Azure portal.

    查看仪表板指标概述。Review dashboard metrics overview.

  • 事件源数据不是 JSON 格式。Your event source data isn't in JSON format.

    时序见解仅支持 JSON 数据。Time Series Insights supports only JSON data. 有关 JSON 示例,请阅读支持的 JSON 形状For JSON samples, read Supported JSON shapes.

  • 事件源密钥缺少所需权限。Your event source key is missing a required permission.

    • 对于 IoT 中心,需提供具有“服务连接” 权限的密钥。For an IoT hub, you need to provide the key that has service connect permission.

      验证 IoT 中心权限。Verify IoT hub permissions.

      • “iothubowner”和“服务”策略均可使用,因为两者都具有“服务连接”权限 。Both the policies iothubowner and service work because they have service connect permission.
    • 对于事件中心,需提供具有“侦听” 权限的密钥。For an event hub, you need to provide the key that has Listen permission.

      查看事件中心权限。Review event hub permissions.

      • “读取”和“管理”策略均可使用,因为两者都具有“侦听”权限 。Both the Read and Manage policies work because they have Listen permission.
  • 提供的使用者组并非时序见解所独有。Your consumer group provided isn't exclusive to Time Series Insights.

    IoT 中心或事件中心注册期间,请指定用于读取数据的使用者组。During registration of an IoT hub or event hub, you specify the consumer group that's used to read the data. 此使用者组必须在环境中独一无二。This consumer group must be unique per environment. 如果共享了此使用者组,则基础事件中心会随机自动断开一个读取器的连接。If the consumer group is shared, the underlying event hub automatically disconnects one of the readers at random. 请提供唯一的使用者组,供时序见解从中读取。Provide a unique consumer group for Time Series Insights to read from.

  • 在预配时指定的时序 ID 属性不正确、缺失或为 null。Your Time Series ID property specified at the time of provisioning is incorrect, missing, or null.

    如果在预配环境时时序 ID 属性配置不正确,则可能会发生此问题。This problem might occur if the Time Series ID property is configured incorrectly at the time of provisioning the environment. 有关详细信息,请阅读选择时序 ID 的最佳做法For more information, read Best practices for choosing a Time Series ID. 目前无法更新现有时序见解环境来使用其他时序 ID。At this time, you can't update an existing Time Series Insights environment to use a different Time Series ID.

问题:显示了一些数据,但是还有一些数据缺失Problem: Some data shows, but some is missing

可能在发送数据时没有提供时序 ID。You might be sending data without the Time Series ID.

  • 如果在发送事件时有效负载中没有时序 ID 字段,则可能会发生此问题。This problem might occur when you send events without the Time Series ID field in the payload. 有关详细信息,请阅读支持的 JSON 形状For more information, read Supported JSON shapes.

  • 可能因环境受限而发生此问题。This problem might occur because your environment is being throttled.

    备注

    目前,时序见解支持的最大引入速率为 6 Mbps。At this time, Time Series Insights supports a maximum ingestion rate of 6 Mbps.

问题:以前可以显示数据,但引入现已停止Problem: Data was showing, but now ingestion has stopped

  • 可能已重新生成事件源密钥,并且第 2 代环境需要新的事件源密钥。Your event source key may have been regenerated and your Gen2 environment needs the new event source key.

如果创建事件源时提供的密钥不再有效,则会出现此问题。This problem occurs when the key provided when creating your event source is no longer valid. 你会在中心看到遥测数据,但不会在时序见解中收到入口接收的消息。You would see telemetry in your hub but no Ingress Received Messages in Time Series Insights. 如果不确定是否重新生成了密钥,可以在事件中心的活动日志中搜索“创建或更新命名空间授权规则”或“为 IoT 中心创建或更新 IotHub 资源”。If you are unsure whether or not the key was regenerated, you can search your Event Hubs' Activity log for "Create or Update Namespace Authorization Rules" or search "Create or update IotHub Resource" for IoT hub.

若要用新密钥更新时序见解第 2 代环境,请在 Azure 门户中打开中心资源并复制新密钥。To update your Time Series Insights Gen2 environment with the new key open your hub resource in the Azure portal and copy the new key. 导航到 TSI 资源,单击“事件源”。Navigate to your TSI resource and click on Event Sources.

屏幕截图显示了已标注“事件源”菜单项的 TSI 资源。Screenshot shows T S I resource with Event Sources menu item called out.

选择已停止从其引入的事件源,粘贴新密钥,然后单击“保存”。Select the event source(s) that have from which ingestion has stopped, paste in the new key and click Save.

屏幕截图显示了已输入了 IoT 策略密钥的 TSI 资源。Screenshot shows T S I resource with I o T hub policy key entered.

问题:事件源的时间戳属性名称不起作用Problem: My event source's Timestamp property name doesn't work

请确保名称和值符合以下规则:Ensure that the name and value conform to the following rules:

  • Timestamp 属性名称区分大小写。The Timestamp property name is case sensitive.
  • 来自事件源的 Timestamp 属性值(采用 JSON 字符串形式)的格式为 yyyy-MM-ddTHH:mm:ss.FFFFFFFKThe Timestamp property value that comes from your event source as a JSON string has the format yyyy-MM-ddTHH:mm:ss.FFFFFFFK. "2008-04-12T12:53Z" 是此类字符串的一个示例。An example of such a string is "2008-04-12T12:53Z".

使用时序见解第 2 代资源管理器是确保捕获 Timestamp 属性名称并让该属性正常工作的最简单方法。The easiest way to ensure that your Timestamp property name is captured and working properly is to use the Time Series Insights Gen2 Explorer. 在时序见解第 2 代资源管理器中使用此图表,在提供 Timestamp 属性名称以后选择一个时间段。Within the Time Series Insights Gen2 Explorer, use the chart to select a period of time after you provided the Timestamp property name. 右键单击所做的选择,然后选择“浏览事件”选项。 Right-click the selection, and select the explore events option. 第一个列标头为 Timestamp 属性名称。The first column header is your Timestamp property name. 它应该有 ($ts) 位于 Timestamp 一词的旁边,而不是:It should have ($ts) next to the word Timestamp, rather than:

  • (abc),指示时序见解将数据值作为字符串来读取。(abc), which indicates that Time Series Insights reads the data values as strings.
  • 日历 图标,指示时序见解将数据值作为日期/时间来读取。The calendar icon, which indicates that Time Series Insights reads the data value as datetime.
  • #,指示时序见解将数据值作为整数来读取。#, which indicates that Time Series Insights reads the data values as an integer.

如果 Timestamp 属性未显式指定,则会将事件的 IoT 中心或事件中心的“排队时间”用作默认的时间戳。If the Timestamp property isn't explicitly specified, an event's IoT hub or event hub Enqueued Time is used as the default time stamp.

问题:我无法在资源管理器中查看我的暖存储中的数据Problem: I can't view data from my warm store in the Explorer

  • 你可能最近预配了你的暖存储,数据仍在流入。You might have provisioned your warm store recently, and data is still flowing in.
  • 你可能已删除了暖存储,这种情况下,你已经丢失了数据。You might have deleted your warm store, in which case you would have lost data.

问题:无法查看或编辑时序模型Problem: I can't view or edit my Time Series Model

  • 你可能在访问时序见解 S1 或 S2 环境。You might be accessing a Time Series Insights S1 or S2 environment.

    时序模型仅在即用即付环境中受支持。Time Series Models are supported only in pay-as-you-go environments.

    环境中没有事件。No events in environment.

  • 你可能无权查看和编辑此模型。You might not have permissions to view and edit the model.

    用户需要有参与者级别访问权限才能编辑和查看其时序模型。Users need contributor-level access to edit and view their Time Series Model. 若要验证当前访问级别并授予其他访问权限,请在 Azure 门户中转到时序见解资源上的“数据访问策略”部分。 To verify the current access levels and grant additional access, go to the Data Access Policies section on your Time Series Insights resource in the Azure portal.

问题:第 2 代资源管理器中的所有实例都缺少父级Problem: All my instances in the Gen2 Explorer lack a parent

如果环境未定义时序模型层次结构,则可能会发生此问题。This problem might occur if your environment doesn't have a Time Series Model hierarchy defined. 有关详细信息,请了解如何使用时序模型For more information, read about how to work with Time Series Models.

无父级实例将显示警告。Unparented instances will display a warning.

问题:Power BI 连接器显示“无法连接”Problem: Power BI Connector shows "Unable to Connect"

如果未在 Power BI Desktop 中使用最新版本的 Power BI 连接器,可能会出现此问题。This problem might occur if you are not using the latest version of the Power BI Connector in Power BI Desktop.

屏幕截图显示了“无法连接”对话框。Screenshot shows the Unable to connect dialog box.

  • 请检查 Power BI Desktop 的版本,并确保使用的是 2020 年 7 月版。Check the version of your Power BI Desktop and make sure that you're using the July 2020 Version. 如果不是,请更新 Power BI Desktop 并再次运行该连接器。If not, update your Power BI Desktop and run the connector again.

后续步骤Next steps