将 IoT 中心事件源添加到 Azure 时序见解环境

注释

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

本文介绍如何使用 Azure 门户将从 Azure IoT 中心读取数据的事件源添加到 Azure 时序见解环境。

注释

本文中的说明对于 Azure 时序见解第 1 代和 Azure 时序见解第 2 代环境都适用。

先决条件

  • 创建 Azure 时序洞察环境
  • 使用 Azure 门户创建 IoT 中心
  • IoT 中心必须有正在发送进来的活跃消息事件。
  • 在 IoT 中心创建专用使用者组,以供 Azure 时序见解环境使用。 每个 Azure 时序见解事件源都必须具有自己的专用使用者组,该组不与其他使用者共享。 如果多个读取器从同一消费者组中读取事件,则所有读取器都可能会发生故障。 有关详细信息,请阅读 Azure IoT 中心开发人员指南

将使用者组添加到 IoT 中心

应用程序使用使用者组从 Azure IoT 中心提取数据。 若要可靠地从 IoT 中心读取数据,请提供一个专用的使用者组,该使用者组仅供此 Azure 时序见解环境使用。

若要将新的使用者组添加到 IoT 中心,请执行以下操作:

  1. Azure 门户中,查找并打开 IoT 中心。

  2. 在“设置”下,选择“内置终结点”,然后选择“事件”终结点

    在“内置终结点”页上,选择“事件”按钮

  3. “使用者组”下,为使用者组输入唯一名称。 创建新的事件源时,请在 Azure 时序见解环境中使用此相同名称。

  4. 选择 保存

添加新事件源

  1. 登录 Azure 门户

  2. 在左侧菜单中,选择“所有资源” 。 选择您的 Azure 时序见解环境。

  3. 在“设置”下,依次选择“事件源”、“添加”。

    选择“事件源”,然后选择“添加”按钮

  4. 在“新建事件源”窗格中,输入一个特定于此 Azure 时序见解环境的名称作为“事件源名称”。 例如,输入 event-stream

  5. 对于,请选择IoT 中心

  6. 为“导入选项”选择一个值:

    • 如果您在某个订阅中已有 IoT 中心,请选择“从可用订阅使用 IoT 中心”。 此选项是最简单的方法。

      在“新建事件源”窗格中选择选项

    • 下表描述了“通过可用订阅使用 IoT 中心”选项所需的属性:

      “新建事件源”窗格 - 需要在“通过可用订阅使用 IoT 中心”选项中设置的属性

      财产 说明
      订阅 所需的物联网中心所属的订阅。
      IoT 中心名称 所选物联网中心的名称。
      IoT 中心策略名称 选择共享访问策略。 可以在 IoT 中心设置选项卡上找到共享访问策略。每个共享访问策略具有名称、所设权限以及访问密钥。 事件源的共享访问策略必须具有服务连接权限
      IoT 中心策略密钥 密钥已预填充。
    • 如果 IoT 中心在订阅外部,或者你希望选择高级选项,请选择“手动提供 IoT 中心设置”

      下表介绍“手动提供 IoT 中心设置”所需的属性:

      财产 说明
      订阅识别号 所需的物联网中心所属的订阅。
      资源组 创建 IoT 中心的资源组名称。
      IoT 中心名称 IoT 中心的名称。 创建 IoT 中心时,为 IoT 中心输入了一个名称。
      IoT 中心策略名称 共享访问策略。 可以在 IoT 中心设置选项卡上创建共享访问策略。每个共享访问策略具有名称、所设权限以及访问密钥。 事件源的共享访问策略必须具有服务连接权限
      IoT 中心策略密钥 用于对 Azure 服务总线命名空间的访问权限进行身份验证的共享访问密钥。 在此处输入主密钥或辅助密钥。
    • 这两个选项共享以下配置选项:

      财产 说明
      IoT 中心使用者组 从 IoT 中心读取事件的使用者组。 强烈建议为事件源使用专用使用者组。
      事件序列化格式 目前,JSON 是唯一可用的序列化格式。 事件消息必须采用此格式,否则将无法读取任何数据。
      Timestamp 属性名称 若要确定此值,需要了解发送到 IoT 中心的消息数据的消息格式。 此值是消息数据中特定事件属性 名称,您希望用作事件时间戳。 该值区分大小写。 如果留空,则事件源中的 事件排队时间 用作事件时间戳。
  7. 将已添加到 IoT 中心的专用 Azure 时序见解消费者组名称添加进去。

  8. 选择 创建

  9. 创建事件源以后,Azure Time Series Insights 就会自动开始将数据流式传输到您的环境中。

后续步骤