开发者中心

设备管理

概述

设备管理应用程序为您提供了一个您连接的设备的概述,并让您管理他们的健康。在设备管理中,你可以

以下各节将引领你通过应用程序的各种菜单。

手动连接到设备

本节描述设备手动连接到您的QuarkIoE帐户的一般程序。在程序的某些步骤可能是特定于您正在使用的设备的类型。在“设备指南”中找到您的设备类型,以找到更多的信息,或咨询您的设备的手册。

将设备连接到您的QuarkIoE帐户,点击“设备注册”导航和遵循这些步骤:

  1. 在“设备身份”文本字段中输入设备的身份证,然后单击“注册设备”。要确定身份证,请咨询设备文档。对于移动设备,ID通常是IMEI(国际移动设备识别码)设备背面经常发现。
  2. 你现在应该看到您的设备的IMEI号码上市现状与阅读“等待连接”。打开设备,等待建立连接。
  3. 设备连接后,状态应该更改为“等待接受”。您将需要确认,这确实是您要添加的设备,通过点击“绿色”“接受”按钮在您的设备的列表右边。
  4. 您的设备的状态现在应该读“接受”。一旦发生这种情况,您的设备将连接到您的帐户。

现在您准备好管理设备了。

设备注册

批量注册设备

连接更多的设备,你可以上传CSV文件的标识和证书。当上传CSV文件,QuarkIoE创建文件中列出的每个设备的用户帐户。设备可以安全地连接到QuarkIoE不用手动装置登记”的步骤,在上一节中描述的。

CSV文件需要有一个标题行后面的实际数据。标题行需要包含至少一个标记“标识”和一个标记“凭据”的列。这是一个有效的CSV格式的一个例子:


  ID;Credentials;Tenant;Group;ICCID;NAME
  006064ce800a;LF2PWJoLG1Fz;management;Sample_Düsseldorf;+491555555;Sample_Device1
  006064ce8077;OowoGKAbiNJs;management;Sample_Düsseldorf;+491555555;Sample_Device2
                        

使用“上传”按钮上传CSV文件,如下面的截图。在数据输入后,您将得到预先注册的设备的数量,以及可能发生的任何潜在错误。

批量注册

连接的装置,该装置需要预先设定的相关信息。更具体地说,每个设备都需要配置如下:

  • 用户名:用户名访问QuarkIoE必须符合一定形式<租户>/设备_<id>其中<租户> 是指在CSV文件中导入的租户, <id> 指CSV文件中相应的值。
  • 密码:访问QuarkIoE的密码,和CSV文件中“凭证”的值相同。
  • 托管对象表示的设备。字段:CSV文件中的"Type", "Name", "Iccid", "Idtype", "Path", "Shell"。

如果你拥有一个QuarkIoE专用或私有版,你也可以在多租户设备登记加入“租户”列的表格并从“管理”租户导入CSV文件。

有关文件格式的更多信息,请参见批量设备凭证

查看连接的设备

要查看连接的设备,您可以:

  • 选择“所有设备”,列出所有连接的设备(在一页上有1000个设备)。
  • 用“搜索”文本框搜索
  • 安排设备组和查看设备组。

在所有情况下,您将看到一个设备列表,如下面的示例所示。该列表由以下列组成:

  • 代表连接状态的图标,参看"连接监控"。
  • 设备的名称。
  • 根据浏览器的宽度显示模型和设备的序列号。
  • 该设备的报警状态,即,当前设备有多少未解决的严重的,主要的,次要的或警告级别的报警。看到"报警" 工作与警报的更多信息。
  • 删除设备的按钮。

请注意,删除设备意味着从QuarkIoE数据库包括所有数据删除装置。作为一种删除设备的替代方法,您也可以将设备安排成组,以便一组拥有不使用的所有历史设备。这使得历史报告仍然是正确的。为了防止警报从提出的设备,禁用连接监控监测。删除一个设备不删除其子设备的数据。

Device list

在一个列表中包含超过1000个条目,只有前1000个条目被显示。点击“加载更多”链接在底部加载下一个1000个条目。

搜索设备

