You need to enable JavaScript to run this app.
导航

创建北向通道

最近更新时间2023.11.17 10:44:35

首次发布时间2023.06.09 19:27:53

北向通道指设备数据的上报通道。 现场设备连接到边缘一体机后,设备数据将由一体机采集。 只有在一体机上部署北向通道,才能使一体机采集的数据上报给不同类型的业务应用进行消费。

支持的北向通道

根据设备数据上报的目的地,北向通道分为以下类型。

类型说明使用前提
Http将边缘侧设备的属性数据通过 Http 协议上报到您的 Web 服务。您已经搭建 Web 服务,并获取了 Web 服务的 Url。
Influxdb将边缘侧设备的属性数据上报到 InfluxDB 数据库进行实时分析。您已经搭建了 InfluxDB 数据库并获取了 InfluxDB 数据库的以下参数值:Url、Token、Organization、Bucket、Measurement。
Kafka将边缘侧设备的属性数据上报到 Kafka 消息系统进行处理。您已经搭建了 Kafka 系统并获取了 Kafka 系统的以下参数值:Address、Topic。
数据上云将边缘侧设备的属性数据上报到边缘智能控制台,以便在控制台查看设备运行数据。
直播上云将边缘侧视频流设备的流数据上报到边缘智能控制台,以便在控制台查看设备的直播视频。
火山视频直播将边缘侧视频流设备的流数据推送到火山引擎视频直播产品。您已经在火山引擎视频直播产品中添加了推流域名并获取了火山引擎账号的 API 访问凭证。
阿里云物联网平台将边缘侧设备的信息同步到阿里云物联网平台。您已经在阿里云物联网平台开通了实例并获取了阿里云账号的 API 访问凭证。

使用限制

在一个项目下,同一类型的北向通道只允许创建一个。(您可以将北向通道部署到一个项目下的多台一体机上运行。)

操作步骤

  1. 登录边缘智能控制台

  2. 在左侧导航栏顶部的 我的项目 区域,选择您的项目。

  3. 在左侧导航栏,选择 设备管理 > 北向通道

  4. 北向通道 页面,单击 创建北向通道

  5. 创建北向通道 页面,根据以下配置说明完成相关配置。

    区域配置项说明

    基本信息

    名称

    为北向通道设置一个名称。输入要求如下:

    • 允许使用英文大小写字母、数字、下划线(_)、连字符(-)。长度不超过 32 个字符。
    • 特殊字符不允许出现在开头或结尾,且不能连用。
    类型选择北向通道的类型。关于支持的北向通道的说明,请参见支持的北向通道

    参数

    根据您选择的 类型,配置相关的通道参数。
    通道参数用于指定数据上报的目的地。北向通道类型不同,您需要配置的通道参数不同。详情参见部署说明

    说明

    类型数据上云直播上云 时,该配置项不会显示,您无需配置通道参数。

    断点续传

    选择是否开启断点续传。断点续传可有效避免因网络故障导致的数据传输中断,提高数据传输的稳定性。
    断点续传默认是开启的。因网络故障导致数据传输中断时,系统会将要上报的数据暂存在本地;当网络恢复时,系统自动重新上报暂存的数据。支持续传的数据的大小一般不超过 1 GB。

    说明

    类型直播上云火山视频直播 时,该配置项不会显示。

    描述

    为北向通道添加描述。
    允许使用任意字符。长度不超过 128 个字符。

    部署到一体机N/A从一体机列表中选择一个或多个一体机,部署该北向通道。
  6. 单击 确定

操作完成后,系统将在一体机上部署北向通道。您可以在 北向通道 页面查看 部署状态。部署状态展示了北向通道的部署完成情况,“运行中” 的数量表示已成功部署了北向通道的一体机的数量。

alt

部署说明

本章节介绍创建不同类型北向通道时,您需要配置哪些通道参数,以及部署成功北向通道后,您如何来验证通道已正常工作。

部署 Http 北向通道

参数说明

创建 Http 类型的北向通道时,您需要配置以下通道参数:

  • url:您的 Web 服务的 http/https 访问地址。

验证方法

如果您的 Web 服务接收到来自边缘一体机的数据,表示通道在正常工作。

部署 Influxdb 北向通道

参数说明

创建 Influxdb 类型的北向通道时,您需要配置以下通道参数:

  • urls:您的 InfluxDB 实例的 URL。允许输入多个 URL。多个 URL 之间使用半角逗号(,)分隔。关于 URL 的更多信息,请参见 InfluxDB 官方文档:InfluxDB URLs
  • token:您的 InfluxDB API Token。更多信息,请参见 InfluxDB 官方文档:View tokens
  • organization:拥有 Bucket 的组织。
  • bucket:数据写入到的 Bucket。

说明

