查看、查询和配置服务器日志
可通过 ArcGIS Server 管理器中的查看日志 模块查看、查询、配置和删除服务器日志。有关根据日志排除服务器故障时可能遇到的各种信息的描述,请参阅以下各部分内容。
日志级别
可通过从严重(表示需要立即对该问题加以注意)到详细(正常使用服务器时生成的普通消息)等各种详细程度级别来记录服务器事件。可以使用日志过滤器下拉列表按特定的日志级别整理已记录事件的显示。
默认情况下,日志级别设置为警告。可通过选择查看日志 模块中的设置更改默认的日志级别。日志级别可决定写入服务器日志的事件的数量和类型。
日志级别如下:
日志级别 | 描述 |
---|---|
严重 | 需要立即加以注意的严重问题。此级别仅包括严重消息。 |
警告 | 需要加以注意的中度问题。此级别也包括严重消息。 |
信息 | 服务器的普通管理消息,包括有关服务创建和启动的消息。此级别也包括严重消息和警告消息。 |
100% 点显示的地图比例: | 由于使用服务器而生成的普通消息,如收到了操作请求的名称。此类消息的级别包括严重消息、警告消息和信息消息。 |
详细 | 这些消息提供了有关服务器如何完成操作的更多详细信息,如用于通知地图服务中的各图层已成功绘制、图层的绘制速度以及服务器访问图层源数据所花费的时间等服务器消息。此类消息的级别包括严重消息、警告消息、信息消息和精细消息。 |
调试 | 非常详细的消息,旨在供想要在进行故障排除时更深入地了解服务器状态的开发人员和支持技术人员使用。此级别不应用于生产环境,因为这可能会造成服务器性能大幅下降。 |
关 | 关闭日志记录。服务器不会记录事件。 |
记录属性
由服务器记录的事件将包含许多属性,如日志级别、事件发生的时间以及发生该事件的计算机,这些都有助于更有效地排除 ArcGIS Server 站点的故障。
默认情况下,仅级别、时间、消息和源属性会显示在日志消息窗口中。如果想要在显示中添加或移除属性,请选择列。
可以通过拖拽事件日志显示中的各列标题对各列进行重新排序。还可以单击这些列对其进行排序。
以下属性与服务器所记录的每个事件相关联:
属性 | 描述 |
---|---|
等级 | 消息相对于其他消息的详细程度。 |
时间 | 所记录事件的发生时间。 |
消息 | 与所记录事件相关联的消息。 |
源 | 记录该事件的服务器组件。 |
计算机 | 发生该事件的 GIS 服务器计算机。例如,服务器可对其未能更新配置存储位置之类的错误进行记录。只有那些应用于为特定计算机记录的统计数据的消息才会包括计算机属性。 |
编码 | 与消息相关联的结果代码。在帮助系统中查找消息时,此属性非常有用。 |
经历的时间 | 要完成正在记录的事件所花费的时间。例如,用于导出 Web 地图图像的事件使用经历的时间来表示导出 Web 地图图像所花费的时间。 |
用户名 | 所提交的请求导致生成日志消息的用户的名称。此属性对于在启用安全后帮助用户追踪各种用户活动非常有用。 |
进程 | 记录该事件的进程 ID。 |
线程 | 生成该消息的服务器进程线程。 |
方法名称 | 日志消息中生成的对服务的方法调用。 |
日志保留期限
服务器记录的事件按时间顺序组织,最近发生的事件最先显示。要查询在特定时间范围内记录的事件,请从龄期过滤器中选择所需的增量。
请记住,查询将仅返回您所指定的 ArcGIS Server 站点在磁盘上保留日志的时间范围内的日志。默认值为 90 天。例如,如果将站点配置为保留日志 5 天,从龄期过滤器中选择上周将仅返回最近 5 天的日志。
可通过在查看日志 模块中单击设置按钮来指定服务器在磁盘上保留日志的时间长度。有关详细信息,请参阅在管理器中指定服务器日志设置。
下面描述了可从龄期过滤器中选择的时间增量:
时间增量 | 描述 |
---|---|
最后 15 分钟 | 显示在最近 15 分钟内记录的事件。 |
前一小时 | 显示在最近一小时内记录的事件。 |
最后 6 小时 | 显示在最近六小时内记录的事件。 |
最后 24 小时 | 显示在最近一天内记录的事件。 |
上周 | 显示上周或您所指定的站点在磁盘上保留日志的时间范围内记录的事件。 |
启动后 | 显示服务器上次重启后或您所指定的站点在磁盘上保留日志的时间范围内记录的事件。 |
全部 | 显示安装 ArcGIS Server 后或您所指定的站点在磁盘上保留日志的时间范围内记录的所有事件。 |
日志源
所记录事件的源可以是服务,也可以是服务器本身。与服务关联的事件将服务的名称和类型显示为源属性。与服务器关联的事件将记录消息的框架组件的名称显示为源属性。
例如:
- 与 SampleWorldCities 地图服务相关的事件显示为 SampleWorldCities.MapServer。
- 在站点中成功创建服务器集群后,会显示 Admin 作为记录该消息的组件。
要查询特定服务或服务器框架组件,请从源过滤器选择服务或组件的名称。有关记录的事件所显示的源的描述,请参阅下表。
下面介绍的 Admin、Server、Rest 和 Soap 源聚合在源过滤器中的服务器框架级别下。要查询这些源,请从源下拉过滤器中选择服务器框架。
源 | 描述 |
---|---|
管理 | 表示该消息是由管理 API 记录的。管理 API 是可用于管理服务器(例如,创建站点、添加计算机和服务、配置集群等)的服务器层。 |
Server | 表示该消息是由服务器框架中负责创建服务实例的部分记录。 |
Rest | 表示该消息是由服务器的 REST 处理程序记录。Rest 组件用于记录所有级别的消息。 |
Soap | 表示该消息是由服务器的 SOAP 处理程序记录。Soap 组件用于记录所有级别的消息。 |
<服务名称>.FeatureServer | 源是要素服务。 |
<服务名称>.GeocodeServer | 源是地理编码服务。 |
<服务名称>.GeoDataServer | 源是地理数据服务。 |
<服务名称>.GeometryServer | 源是几何服务。 |
Geometry.GeometryServer | 源是随 ArcGIS Server 一起安装的预先配置的几何服务。 |
<服务名称>.GlobeServer | 源是 globe 服务。 |
<服务名称>.GPServer | 源是地理处理服务。 |
CachingTools.GPServer | 源包含随 ArcGIS Server 一起安装的预先配置的缓存工具。 |
PrintingTools.GPServer | 源是随 ArcGIS Server 一起安装的预先配置的 PrintingTools 服务。 |
PublishingTools.GPServer | 源包含随 ArcGIS Server 一起安装的预先配置的发布工具。 |
<服务名称>.ImageServer | 源是图像服务。 |
<服务名称>.JPIPServer | 源是 JPIP 服务。 |
<服务名称>.KmlServer | 源是 KML 服务。 |
<服务名称>.MapServer | 源是地图服务。 |
<服务名称>.MobileServer | 源是移动数据服务。 |
<服务名称>.NAServer | 源是网络分析服务。 |
<服务名称>.WCSServer | 源是网络覆盖服务。 |
<服务名称>.WFSServer | 源是网络要素服务。 |
<服务名称>.WMServer | 源是 Workflow Manager 服务。 |
<服务名称>.WMSServer | 源是 Web 地图服务。 |
<服务名称>.WMTSServer | 源是 Web 地图切片服务。 |
<服务名称>.WPSServer | 源是网络处理服务。 |
<服务名称>.SchematicsServer | 源是逻辑示意图服务。 |
<服务名称>.SearchServer | 源是搜索服务。 |
SampleWorldCities.MapServer | 源是随 ArcGIS Server 一起安装的预先配置的 SampleWorldCities 地图服务。 |
Search.SearchServer | 源是随 ArcGIS Server 一起安装的预先配置的搜索服务。 |
Search_indexer.GPServer | 源是预先配置的搜索服务随附的 _indexer 地理处理服务。 |
<搜索服务名称>_indexer.GPServer | 源是搜索服务随附的 _indexer 地理处理服务。 |
特定计算机记录的事件
参与站点的每台 GIS 服务器都会维护其自己的特定于本计算机的一组日志。要查询特定 GIS 服务器计算机所记录的事件,请从计算机过滤器中选择所需的计算机。
分页查看服务器日志
在查看日志 模块中执行查询时,日志消息窗口中会显示匹配查询的 1,000 条最新消息。这些消息的时间范围显示在日志消息窗口的底部。
如果查询返回超过 1,000 条消息,可通过单击日志消息窗口底部的较旧按钮翻页到下一组记录。同样,可单击较新按钮及时向前翻页。
分页查看记录时,日志消息窗口不会自动更新以显示可能在执行查询之后记录的新消息。要获取最新的查询结果,请在查看日志 模块中单击查询。
以适合打印的格式查看日志。
执行查询后,可以单击方便打印的视图链接,以适合打印的格式查看日志。这会打开以 HTML 形式显示日志的新浏览器窗口(或选项卡)。可使用此视图打印日志、将 HTML 保存到磁盘,或将日志复制并粘贴到文档或电子表格中。通过这种方式,可以与组织中的其他成员(如有必要,还可同 Esri 技术支持)共享您的日志消息。
这一适合打印的视图仅显示您执行的最新查询、日志消息窗口的当前视图,以及您所指定的任意记录属性。然而,如果您对事件日志显示中的列进行了排序或重新排序,HTML 视图会返回各列在第一次执行请求时的原始状态。如果需要,可将日志复制并粘贴到电子表格中并使用应用程序中的工具对各列进行排序和重新排序。
删除日志
如果要删除日志,请单击删除日志。这会从参与您站点的每台 GIS 服务器中删除所有日志消息。单击删除日志后,系统将提示您确认要删除所有日志的决定。
调试造成服务器问题的特定情景时,删除日志有助于隔离该问题。例如,如果尝试确定地图服务中特定图层的绘制性能,删除日志、向地图发送请求然后更新日志消息窗口以显示请求事件可能会有所帮助。这样将从日志中清除任意外部事件,使您能够集中精力调试地图服务。