QuarkIoE包括设备的全文搜索。通过输入搜索术语到 "search ..."文本字段,您可以找到包含该术语的所有设备。下面的图片显示了一个示例搜索包含"search ..."设备”。注意,你可以搜索一个设备的任何文本属性。前缀也支持。例如,一个“Ublox”也会返回包含“Ublox赠设备搜索”。中缀目前不支持。例如,搜索 "C027"不会返回"Ublox C027"。

设备分组

根据您的用例,设备可以任意组合。一个设备可以位于多个组,组本身可以再次成为多个组的一部分。

QuarkIoE顶层组和亚组之间的区别。顶层组显示在“组”的顶层的导航器中。他们是你的主要入口点。子群是用来进一步细分群体。

要创建一个顶级组,请单击右上角的“交叉”按钮,然后选择“添加新组”。小窗口会弹出。输入组名,并搜索应该添加到该组中的所需的设备。标记设备,并按“创建组与X设备”按钮来完成这个过程。(“X”将是您标记的设备的数量。)

注意可以建立一个组包含0个设备。

添加顶层群组

您还可以添加设备到一个组在两个其他方式:

  • 选择一个设备,并找到“信息”选项卡上的“组”部分。使用下拉菜单或“浏览组”按钮选择一组添加此设备。
  • 选择组,然后转到“子资产”,点击右上角的“分配设备”。搜索在搜索字段中添加的设备。然后标记结果中的相关设备,然后单击“指定X设备”按钮在结果列表底部的底部。

要创建一个分组,只需单击“添加组”查看一组。

要编辑一组,请单击该组的名称。这允许您编辑组的名称,并为该组分配用户权限。有关权限的更多信息,参见管理指南。

查看设备细节

通过在设备列表中单击一个设备,显示设备上的详细信息。什么是实际显示取决于设备和您的用户界面的配置。例如,如果一个设备还没有发送任何测量,就不会有“测量”标签。

在设备的顶部的详细信息显示,显示设备的名称。名字下面,显示一列面包屑。如果设备是资产阶层的一部分(如一组),你可以用面包屑轻松的导航浏览,层次。由于设备可以被包含在多个层次,可显示多行面包屑。

名字的权利,齿轮所示。点击齿轮显示进一步的行动,你可以进行下拉菜单,如创建一个仪表板的装置。

如果该设备是兼容的,一个“启动测量调查”菜单项可在齿轮。使用此项目,您可以请求一个特定的持续时间发送特定频率的测量。用这个调试简化,不会产生太多的数据流量。

Device details

设备的详细信息被划分在多个标签上。可能可见的标准标签如下:

信息

“信息”选项卡显示一个设备的通用信息(从顶部左到下):

  • 连接监控连接监控配置,更详细的信息查看连接监控
  • 名称类型: 用于编辑的设备的显示名称,以及特定类型设备的标识符。
  • 硬件: 从设备读取的硬件信息。
  • 移动:如果该设备包含一个调制解调器,移动网络信息将在这里显示。您还将看到一个“定位”链接在这里。如果有足够的信息可以获得,“定位”将确定粗定位装置的使用opencellid.org数据库。这不会总是成功的,并取决于连接的移动网络使用的格式报告其数据到调制解调器。
  • : 该设备是该设备的一部分。您可以在这里添加和删除组。更多信息,见"设备分组"。
  • 系统:这部分显示
    • 设备内部ID(例如:访问QuarkIoE的API)。
    • 设备"所有者"(QuarkIoE用户建立的设备)。
    • 上次更新设备数据的时间戳。
    • 一个按钮,断开设备,提供给管理员权限访问的用户和已连接设备使用的“设备注册"功能。
  • : 与你的同事共享文字注释。

虽然有许多其他领域该选项卡上编辑好,所以编辑如果设备本身并没有提供这方面的信息。如果设备提供此信息,您的编辑将从设备的信息被覆盖。要保存您的编辑,请单击屏幕底部的“保存更改”按钮。

请注意,“最后一次通信”和“最后更新”是两个完全不同的时间戳。最后的通信“表明当一个设备有最后一次发送的数据。”最后一次更新“表明设备的库存条目上次更新时”。此更新可能起源于设备,从Web用户界面或从另一个应用程序。

子设备

此选项卡显示与当前显示的设备连接的其他设备。例如,如果你看一个网关,标签列出了所有连接到网关的机器。