您可以使用 Telegraf 插件导出 InfluxDB 的配置信息。更多信息,请参见 InfluxDB 官方文档:Manually configure Telegraf

验证方法

通道部署成功后,您可以登录 InfluxDB 服务查看数据。当您在 InfluxDB 服务中查看到一体机上报的设备运行数据,表示通道在正常工作。

部署 Kafka 北向通道

创建 Kafka 类型的北向通道时,您可以选择以下方式进行配置:参数、文件。

参数配置

使用参数方式配置时,您需要配置以下通道参数:

文件配置

使用文件方式配置时,您可以使用一个参数模板来配置更多的 Kafka 相关参数。选择 配置方式文件 后,您可以查看 配置文件示例,基于示例填写配置参数。

例如,如果您使用火山引擎 Kafka 服务,您可以通过文件方式配置以下参数:

brokers: 
  - kafka-****.kafka.volces.com:9492
  - kafka-****.kafka.volces.com:9493
  - kafka-****.kafka.volces.com:9494
topic: 628test
sasl_mechanism: SCRAM-SHA-256
sasl_username: ve****
sasl_password: 628****
data_format = "json"

alt

验证方法

通道部署成功后,您可以登录 Kafka 服务查看数据。当您在 Kafka 服务中查看到一体机上报的设备运行数据,表示通道在正常工作。

部署数据上云北向通道

参数说明

创建数据上云类型的北向通道时,您无需配置通道参数。

验证方法

通道部署成功后,您可以登录边缘智能控制台,并前往 设备实例 的 运行状态 页面。当您在该页面查看到一体机上报的设备数据,表示通道在正常工作。

部署直播上云北向通道

参数说明

创建直播上云类型的北向通道时,您无需配置通道参数。

验证方法

通道部署成功后,您可以登录边缘智能控制台,并前往一体机的 设备接入 页面。如果您在该页面能够查看视频流设备的 直播 数据,表示通道在正常工作。

部署火山视频直播北向通道

参数说明

创建火山视频直播类型的北向通道时,您需要配置以下通道参数:

  • Access Key ID 和 Secret Access Key:火山引擎主账号或 IAM 用户的 API 访问凭证(即 Access Key)。

    注意

    如果提供 IAM 用户的 Access Key,您必须确保 IAM 用户对火山引擎视频直播产品有访问权限。

    关于如何获取 Access Key,请参见 Access Key 管理
  • Push Domain:您在火山引擎视频直播中配置的推流域名。
    更多信息,请参见添加域名

验证方法

通道部署成功后,边缘一体机上接入的设备的流数据将被推送到火山引擎视频直播产品。您可以登录火山引擎视频直播控制台,并访问 直播管理 > 流管理 页面。
如果您发现视频流设备的流数据出现在 在线流 列表,表示通道已经正常工作。其中,StreamName 对应于一体机上接入的视频流设备的名称。

alt

您可以单击 直播地址,获取在线流的 FLV 地址,然后使用 VLC 播放器查看直播视频。

alt

部署阿里云物联网平台北向通道

注意

如需使用阿里云物联网平台北向通道,则您的设备模板及实例必须遵循阿里云物联网平台的相关要求。

参数说明

创建阿里云物联网平台类型的北向通道时,您需要配置以下通道参数:

  • Accesskey ID 和 Accesskey Secret:阿里云主账号或 RAM 用户的 API 访问凭证(即 AccessKey)。

    注意

    如果提供 RAM 用户的 Accesskey,您必须确保 RAM 用户对阿里云物联网平台有访问权限。

    关于如何获取 AccessKey,请参见阿里云官方文档
  • Instance ID:您在阿里云物联网平台所使用的实例的ID。
    关于阿里云物联网平台实例的说明,请参见阿里云官方文档
  • Region:实例所属地域的代码。例如,cn-shanghai表示上海。
    关于地域代码的说明,请参见阿里云官方文档

验证方法

通道部署成功后,边缘一体机上接入的设备信息将被同步到阿里云物联网平台。您可以登录阿里云物联网平台控制台并访问您的实例。如果您发现以下现象,表示通道已经正常工作:

  • 边缘一体机上接入的设备出现在阿里云物联网实例的 设备 列表。
  • 设备对应的边缘智能设备模板出现在 产品 列表。

    说明

    边缘智能的 设备模板 对应于阿里云物联网平台的 产品,设备模板的 物模型定义 对应于产品的 功能定义

如果您在边缘智能控制台修改了设备模板、设备的属性,您可以在阿里云物联网平台中看到对应产品、设备的属性同步发生变更。如果您将部署在一体机上的北向通道移除,那么同步到阿里云物联网平台上的产品和设备将被删除。

注意

如果您发现边缘智能控制台新增的属性没有在阿里云物联网平台生效,这可能是因为一体机上的设备驱动没有感知设备模板的变更,这种情况下您可以重新部署设备驱动。