追踪间距检测器处理器用于检测事件数据中事件的缺失。 类似于事件检测器处理器,从追踪间距检测器发送的事件记录不是由该处理器接收的事件记录的副本(或衍生物)。 从该处理器发送的事件记录与安装 GeoEvent Server 时创建的 TrackGap GeoEvent 定义有关。
示例
以下是追踪间距检测器处理器的用例:
- 追踪间距检测器处理器可用于监控车队的持续状态。 例如,每辆车可以每 30 分钟报告一次状态更新。 如果车辆自上次报告其状态后已行驶 30 分钟以上,则此处理器生成的间距事件可帮助指示车辆已禁用并需要帮助。
- 该处理器可用于监控来自固定传感器的定期数据生成。 例如,连接到敏感设备的压力表可能会以固定间隔报告数据。 如果在给定的时间段后压力表未能报告信息,则说明压力表有故障或压力已超过安全阈值。 在这两种情况下,间距事件均可用于触发即时通知以检查传感器并保护敏感设备。
用法说明
使用追踪间距检测器处理器时,请记住以下事项:
- 发送到追踪间距检测器处理器的事件记录必须具有一个包含 TRACK_ID 标签的 GeoEvent 定义。 该处理器标记追踪 ID 的字段确定不再接收事件记录的时间。 处理器必须至少接收到一个带有给定追踪 ID 的事件记录,才能检测出追踪中缺失的事件记录。
- 从该处理器发送的事件记录与安装 GeoEvent Server 时创建的 TrackGap GeoEvent 定义有关。
- TrackGap GeoEvent 定义的方案如下所示。 处理器发送的事件记录将遵循此方案,而非原始源方案。
名称 | 描述 | 类型 |
---|---|---|
trackID | 指定用于唯一标识追踪资产的值。 发送到处理器的事件记录必须具有标记有追踪 ID 的字段。 TRACK_ID 标签将应用于处理器创建的间距事件的此字段。 | 字符串 |
间距 | 设置为 True 的标记用于表示事件记录满足间距条件。 设置为 False 的标记用于表示间距条件已结束。 | 布尔 |
lastReceived | 在满足间距条件之前,最后一次接收事件记录的日期时间。 | 日期 |
几何 | 与来自处理器的间距事件记录关联的几何。 处理器将最后收到的事件记录中的几何附加到它生成的间距事件中。 GEOMETRY 标签将应用于处理器创建的间距事件的此字段。 | 几何 |
- 必须指定间距持续时间(秒)和间距检测间隔(秒)参数的值:
- 间距持续时间(秒)参数可指定处理器在确定预期数据未被接收前要等待的秒数。
- 间距检测间隔(秒)参数可指定每次轮询间隔的秒数。 例如,假定将处理器的间距检测间隔配置为 120 秒、间距持续时间为 300 秒,则处理器将每 2 分钟(120 秒)检查一次所接收的事件记录的内部注册情况,以查看在过去 5 分钟(300 秒)内是否未观测到注册表中的任何追踪 ID。
- 间距检测间隔还控制通知生成的频率。 将间距通知模式参数设置成连续之后,将在每次轮询每个预期(而不是最近收到的)追踪 ID 的处理器内部注册表时生成新的间距事件。 如果要求在首次检测到间距时发出单个通知,然后在再次收到预期事件记录时发出第二个事件通知,请为间距通知模式参数指定更改时。
- 在配置处理器时,可以指定包含几何的事件记录字段。 如果已指定事件记录字段名称,则该处理器会将最新收到的事件记录中的几何追加到处理器生成的间距事件中。 例如,如果数据源报告车辆位置,并且处理器被配置为每隔 30 秒进行一次轮询以确定自上次接收车辆报告以来是否存在至少 120 秒的间距,则可将处理器配置为包含最后报告的车辆位置及其间距通知事件。
- 几何字段参数将显示具有几何数据类型的每个 GeoEvent 定义中每个字段的名称。 按名称选择几何字段时,请选择与事件记录的 GeoEvent 定义相对应的正确几何字段的名称。
参数
以下是追踪间距检测器处理器的参数:
参数 | 描述 |
---|---|
名称 |
用于在 GeoEvent Manager 中引用的处理器的描述性名称。 |
处理器 |
指定所选的处理器。 |
间距通知模式 | 间距通知模式,用于处理器检测到的间距。 默认设置为待更改。
|
间距持续时间(秒) | 在确定预期数据未被接收前,处理器将等待的时间(以秒为单位)。 处理器使用存储在接收事件内部注册表中的追踪 ID 监控预期的事件记录。 默认值为 300 秒。 |
间距检测间隔(秒) | 在轮询接收事件内部注册表以确定是否存在未观测到的追踪 ID 之前,处理器将等待的时间(以秒为单位)。 默认值为 120 秒。 |
几何字段 | 几何字段名称或 GEOMETRY 标记字段,处理器通过这些字段将已知事件记录几何应用于其创建的间距事件。 |
注意事项和限制
使用追踪间距检测器处理器时,需要牢记几点注意事项:
- 在监控间距事件时,需要考虑间距持续时间(秒)和间距检测间隔(秒)参数之间的关系。 建议在这些参数中指定的两个值之间寻求一种平衡。 请考虑以下情景:
- 如果将间距持续时间(秒)参数设置为 60 秒,并将间距检测间隔(秒)参数设置为 600 秒,则将导致间距报告延迟。 由于处理器已配置的间隔轮询,丢失事件记录将在 1 分钟后被视为缺失,但是在 10 分钟内不会被报告。 根据事件数据特性,此类型延迟可能不被接受。 考虑减少间距检测间隔(秒)参数。
- 相反地,对于已接收且每 10 分钟仅更新一次的事件数据,如果将间距持续时间(秒)参数设置为 3600 秒,间距检测间隔(秒)参数设置为 1 秒,则将对 GeoEvent 服务性能产生不必要的影响。 30 分钟后的事件记录将被视为在流中缺失,而没有其他更新。 但是,每 10 分钟 GeoEvent 服务仅接收一次同一事件记录,因此每 10 分钟只能更新一次。 1 秒的轮询间隔将导致不必要的系统处理和资源使用,因为事件记录的更新只能每 10 分钟进行一次,而不是每秒一次。 考虑增加间距检测间隔(秒)参数。