测量值

该选项卡提供了一个默认的可视化的数字数据提供的设备在图表的形式。图表分为类型的测量,它可以包含多个图形或“系列”。例如,下面的截图显示了一个图表的运动测量,包括在三个维度的加速度图,和一个图表与现代统计的形式的信号强度和比特错误率。

测量值

如果一个表包含不同单元图,Y轴呈现单位。例如,运动测量由三个参数组成的单位“平方米每平方秒”,所以只有一个轴被渲染。现代统计包括分贝毫瓦和%的误比特率的信号强度,所以一个轴是每个图形渲染。

要查看所测量值的详细信息,请将鼠标指针悬停在图表上。工具提示将显示在测量最接近你的光标的详细信息。(提示将“捕捉”到最近的测量。)

默认情况下,图表显示了最后一小时的原始数据。你可以改变时间范围X轴上通过点击下拉菜单阅读“最后时刻”。

如果你增加了时间范围,下拉菜单阅读“没有聚合”将切换到“小时”或“每日”。这意味着,该图表现在显示的范围,而不是个别的原始数据点。对于“每小时”,图表将显示一个小时内测量的最小值和最大值的范围。对于“每日”,图表将显示在一天测量的最小值和最大值。同样,提示现在将代替个人价值范围值显示。

这使您能够在更大的时间段获得一个有效的概述。可以手动更改使用下拉菜单的粒度。然而,一个图表将只显示在大多数5个数据点,以不超载您的桌面浏览器。如果选择一个细粒度导致超过5个数据点,则会显示一个警告消息:“数据被截断了。请使用聚合。”

点击“实时”按钮将启用实时用户界面更新的图表,新的数据流到系统从连接的设备。你可以影响图形显示和轴通过建立所谓的“关键绩效指标”的限制,看到 管理指南。

重要:为了看测试图,设备发送特定片段格式的测量,如

"fragment_name" : { "serie_name" : { "value" : ... "unit" : ... } }

实例:

"c8y_SpeedMeasurement": { "Speed": { "value": 1234, "unit": "km/h" } }

fragment_name和serie_name可以由不同的有效的JSON属性名称所取代,但这名不能包含空格和特殊字符,如[ ],*。结构是完全按照以上,二级深的JSON对象。

报警

“报警”选项卡显示了一个设备的报警。请参阅“使用报警”的更多信息。

控制

此选项卡列出被发送到设备或已发送到设备的操作。请参阅“操作”对操作的更多信息。

操作
软件

此选项卡允许您更新设备的固件和安装在设备上的软件。安装新的固件,点击“安装固件”,然后选择“从固件库中选择固件映像并单击“安装”按钮。

类似的,在设备上安装一个软件,点击“安装软件”,从软件库中选择一个软件包并单击“安装”按钮。悬停鼠标在一个特定的软件包,并单击“X”按钮,以删除设备的软件包。

软件

安装软件和固件通常包括设备的重新启动。要监视安装的进度,要访问“控件”选项卡。

事件

这个标签使设备低故障排除,更多信息请查看“设备故障定位"

位置

默认情况下的“位置”选项卡显示设备在地图上的位置的位置。对于不报告位置的设备,也可以手动设置位置。简单地将“引脚”放在显示的地图的正确位置上。

该选项卡显示了当设备包含c8y_position财产。当你发送一个新的c8y地位的事件,你也可以在设备设置相同的c8y_position片段有设备当前的位置标在地图上。

Shell

该设备 shell使您能够以交互方式与远程设备一起工作。许多工业设备都支持某种形式的命令语言,它是在命令调制解调器,许多跟踪设备或复杂的脚本机制如Tixi TiXML CSV方式命令。在 shell中,您可以在设备的各自语言中发送命令,并以交互方式查看命令的结果。

用户界面分为两部分:

  • 先前执行的命令的列表。默认情况下,最后的三个命令显示。
  • 命令提示输入新的命令,这些命令被添加到列表中。

在列表中,显示命令的状态、日期和文本。单击一个列表项显示命令的结果(如果它已被执行)。

设备命令行

在命令提示下,可以输入任意的命令文本。要将命令文本发送到设备,请单击“执行”按钮。“执行”按钮只能选择,如果设备是在线。

