GeoEvent Logger

什么是 GeoEvent Logger？

GeoEvent Logger 是一款随附于 ArcGIS GeoEvent Server 的 Windows 应用程序，可在 GeoEvent Server 处理事件数据的过程中，以分隔符表示的形式查看这些事件数据。从 TCP/文本输出连接器广播的事件数据可由 GeoEvent Logger 进行显示，也可以选择将这些数据写入系统文件。

可从 Windows ArcGIS 程序组访问 GeoEvent Logger。以下介绍了 GeoEvent Logger 的一些关键元素：

属性或字段名称	描述
1 - 连接	GeoEvent Simulator 应尝试连接的服务器主机名。默认值为 localhost。使用刷新按钮可登录 GeoEvent Server。
2 - 输出连接器	GeoEvent Simulator 应向其发送模拟事件数据的指定服务器的 TCP 套接字。
3 - 连接信息	指定是否将从文本文件或要素图层加载模拟事件数据。GeoEvent Simulator 最典型的用例是模拟来自 CSV 文件的数据。
4 - 已连接对等	文本字段，指定指向文件的路径名称，或指定指向 GeoEvent Simulator 将从中提取事件数据的要素图层的 URL。
5 - 连接面板	发送事件数据的速率。默认每 1000 毫秒发送一个事件记录。更改此值可以更快的速率发送数据（例如每 250 毫秒发送 5 条消息），或以更慢的速率发送数据（例如每 2500 毫秒发送 1 条消息）。
6 - 日志面板	使用转到始端、播放和单步执行控件可将 GeoEvent Simulator 设置为事件数据的开端、开始发送所有事件，或发送单个事件记录到 GeoEvent Server。 连续循环指定到达最后一个记录后，GeoEvent Simulator 是否应连续循环回放（或重播）事件数据。
7 - 清除计数器/清除	以分隔文本表示的方式显示将要发送到 GeoEvent Server 的下一条事件记录。
8 - 添加连接/添加接收的时间信息	提供滚动模拟事件数据的功能。随着位置的变化，在范围中间显示的当前索引会发生变化，以指示当前事件索引。
9 - 事件数据显示	在模拟事件数据中选择指定时间/日期的字段。数组以零为基础，表示时间长整型（以上所述示例中）是事件记录唯一标识符（或 TRACK_ID）右侧的值。
10 - 记录 GeoEvent	如果选中该复选框，GeoEvent Simulator 将放弃从模拟事件数据检索的时间/日期信息，并将其替换为系统当前时间。

使用 GeoEvent Server 对 GeoEvent Logger 进行身份验证

在 GeoEvent Logger 的右上方有一个文本框，可在其中输入 GeoEvent Server 的服务器名称。在大多数情况下，在 GeoEvent Server 所在的计算机上运行 GeoEvent Logger 时，可将此设置保留为 localhost。在某些情况下，例如，如果您正在与 GeoEvent Server 不同的计算机上运行 GeoEvent Logger，则 localhost 将 无法正常运行。在这种情况下，您需要以 server.domain.com 格式输入正在运行 GeoEvent Server 的 计算机的名称。

在输入 GeoEvent Server 计算机名称后，单击刷新。这将打开登录对话框，可在其中输入用于连接到 GeoEvent Server 的凭据。确保正确设置服务器 URL，输入用户名和密码，然后单击 登录。

注：

如果 GeoEvent Server 已联合，则需使用 Portal for ArcGIS 的管理凭据登录。如果 GeoEvent Server 未联合，则需使用基础 ArcGIS Server 用户/角色提供程序中定义的管理员凭据。

默认情况下，会启用 GeoEvent Server 登录。要实现向后兼容（版本 10.8 或更早版本），需要禁用身份验证。要在 GeoEvent Logger 中禁用身份验证，单击菜单中的选项，然后取消选中使用 GeoEvent Server 管理端点。同样，仅当您需要将 10.8.1 或更高版本的 GeoEvent Logger 连接到 10.8 版本或更早版本的 GeoEvent Server 时，为了实现向后兼容性，才需要此选项。

建立与输出连接器的连接

GeoEvent Logger 将列出所选 GeoEvent Server（可连接到由外部服务器和应用程序托管的 TCP 或 UDP 套接字）上可用的输出连接器。

例如，如下图所示，可以看出 GeoEvent Server 有三个可用的输出连接器。其中两个为 TCP/文本输出，另外一个为 UDP/文本输出。GeoEvent Logger 发现这三个 GeoEvent Server 输出并将其列为连接，其中默认选中第一个输出。

GeoEvent Logger 会针对所选输出 (tcp‑text‑out‑5575) 打开指定服务器 (localhost) 上的 TCP 套接字 (5575)。GeoEvent Server 输出连接器作为客户端运行，因此必须启动输出，才能在 GeoEvent Logger 中找到该输出。但是，打开 GeoEvent Logger 之前，不存在输出可以与之连接的托管套接字。

停止或重新启动输出连接器将清除 GeoEvent Manager 中显示的错误消息：

重新启动输出连接器可以确保客户端将重新尝试连接到 GeoEvent Logger 在指定服务器上打开的 TCP 套接字。输出连接器广播的事件数据将由 GeoEvent Logger 接收并显示在显示屏中。

确认客户端连接

可以通过两种方式确认客户端连接。第一种，在 GeoEvent Manager 中，输出将指示已启动状态。第二种，在 GeoEvent Logger 中，如果在列表中选择连接，将显示该套接字上已连接客户端（已连接对等）的计数。

显示接收的事件数据

GeoEvent Logger 可接收并以分隔文本表示的方式显示输出连接器广播的事件数据。接收事件数据后，GeoEvent Logger 中可显示接收的事件数据总数。

单击添加连接可在显示屏中将输出连接器的名称追加到事件数据。

单击添加接收的时间信息可在显示屏中将接收服务器的当前日期/时间追加到事件数据。

将事件数据记录到系统文件中

GeoEvent Logger 的主要作用是在接收事件数据后，实时显示和查看该事件数据。但是，该应用程序还可以用于将接收的事件数据记录到系统文件中，从而实现探索和归档目的。

在 GeoEvent Logger 中，单击日志可显示 Log GeoEvents面板。要将事件数据记录到系统日志文件中，请输入系统文件夹的路径，指定一个文件名，然后选中标注为 记录到 CSV 文件的复选框。

选中记录到 CSV 文件中后，GeoEvent Logger 底部将显示一条状态消息，确认要写入事件数据的文件。如果取消选中该复选框，则将显示一条状态消息，确认日志文件将不再接收事件数据。

系统文件记录包含一个选项，该选项可在接收指定数量的事件记录后自动创建一个新文件。如果选中该选项，则默认情况下每 500 个事件将创建一个新日志文件。

系统文件记录还包含另外一个选项，该选项可批量缓存事件数据，并在接收指定数量的事件后（或指定秒数后），仅向日志文件提交批量数据。如果选中该选项，则默认行为是每 500 个事件或每 30 秒刷新一次缓存。该选项仅用于以相当高的速率接收事件数据的情况（例如，每秒一百个或更多事件）。该选项可控制 GeoEvent Logger 的磁盘访问，以便服务器更加高效地将批量事件写入磁盘。

与事件数据显示屏中的事件可视化类似，您可以选择将连接信息和/或接收的日期/时间信息追加到日志文件中的各个事件。您也可以手动关闭当前日志文件，并通过单击新建文件强制创建一个新日志文件。单击暂停可暂时停止，随后即可继续将事件数据记录到指定的日志文件中。GeoEvent Logger 右下角的事件计数器可提供已接收并写入日志文件的事件总数状态。