使用服务器日志
在本主题中
监控服务器日志可帮助您标识错误、排除故障并解决站点问题。可使用 ArcGIS Server Manager 查看、查询、配置和删除门户日志。管理器将日志消息聚集到一张表格中,以便您进行阅读和处理。
本帮助主题中的各部分介绍服务器日志以及如何使用服务器日志解决问题。
捕获、查询和查看事件的方法
站点中发生事件时,系统会捕获事件并将其记录到日志中。需要通过查询日志来查看与事件相关的消息。遵循以下步骤可查询和查看站点中的当前消息:
- 打开管理器并以管理员的身份登录。如需此步骤的帮助,请参阅登录管理器。
- 单击 日志 > 查看日志 查看当前日志。随即返回一些消息和详细信息。
所有事件均会记录信息,例如日志级别、事件发生时间、记录事件的源组件、发生事件的计算机、日志编码、与事件关联的用户等等。所有这些信息都可以帮助您更有效地解决门户问题。有关此信息的详细说明,请参阅了解日志。
安装和安装后日志记录行为
安装或升级 ArcGIS Server 时,服务器的日志级别设置为详细。这意味着安装或升级进程期间将记录非常详细的消息。
如果在此过程中遇到故障并想要查看日志以便帮助您排除故障,请先确定您是否可以访问 ArcGIS Server Manager。如果可以,查询日志并查看消息。如果不可以,则查看磁盘上的日志消息。要访问磁盘上的日志,请浏览至日志目录并打开最近的日志文件(例如 <ArcGIS Server installation directory>/arcgisserver/logs/<machine name>/server/server-20150101.095803-8596-0.0.log)。 如有必要,可以将此信息共享给 Esri 支持。
安装或升级过程完成后,服务器的日志级别默认设置为警告。这意味着只记录中等到严重程度的问题。如果服务器用户报告了问题,则您可能需要更改日志级别,以便捕获有关该特定问题的更加详细的消息。要了解如何修改日志记录级别,请参阅在管理器中指定服务器日志设置。
怀疑出现问题时
如果您怀疑服务器存在问题,或者用户报告了问题,则需要重现事件,捕获包含日志的事件,然后查询日志获取事件相关信息。之后,便可使用日志中的信息解决事件引起的问题。
如果您怀疑存在问题或用户报告了问题,可利用以下决策树帮助您捕获包含日志的事件:
- 尝试重现问题:
- 如果可以重现问题,则查询日志并查看消息以获取该问题相关信息:
- 如果没有信息,则提高日志记录级别。再次重现问题,查询日志并查看消息。
- 如果日志消息中存在信息,则查看信息以帮助您解决问题。
- 如果无法重现问题,则记下导致这一问题的场景,以防再次出现。
- 如果可以重现问题,则查询日志并查看消息以获取该问题相关信息:
提示:
如果问题与发布托管服务相关,建议您同时查看门户 ArcGIS 日志。门户日志可能会提供其他信息,以便帮助您解决发布问题。
了解日志
所有事件均会记录特定信息,例如日志级别、事件发生时间、以及发生事件的计算机等。所有这些信息都可以帮助您更有效地解决服务器问题。
默认情况下,仅级别、时间、消息和源属性会显示在日志消息窗口中。如果想要在显示中添加或移除属性,请选择列。
提示:
可通过拖拽事件日志显示中的各列标题对各列进行重新排序。单击每个列标题可进行升序或降序排列。
以下几个部分将详细介绍此信息。
级别
根据详细程度级别,可将记录的事件按照从严重(表示需要立即对该问题加以注意)到详细(正常使用服务器时生成的详细的信息性消息)进行区分。
日志级别类型如下:
日志级别 | 描述 | 示例消息 |
---|---|---|
严重 | 需要立即加以注意的严重问题。此级别仅包括严重消息。 | 无法处理请求。找不到服务 Planning/counties/FeatureServer。 |
警告 | 需要加以注意的中度问题。此级别也包括严重消息。 | 登录失败。指定的用户名或密码无效。 |
信息 | 服务器的普通管理消息,包括有关服务创建和启动的消息。此级别也包括严重消息和警告消息。 | 已成功创建文件夹 Planning。 |
100% 点显示的地图比例: | 由于使用服务器而生成的普通消息,如收到了操作请求的名称。此类消息的级别包括严重消息、警告消息和信息消息。 |
检查 /admin/arcgisserver/directories/arcgisjobs 中的过期项目。 |
详细 | 这些消息提供了有关服务器如何完成操作的更多详细信息,如用于通知地图服务中的各图层已成功绘制、图层的绘制速度以及服务器访问图层源数据所花费的时间等服务器消息。此类消息的级别包括严重消息、警告消息、信息消息和精细消息。 | 开始图层绘制: counties. |
调试(D) | 非常详细的消息,旨在供想要在进行故障排除时更深入地了解服务器状态的开发人员和支持技术人员使用。建议不要在生产环境中使用此级别,否则可能会降低性能。如果您没有解决问题,请改用警告级别。 | 清理服务器目录。 |
关闭 | 关闭日志记录。服务器不会记录事件。 | N/A |
时间
所记录事件的发生时间。事件按时间顺序进行组织,最近发生的事件最先显示。单击时间列标题,对消息进行升序或降序排列。
查询日志时,您可以指定要显示的所需时间间隔。
源
所记录事件的源可以是服务,也可以是服务器本身。与服务关联的事件将名称和服务类型显示为源属性。与服务器关联的事件将记录消息的框架组件的名称显示为源属性。
例如:
- 与 SampleWorldCities 地图服务相关的事件显示为 SampleWorldCities.MapServer。
- 在站点中成功创建服务器群集后,Admin 会显示为记录该消息的组件。
查询日志时,可根据需要指定要显示的所需源。
计算机
参与站点的每台 GIS 服务器计算机都会维护其自己特定于本计算机的一组日志。此外,如果您已将 ArcGIS 数据存储注册到您的站点上,则各数据存储计算机都将记录特定于该计算机的消息。
例如,GIS 服务器可对其未能更新配置存储位置之类的错误进行记录。只有那些应用于为特定计算机记录的统计数据的消息才会包括计算机属性。
查询日志时,您可以指定要显示的所需计算机。
代码
与消息相关联的日志编码。如日志编码概述中所述,这些编码分为若干个范围。
历时
要完成事件记录所花费的时间(以毫秒为单位)。例如,用于导出 Web 地图图像的事件使用经历的时间来表示导出 Web 地图图像所花费的时间。
用户名(U)
所提交的请求导致生成日志消息的用户的名称。此属性对于在启用安全后帮助用户追踪各种用户活动非常有用。
处理
记录事件的计算机进程 ID。
线程
生成该消息的服务器进程线程。
方法名称
日志消息中生成的对服务的方法调用。
使用日志过滤器缩小搜索结果范围
可以基于日志级别、日志保留期限(时间)、源组件和计算机来执行查询,以帮助您缩小事件范围,从而显示更多相关消息。查询时可组合使用上述任意过滤器。您可以在管理器的查看日志页面中访问上述过滤器。
日志过滤器
根据详细程度级别,可将事件按照从严重(表示需要立即对该问题加以注意)到详细(正常使用服务器时生成的详细的信息性消息)进行区分。从日志过滤器下拉列表中选择所需的级别。有关每个级别的详细摘要,请参阅上述级别部分。
年龄
服务器记录的事件按时间顺序组织,最近发生的事件最先显示。要根据特定时间范围过滤事件,请从时间下拉列表中指定所需增量:
时间增量 | 描述 |
---|---|
最后 15 分钟 | 显示在最近 15 分钟内记录的事件。 |
前一小时 | 显示在最近一小时内记录的事件。 |
最近 6 小时 | 显示在最近六小时内记录的事件。 |
最后 24 小时 | 显示在最近一天内记录的事件。 |
上周 | 显示上周或您所指定的站点在磁盘上保留日志的时间范围内记录的事件。 |
启动后 | 显示服务器上次重启后或您所指定的站点在磁盘上保留日志的时间范围内记录的事件。 |
全部 | 显示安装 ArcGIS Server 后或您所指定的站点在磁盘上保留日志的时间范围内记录的所有事件。 |
您可以单击时间列标题,对消息进行升序或降序排列。
请记住,查询将仅返回您所指定的 ArcGIS Server 站点在磁盘上保留日志的时间范围内的日志。默认值为 90 天。例如,如果将站点配置为保留日志五天,从时间过滤器中选择上周将仅返回最近五天的日志。
提示:
单击设置指定服务器将日志保留在磁盘上的时长。有关详细信息,请参阅在管理器中指定服务器日志设置。
源
所记录事件的源可以是服务,也可以是服务器本身。与服务关联的事件将名称和服务类型显示为源属性。与服务器关联的事件将记录消息的框架组件的名称显示为源属性。
默认情况下查询所有源(下拉列表中的所有选项)。要查询特定服务或服务器框架组件,请从源过滤器选择服务或组件的名称。有关记录的事件所显示的源的描述,请参阅下表。
注:
下面介绍的 Admin、Server、Rest 和 Soap 源聚合在源过滤器中的服务器框架级别下。要查询这些源,请从源下拉过滤器中选择服务器框架。
源 | 描述 |
---|---|
管理员 | 表示该消息由管理 API 记录。管理 API 是可用于管理服务器(例如,创建站点、添加计算机和服务、配置集群等)的服务器层。 |
服务器 | 表示该消息由服务器框架中负责创建服务实例的部分记录。 |
Rest | 表示该消息由服务器的 REST 处理程序记录。Rest 组件用于记录所有级别的消息。 |
Soap | 表示该消息由服务器的 SOAP 处理程序记录。Soap 组件用于记录所有级别的消息。 |
ArcGIS Data Store | 表示该消息由 ArcGIS 数据存储记录。只有将 ArcGIS 数据存储注册到 ArcGIS Server,才会显示消息。 |
<服务名称>.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 | 源是网络处理服务。 |
<服务名称>.SceneServer | 源是场景服务。 |
<服务名称>.SchematicsServer | 源是逻辑示意图服务。 |
<服务名称>.SearchServer | 源是搜索服务。 |
SampleWorldCities.MapServer | 源是随 ArcGIS Server 一起安装的预先配置的 SampleWorldCities 地图服务。 |
Search.SearchServer | 源是随 ArcGIS Server 一起安装的预先配置的搜索服务。 |
Search_indexer.GPServer | 源是预先配置的搜索服务随附的 _indexer 地理处理服务。 |
<搜索服务名称>_indexer.GPServer | 源是搜索服务随附的 _indexer 地理处理服务。 |
计算机
参与站点的每台 GIS 服务器计算机都会维护其自己特定于本计算机的一组日志。此外,如果您已将 ArcGIS 数据存储注册到您的站点上,则各数据存储计算机都将记录特定于该计算机的消息。
默认情况下查询所有计算机(下拉列表中的所有选项)。要查询特定计算机所记录的事件,请从计算机过滤器中选择所需的计算机。
分页查看服务器日志
在查看日志模块中执行查询时,日志消息窗口中会显示匹配查询的 1,000 条最新消息。这些消息的时间范围显示在日志消息窗口的底部。
如果查询返回超过 1,000 条消息,可通过单击日志消息窗口底部的较旧按钮翻页到下一组记录。同样,可单击较新按钮及时向前翻页。
分页查看记录时,日志消息窗口不会自动更新以显示可能在执行查询之后记录的新消息。请单击查看日志模块中的查询,以获取最新的查询结果。
以适合打印的格式查看日志。
执行查询后,请单击方便打印的视图链接,以通过方便打印的格式查看日志。这会打开以 HTML 形式显示日志的新浏览器窗口(或选项卡)。可使用此视图打印日志、将 HTML 保存到磁盘,或将日志复制并粘贴到文档或电子表格中。通过这种方式,可以与组织中的其他成员(如有必要,还可同 Esri 技术支持)共享您的日志消息。
这一适合打印的视图仅显示您执行的最新查询、日志消息窗口的当前视图,以及您所指定的任意记录属性。然而,如果您对事件日志显示中的列进行了排序或重新排序,HTML 视图会返回各列在第一次执行请求时的原始状态。如果需要,可将日志复制并粘贴到电子表格中并使用应用程序中的工具对各列进行排序和重新排序。
删除日志
单击删除日志,从参与站点的各 GIS 服务器上删除所有日志消息。单击删除日志后,系统将提示您确认要删除所有日志的决定。
调试造成服务器问题的特定情景时,删除日志有助于隔离该问题。例如,如果尝试确定地图服务中特定图层的绘制性能,删除日志、向地图发送请求然后更新日志消息窗口以显示请求事件可能会有所帮助。这样将从日志中清除任意其他事件,使您能够集中精力调试地图服务。