为了帮助您与命令语法,经常使用的命令是可用的一些设备通过点击“获取预定义”按钮。选择一个命令,然后单击“使用”将命令复制到命令提示,或选择“执行”命令直接执行命令。

命令行
权限

可以查看,编辑或控制某些设备可以仅限于用户和用户组。有关管理权限的详细信息,请访问管理指南。

追踪

设备可以记录他们的运动在QuarkIoE的历史。使用跟踪标签,您可以选择一个时间周期,并可视化在这个时间段内的设备的运动。运动被显示为地图上的红线。

旁边的地图,与他们的时间的个人记录(“位置更新事件”)。当您单击一个记录时,在地图上的一个“引脚”将显示在记录的时间位置。

跟踪标签表明了当设备包含c8y_position财产。

追踪根据设备并将其集成到QuarkIoE类型,您还可以配置设备侧的地理围栏和运动检测在这里。

此外,当激活该功能,并与兼容的设备,单元格的身份证信息可以被用来确定设备的位置。目前,服务来自Combain和Google的支持。在这种情况下,用户可以看到基于这两个数据的轨道,或筛选出基于全球定位系统的数据或基于单元的数据。

服务监控

除了连接的监控,QuarkIoE单独的服务监控机器的特点。更多信息查看“服务监控”的。

日志

使用“日志”选项卡,您可以从设备请求日志信息。日志信息可以根据日期范围、日志类型、关键字和最大行数的类型来过滤。

请求设备中的日志,

  • 选择日期和时间范围。
  • 选择日志类型。所支持的日志通常是设备特定的。
  • 输入一个可选的文本来过滤日志。例如,如果您输入“用户”,只有在他们的“用户”的单词“用户”将出现在返回的日志信息。
  • 选择要显示的最大行数(从最后计算)。
  • 单击“请求日志”。
请求

从设备请求日志可能需要一段时间。日志以后已经从设备转移到QuarkIoE,它会出现在下面的列表中选择控件。列表中的条目包括被查询的日志时间范围。单击列表中的条目以显示页面上的日志。悬停在条目上访问的下载和删除符号。使用下载的符号,你可以下载到你的本地电脑使用日志的删除符号,你可以删除日志文件。

身份

最后,QuarkIoE可以关联设备和多个外部身份资产。例如,设备通常可以通过Modem IMEI识别,通过单片机的串口数量以及资产标签。此选项卡列出了记录特定设备的所有标识。

例如,有用的,当你有坏的硬件,需要更换硬件,而不丢失记录的数据,到目前为止。只要将新的硬件连接到您的帐户,并修改旧硬件的身份进入,以包含新的硬件的身份。

连接监控

QuarkIoE能自动监测连接到您的设备。如果你想连接到一个设备进行监控,访问该设备的“信息”标签。在该选项卡上,检查顶部的“所需的间隔”字段。这个字段定义了你希望从设备中听到的。例如,如果你设定“需要的间隔”60、你认为设备进行至少一次在一个小时QuarkIoE。该间隔是由设备本身,根据设备的知识,它会尝试发送数据,或者它是由你手动设置的。

各种连接状态在下面的图片中说明。顶端的箭头代表流量的装置QuarkIoE。它可以是绿色的,红色的或灰色的。绿色意味着数据被发送在所需的时间间隔内。红色意味着它没有被发送在所需的时间间隔内。灰色意味着没有所需的间隔配置。

箭头表示推连接,用于从QuarkIoE发送命令到设备的状态(即连接/控制/通知API,不实时API)。它可以绿色或灰色。绿色意味着连接建立。灰色意味着连接不成立。在一个灰色箭头的情况下,无论是设备不支持推连接,或有一个错误。

“维护模式”是一个特殊的连接状态,表明该设备目前正在维护,不应该被监视。当正在维护一个设备时,没有提出该设备的警报。您可以通过设置所需的时间间隔到负值,使维护模式。

连接状态

请注意连接监控不是实时的。例如,当您关闭设备时,连接的状态不会立即改变。根据您的网络,它可能需要约20分钟,直到一个断开连接被发现,因为网络将重试发送一个显着的时间量的数据。

