什么是 GeoEvent Sampler？
可以通过多种类型的协议（HTTP、WebSocket、TCP 等）以各种数据格式（文本、JSON、GeoJSON 等）接收实时数据。在指示将 GeoEvent 写入要素图层以在 Web 地图中查看之前，能够直接在 GeoEvent Manager 中验证和探索事件数据（或 GeoEvent），这特别有用。GeoEvent Sampler 是 GeoEvent Manager 服务设计器中的一个实用程序，用于在发布的 GeoEvent 服务的元素（输入、输出、过滤器和处理器）流经时对固定数量的 GeoEvent 进行采样。经采样的 GeoEvent 可以在采样器窗口中以经过修饰的 JSON 或分隔文本形式进行查看。经采样的 GeoEvent 可以更早、更深刻地洞察实时事件数据，并有助于对 GeoEvent 服务中的不同路径进行设计、验证和故障排除。
与随 GeoEvent Server 安装的独立 Windows 应用程序 GeoEvent Logger 和 GeoEvent Simulator 不同，GeoEvent Sampler 是 GeoEvent Manager 中服务设计器中的实用程序。通过切换服务设计器底部的实用程序，可以从任何新的或现有 GeoEvent 服务访问 GeoEvent Sampler。以下是对 GeoEvent Sampler 提供的主要功能的说明。
| 属性或功能 | 说明 |
|---|---|
| 1 - 启用/禁用 | 启用和禁用用于针对已发布的 GeoEvent 服务的两个元素之间的选定路径启动和停止 GeoEvent Sampler。GeoEvent Sampler 默认情况下处于禁用状态，必须将其启用才能在选定路径上对 GeoEvent 进行采样。
有关启用 GeoEvent Sampler 的详细信息，请参阅下方的启用 GeoEvent Sampler。 |
| 2 - 选择路径 | GeoEvent 服务中所选路径的名称。仅在采样器窗口中显示所选路径的事件数据。可以在已发布的 GeoEvent 服务中选择输入、输出、过滤器或处理器元素之间的任何路径。 所选路径的名称显示为已连接元素名称的串连形式。路径名称的几个示例包括：
注：启用 GeoEvent Sampler 并选择了 GeoEvent 服务中两个元素之间的路径后，将显示所选路径的名称。 |
| 3 - GeoEvent Sampler 实用程序 | 单击切换按钮以在服务设计器中显示或隐藏 GeoEvent Sampler。 有关启用 GeoEvent Sampler 的详细信息，请参阅下方的启用 GeoEvent Sampler。 |
| 4 - 刷新 | 使用刷新可清除当前已采样的 GeoEvent，并对所选路径中的另一组进行采样。 刷新后，将对另一组 GeoEvent 进行采样，直到达到采样大小设置。例如，如果将采样大小设置为 10 然后刷新，则当前 GeoEvent 将被清除，而在采样器窗口中显示另外 10 个样本。 如果要比较两条路径，刷新功能可清除每条路径的 GeoEvent，然后再次对每条路径进行采样。有关比较两条路径的详细信息，请参阅下方的比较两条路径的 GeoEvent。 |
| 5 - 清除 | 使用清除可从采样器窗口中删除已采样的 GeoEvent。 清除之后，将继续从选定路径中采样 GeoEvent，直到达到采样大小设置。例如，如果将采样大小设置为 10 并且在对 3 个 GeoEvent 进行采样后清除，采样器将清除 3 个 GeoEvent，并继续对其余 7 个 GeoEvent 进行采样。 如果对两条路径进行比较，清除对于每条路径均可用。有关比较两条路径的详细信息，请参阅下方的比较两条路径的 GeoEvent。 注：只有至少对一个 GeoEvent 进行采样之后，才能清除采样器窗口。 |
| 6 - 在事件查看器中查看 | 使用在事件查看器中查看在网络地图查看器中可视化采样的 GeoEvent 的几何。 事件查看器仅显示采样器窗口中当前显示的已采样 GeoEvent 的几何。事件查看器打开后，将不会显示任何新采样的 GeoEvent。在所需数量的 GeoEvent 采样完成并显示在采样器窗口中后打开事件查看器。 注：仅当 GeoEvent 的几何具有在其 GeoEvent 定义中标记为 GEOMETRY 的字段时，才可以在事件查看器中查看已采样的 GeoEvent。此外，已采样的 GeoEvent 必须采用 JSON 数据类型格式，不支持以文本形式查看。 |
| 7 - 复制到剪贴板 | 使用复制到剪贴板可将当前显示在采样器窗口中的 GeoEvent 复制到系统剪贴板。然后，可以将复制的 GeoEvent 粘贴到单独的文本文件或文本编辑器中，以进行存储或进一步查看。 如果对两条路径进行比较，复制到剪贴板对于每条路径均可用。有关比较两条路径的详细信息，请参阅下方的比较两条路径的 GeoEvent。 注：GeoEvent 将以数据类型设置中定义的数据类型格式（文本或 JSON 格式）进行复制。数据类型格式可以在设置中进行更改。 |
| 8 - 设置 | 访问用于采样 GeoEvent 的设置，包括数据类型和采样大小。
|
| 9 - 采样器窗口 | 从选定路径采样的 GeoEvent 将显示在采样器窗口中。 已采样的 GeoEvent 将显示为 JSON 或文本，具体取决于数据类型设置中指定的数据类型格式。 |
| 10 - 事件计数器 | 事件计数器显示在选定路径上采样的 GeoEvent 的数量。采样的 GeoEvent 数量将永远不会超过采样大小设置。例如，3/10 表示已采样了 3 个 GeoEvent（最多 10 个）。 注：如果选择了新路径或已对采样进行刷新，则事件计数器将重置为 0。 |
启用 GeoEvent Sampler
GeoEvent 可以从已发布的 GeoEvent 服务中的输入、输出、过滤器或处理器元素之间的路径（或连接）实时采样和显示。要开始使用 GeoEvent Sampler，请打开 GeoEvent Manager，然后创建新 GeoEvent 服务或打开现有 GeoEvent 服务。有关创建新 GeoEvent 服务的详细信息，请参阅 创建 GeoEvent 服务。
要在服务设计器中访问和启用 GeoEvent Sampler，请参考以下步骤。
- 打开已发布的 GeoEvent 服务，并确保其正在接收 GeoEvent。
- 请单击服务设计器底部的
，以打开 GeoEvent Sampler。 - 请单击
以打开 GeoEvent Sampler 的设置，并指定所需的数据类型和采样大小。默认数据类型为 JSON 格式，默认采样大小为 10 个 GeoEvent。 - 请单击
以启动 GeoEvent Sampler。
注：
要启动 GeoEvent Sampler，您还可以通过右键单击已发布的 GeoEvent 服务中两个元素之间的路径并选择样本路径。GeoEvent Sampler 将打开，并且将在所选路径上开始 GeoEvent 采样。
开始采样 GeoEvent
要开始对 GeoEvent 进行采样，请在 GeoEvent Sampler 打开并启用的情况下，选择输入、输出、过滤器或处理器元素之间的路径。
要对 GeoEvent 服务中的路径采样 GeoEvent，请创建新的已发布 GeoEvent 服务或打开现有已发布 GeoEvent 服务，确保其正在主动接收 GeoEvent，然后按照以下步骤操作。
- 确保 GeoEvent 采样已在服务设计器中打开并启用。
- 左键单击已发布的 GeoEvent 服务中的一条路径，以开始对该路径上的 GeoEvent 进行采样。
- （可选）可以通过单击
复制到剪贴板从采样器窗口中复制当前 GeoEvent 示例。 - （可选）可以通过单击
清除将当前 GeoEvent 示例从采样器窗口中清除。 - （可选）可以通过单击
刷新再次采样所选路径。
注：
也可以通过右键单击路径并从菜单中选择样本路径来启动 GeoEvent Sampler。如果之前尚未打开并启用 GeoEvent Sampler，则 GeoEvent Sampler 将打开、启用并立即从所选路径开始采样 GeoEvent。
可视化已采样的 GeoEvent
GeoEvent Sampler 的主要目的是在已发布的 GeoEvent 服务中对其进行处理时，以文本或 JSON 格式实时提供 GeoEvent 样本。GeoEvent Sampler 还包括一个事件查看器，它是一个网络地图查看器，可用于可视化和验证已处理的 GeoEvent 的几何。
要在事件查看器中可视化已采样的 GeoEvent，请创建新的已发布 GeoEvent 服务或打开现有已发布 GeoEvent 服务，确保其正在主动接收 GeoEvent，然后执行以下步骤。
- 确保已在服务设计器中打开并启用 GeoEvent Sampler。
- 请单击 并确认已将数据类型设置为 JSON 格式。
- 左键单击已发布的 GeoEvent 服务中的一条路径，以开始对所选路径上的 GeoEvent 进行采样。
- 在采样器窗口中将 GeoEvent 样本显示为 JSON 后，单击
以在事件查看器中查看 GeoEvent。 - 浏览事件查看器中的已采样 GeoEvent。
- 在事件查看器中，左键单击 GeoEvent，将显示一个包含属性信息的弹出窗口。
注：
（可选）右键单击路径，然后从菜单中选择样本路径以开始采样 GeoEvent。
注：
事件查看器仅支持采样 JSON 格式的 GeoEvent，其中包含在相应 GeoEvent 定义中标记为 GEOMETRY 的几何字段。如果采样的 GeoEvent 格式为文本并且没有标记为 GEOMETRY 的几何字段，则在事件查看器中查看将被禁用。
比较两条路径的 GeoEvent
可以同时在两条不同路径上执行 GeoEvent 采样。对两条路径进行采样对于比较和验证相关实时数据的变化会很有用。例如，由缓冲区创建者处理器发出的 GeoEvent 应该与其原始源几何（点）具有不同的几何（面）。通过从往返于处理器的路径中采样 GeoEvent，您可以确认 GeoEvent 不仅被缓冲区创建者处理器接收，而且那些相同的 GeoEvent 会被处理器缓冲。
要比较两条路径中的已采样 GeoEvent，请创建新的已发布 GeoEvent 服务或打开现有已发布 GeoEvent 服务，确保其正在主动接收 GeoEvent，然后执行以下步骤。
- 确保已在服务设计器中打开并启用 GeoEvent Sampler。
- 左键单击 GeoEvent 服务中的一条路径，以开始在第一条选定路径上采样 GeoEvent。
- 选择第一条路径后，右键单击第二条路径，然后选择比较路径。
- 单击以查看事件查看器中每条路径的 GeoEvent。
注：
（可选）右键单击路径，然后从菜单中选择样本路径以开始采样第一条路径。
注：
比较路径仅在选择了第一条路径后可用，否则该选项将处于禁用状态。共享同一源元素（无论是输入、输出、过滤器还是处理器）的路径都无法进行比较。
请注意，第二条选定路径使用不同的颜色（橙色），表示将对这两条选定路径执行 GeoEvent 采样。
选择两条路径后，将在 GeoEvent Sampler 中显示两个采样器窗口，您可以通过上述窗口比较这两条路径。左侧采样器窗口（蓝色）将返回第一条选定路径的已采样 GeoEvent，而右侧的窗口（橙色）将返回第二条选定路径的已采样 GeoEvent。
GeoEvent 采样最多只能在两条路径上执行。比较两条路径时，更改设置、刷新和打开事件查看器对于两个采样器窗口均适用。清除数据和将数据复制到剪贴板可以单独使用，并可应用于使用该工具的采样器窗口。
GeoEvent 采样注意事项和限制
- 仅在 GeoEvent 服务发布、启动以及主动接收实时事件数据时才对 GeoEvent 进行采样。如果 GeoEvent 服务未发布、未停止或未接收到事件数据，则采样器窗口中将不会显示任何内容。
- GeoEvent Sampler 可用于仅在连接输入、输出、处理器和过滤器的路径上执行采样。不支持对输入、输出、处理器和过滤器元素进行采样。
- 采样 GeoEvent 时，请考虑您的实时数据和服务设计。
- 超过 10 分钟不活动，GeoEvent Sampler 会自动断开连接并被禁用。
- GeoEvent Sampler 最多仅支持对 GeoEvent 元素之间的两条路径进行比较。
- 无法保证已采样的 GeoEvent 的顺序。GeoEvent 导入 GeoEvent Server 时的顺序可能与其在采样器窗口中的显示顺序不同。
- 已采样的 GeoEvent 不会保留或缓存。刷新采样器窗口或浏览器会话将删除当前已采样的所有 GeoEvent。
- 更改 GeoEvent Sampler 设置需要刷新。如果在对 GeoEvent 进行活动采样期间更改了设置，则新设置将在刷新 GeoEvent Sampler 后生效。
- 比较两条路径时，合理的方式是在第一个采样器窗口达到其采样大小后，第二个采样器窗口才显示 GeoEvent。考虑到路径中的数据可能因不满足过滤条件或处理条件而无法接收的情况。
- 等待接收第一个 GeoEvent 时，采样器窗口将显示进度条。
- 离线环境不支持在事件查看器中查看 GeoEvent。