当设备检测到离线(停止发送数据,在规定的间隔和顶部的箭头变为红色),一个不可用的报警是为了设备阅读直到"&lt;time&gt;不与设备联通”。

服务监控

QuarkIoE区分连接监控,服务监控。连接监控仅仅表明装置与QuarkIoE,是否能履行其服务。

服务监控指示设备是否在服务中。例如,一台自动售货机在服务,如果它准备出售商品。自动售货机可以销售货物不--所以从商人是服务的角度与QuarkIoE使用现金。类似的,如果你在网关上关闭电源,网关后面的设备可能会继续工作。

QuarkIoE认为装置在服务而没有批判,为机目前尚未解决的报警。这被显示为一个共享的时间,这样的报警。如果一台机器在一段时间内没有任何关键的警报,它是100%的服务。如果一半的时间有一些关键的,未解决的报警,机器是50%的服务。

服务状态

当机器处于脱机状态,QuarkIoE假设默认情况下,它仍然停留在服务的状态,这是当它失去联系。也就是说,如果它被打破之前,它仍然被认为是坏的(除非你手动清除关键报警)。如果它之前工作,它仍然被认为是工作。

这可能不是你的设备的情况下,或你的用例。例如,如果你的自动售货机完全依靠现金支付,失去网络连接意味着你不能从机器购买了。因此,机器应该被视为服务。在这种情况下,配置不可用报警等级从"重要"变为"严重",根据应用管理

QuarkIoE可以对单个设备的水平或在所有设备上显示服务的可用性。如果在导航器中选择“服务监控”,则显示在所有设备上的整体服务。在该页面上,您还将看到在过去的一个月内有多少设备有什么服务可用性的直方图(见上面的截图)。

定位设备

通过点击导航器中的“地图”,你的帐户中的所有设备的地图显示。设备被显示为“引脚”,你可以点击查看设备的名称。单击设备的名称将带您到设备的详细视图。通过点击“实时”复选框,地图会自动刷新当设备移动。

使用报警

设备可以提高所谓的警报,表明有一个问题,需要人为干预。您可以查看警报

  • 通过点击“唯一未解决”的“报警”选项卡上看到的所有设备的警报尚未被清除。
  • 通过点击导航器中的“警报”,查看整个报警历史,无论是否已清除警报。
  • 通过点击一个设备,并选择“报警标签”,以查看该特定设备的报警。默认情况下,只有未解决的警报显示,但您可以禁用“悬而未决”复选框查看所有警报。

报警显示分为四个部分,分别列出不同优先级的报警。在每一节中,最新的报警显示第一个。下面的图像显示了点击后的警报的详细显示。详细视图包含以下项目:

  • 报警的严重程度:报警的严重程度。QuarkIoE报警等级为:
    • 严重: 设备不能服务并需要立刻维修。
    • 重要: 设备出现问题并应该被修好。
    • 次要: 设备出现问题并可能被修好。
    • 警告: 有个警告
  • 状态: 报警状态。一个报警可以:
    • 激活: 当报警出现并没有人正在处理的时候。
    • 已知: 当某人点击了"已知"按钮,表明他正在解决这个报警。
    • 清除: 当某人点击"清除"按钮手动清除报警或设备检测到问题已经解决。
  • 计数: 设备发送报警的次数。QuarkIoE去重复报警,只有一个特定的报警可以为特定的设备激活。如果同一类型的另一个报警是由设备发送的,则计数增加。
  • 描述: 报警文字描述。
  • 设备: 设备名。点击名称可让您查看设备细节。
  • 建立日期: 报警建立时的时间戳。
  • 类型: 报警类型。这个文本使用复制报警和优先级配置在应用管理中。
  • 附加信息: 报警可以包含由设备提供的任意附加信息。
  • 审计日志: 存储报警的日志随着报警变化。当发生时可以用来看看是谁创建,更新,并清除了一个报警。
报警显示

使用操作

操作用于远程控制设备。您可以单击导航器中的“设备控制”菜单,查看已发送到设备的所有操作,并且仍在等待发送到设备上的队列。类似的,你可以选择一个特定设备的“控制”标签来查看设备的操作。

操作可以在任意4个状态下执行:

  • 挂起: 操作刚刚被创建,并等待设备来选择它。
  • 执行: 该操作已被设备拾取,并正在执行。
  • 成功: 该操作已成功地通过该设备执行。
  • 失败: 该操作已被设备拾取,并正在执行。

点击一个操作显示操作的参数。例如,点击一个配置操作将显示发送到设备的配置。点击一个失败的操作显示失败的原因。

“所有”按钮显示设备的所有操作,无论它们是否已被处理过。请注意,操作列在他们已排队的顺序为一个设备与最古老的顶部。严格执行本命令的操作。

操作

处理批量操作

为了便于处理设备QuarkIoE功能“批量操作”。与“批量操作”,您现在可以轻松地为整个组中的每个设备执行操作。

对整个组执行批量操作:

  • 选择一个设备,并导航到“控制”选项卡
  • 创建一个操作
  • 停留在要执行的操作上
  • 点击齿轮标志
  • 点击“执行整个组”
执行批量操作

有关活动的更多信息参见使用操作

为了查看您的操作的状态和进度只需点击所需的组,然后点击“批量操作”。

批量操作选项卡

批量操作也可以编辑。要编辑操作悬停在所需的操作上,然后单击蓝色标记按钮。新的窗口将弹出。”“开始日期”和“延迟”值可以更改。要更改操作细节,请单击“显示操作细节”。准备好后,点击“重新安排”申请变更,或单击“取消”以放弃更改。

点击×按钮删除操作

设备问题定位

事件是由通常用于特定应用程序处理的设备发送的低级别的消息。例如,一个自动售货机以事件的形式发送其实时销售。如果您需要在一个更详细的级别上对一个设备进行故障排除,访问“事件”选项卡。单击单个事件将显示事件中包含的数据的更多信息。类似的,您可以通过在导航器中选择“事件”来查看所有设备的所有事件。

由于设备可能会发送大量的事件数据,您可以筛选日期显示的数据。你也可以点击“实时”复选框看到事件从设备实时在未来。

管理设备固件和软件

QuarkIoE提供收集在“固件库”和“软件仓库设备参考固件和软件中心的地方”。

要更新固件或在一个特定的设备上添加软件包,你必须遵循三个步骤:

  1. 上传固件或软件在管理应用。(这一步是可选的,并不是强制性的,因为制造商可能会提供固件在线。)
  2. 选择并保存“固件库”中的文件。要在存储库中添加一个新的固件映像,请访问“固件库”,然后单击“添加固件”按钮。然后键入固件的名称,它的版本和该设备可以从中下载固件的网址。类似使用“软件库”来添加参考软件包。
  3. 在一个特定的设备上安装固件。首先导航到“所有设备”,选择所需的设备,然后去“软件”的设备上的细节,并点击“安装固件”。类似的安装软件包,但点击“安装软件”,而不是。(更多信息关于这个步骤请参阅 "软件"。)

请注意,您目前有参观管理应用来存储二进制文件在QuarkIoE。

QuarkIoE为用户提供的能力来执行固件或软件更新多个设备同时。这样做:

  • 在一个单一的设备上执行软件更新,以测试新版本是否真的有效。
  • 导航到操作并选择“执行整个组”。
  • 请填写表格以安排批量操作,然后单击“创建”按钮。

操作状态可以在“批量操作”选项卡的选定组的名称下查看。

有关批量操作的更多信息,参见处理批量操作。

管理设备凭证

“设备证书”菜单列出了已为您的连接设备生成的所有凭证。每个注册的设备出现在命名约定"device_<id>"。

在大多数情况下,你不需要修改任何东西。例外的是:

  • 您已经在一个设备上进行了一个工厂复位。在这种情况下,该设备将经常松开其分配的凭据。找到凭据,单击“X”按钮删除证书以及在QuarkIoE。然后继续正常 注册流程重新登记的装置。
  • 您想暂时断开设备。在这种情况下,单击设备证书旁边的“停用”按钮。
  • 您希望为单个设备分配更多的权限。在这种情况下,请单击“设备证书”,并选择设备的额外的或不同的用户组。
批量设置

设备凭证也可以从CSV文件提供。可以上传文件用的按钮用箭头键指向。在文件结构的更多细节,可以参照以上的批量注册设备