Skip to main content

使用服务器日志

监控服务器日志可帮助您标识错误、排除故障并解决站点问题。 将使用 ArcGIS Server Manager 查看、查询、配置和删除门户日志。 Manager 将日志消息聚集到一张表格中,以便您进行阅读和处理。

本帮助主题中的各部分介绍服务器日志以及如何使用它们解决问题。

捕获、查询和查看事件

站点中发生事件时,系统会捕获事件并将其记录到日志中。 要查看与事件相关的消息,需要查询日志。 遵循以下步骤可查询和查看站点中的当前消息:

  1. 以管理员的身份打开 Manager 并登录。 如需此步骤的帮助,请参阅登录 Manager

  2. 单击日志 > 查看日志查看当前日志。 随即返回一些消息和详细信息。

所有事件均会记录信息,例如日志级别、事件发生时间、记录信息的源组件、发生事件的计算机、日志代码、与事件关联的用户等。 所有这些信息都可以帮助您更有效地解决门户问题。 有关此信息的详细说明,请参阅了解日志

安装和安装后日志记录行为

安装或升级 ArcGIS Server 时,服务器的日志级别设置为详细。 这意味着安装或升级进程期间将记录非常详细的消息。

如果在此过程中遇到故障并想要查看日志以便帮助您排除故障,请先确定您是否可以访问 ArcGIS Server Manager。 如果可以,查询日志并查看消息。 如果不可以,则查看磁盘上的日志消息。 要访问磁盘上的日志,请浏览到日志目录,然后打开最近的日志文件(例如 <ArcGIS Server installation directory>/arcgisserver/logs/<machine name>/server/server-20150101.095803-8596-0.0.log)。 如有必要,可以将此信息共享给 Esri 技术支持

如果在此过程中遇到故障并想要查看日志以便帮助您排除故障,请先确定您是否可以访问 ArcGIS Server Manager。 如果可以,查询日志并查看消息。 如果不可以,则查看磁盘上的日志消息。 要访问磁盘上的日志,请浏览到日志目录,然后打开最近的日志文件(例如 C:\arcgisserver\logs\<machine name>\server\server-20150101.095803-8596-0.0.log)。 如有必要,可以将此信息共享给 Esri 技术支持

安装或升级过程完成后,服务器的日志级别默认设置为警告。 这意味着将仅记录程度从中等到严重的问题。 如果服务器用户报告了问题,您需要更改日志级别,以便捕获有关该特定问题的更加详细的消息。 要了解如何修改日志记录级别,请参阅在 Manager 中指定服务器日志设置

对问题进行故障排除

如果您怀疑服务器存在问题,或者用户报告了问题,则需要重现该事件,通过日志捕获该事件,然后查询日志获取事件相关信息。 之后,将使用日志中的信息帮助解决事件引起的问题。

如果您怀疑存在问题或用户报告了问题,请进行以下操作来捕获包含日志的事件:

  • 尝试重现问题。

    • 如果可以重现问题,则查询日志并查看消息以获取该问题相关信息

      • 如果没有信息,则提高日志记录级别。 再次重现问题,查询日志并查看消息。

      • 如果日志消息中存在信息,则查看信息以帮助您解决问题。

    • 如果无法重现问题,则记下导致这一问题的场景,以防再次出现。

提示:

如果问题与发布托管服务有关,建议同时查看 Portal for ArcGIS 日志。 门户日志可能会提供其他信息,以便帮助您解决发布问题。

了解日志

所有事件都会记录具体信息,如日志级别、事件的发生时间以及发生事件的计算机。 所有这些信息都可以帮助您更有效地对服务器进行故障排除。

默认情况下,日志消息窗口中仅显示级别时间消息属性。 如果要在显示中添加或移除属性,请选择

提示:

通过在事件日志显示中拖放列标题对列重新排序。 单击每个列标题以按升序或降序进行排序。

级别

根据详细程度级别,可将记录的事件按照从严重(表示需要立即对该问题加以注意)到详细(正常使用服务器时生成的详细的信息性消息)进行区分。

注:

ArcGIS Server 一次只能保留 1,000 条日志。 无论您为日志保留选择的其他设置如何,都仅保留最新的 1,000 个日志。

日志消息的频率随着您增加详细程度而增加;例如,在 FINE 级别记录的消息多于在 SEVERE 级别记录的消息。

建议您将日志级别保持为 SEVEREWARNINGINFO,除非需要出于故障排除目的而增加日志级别。

日志级别类型如下:

日志级别

描述

示例消息

Severe

需要立即加以注意的严重问题。 此级别仅包括严重消息。

无法处理请求。 未找到 Service Planning/counties/FeatureServer 。

警告

需要加以注意的中度问题。 此级别也包括严重消息。

登录失败。 指定的用户名或密码无效。

信息

服务器的常见管理消息,包括有关服务创建和启动的消息。 此级别也包括严重和警告消息。

Folder Planning 已成功创建。

精细

由于使用服务器而生成的常见消息,如收到的操作请求的名称。 此级别包括严重、警告和信息消息。

正在检查 /admin/arcgisserver/directories/arcgisjobs 中的过期项目。

正在检查 C:\arcgisserver\directories\arcgisjobs 中的过期项目。

详细

这些消息提供了有关服务器如何完成操作的更多详细信息,如通知地图服务中的各图层已成功绘制、图层的绘制速度,以及服务器访问图层源数据所花费的时间。 此级别包括严重、警告、信息和精细消息。

开始图层绘制:counties。

调试

非常详细的消息,旨在供想要在进行故障排除时更深入地了解服务器状态的开发人员和支持技术人员使用。 建议不要在生产环境中使用此级别;这可能会降低性能。 如果您没有解决问题,请改用警告级别。

清理服务器目录。

关闭日志记录。 服务器不会记录事件。

N/A

时间

这是所记录事件的发生时间。 事件按时间顺序进行组织,最近发生的事件最先显示。 单击时间列标头,按升序或降序对消息进行排序。

查询日志时,您可以指定要显示的所需时间间隔

所记录事件的源可以为服务或服务器。 与服务关联的事件将名称和服务类型显示为源属性。 与服务器关联的事件将记录消息的框架组件的名称显示为源属性。

以下为示例:

  • 与 SampleWorldCities 地图服务相关的事件显示为 SampleWorldCities.MapServer。

  • 在站点中成功创建服务器群集后,Admin 会显示为记录该消息的组件。

(可选)查询日志时,可指定要显示的所需源

计算机

参与站点的每台服务器计算机都会维护特定于该计算机的日志集。 如果您已将 ArcGIS Data Store 注册到您的站点上,则各数据存储计算机都将记录特定于该计算机的消息。

例如,服务器可能会记录错误:未能更新配置存储的位置。 只有那些应用于为特定计算机记录的统计数据的消息才会包括计算机属性。

查询日志时,您可以指定要显示的所需计算机

代码

这是与消息相关联的日志编码。 如日志代码概述所述,编码分为若干范围。

历时

这是完成记录事件所需的时间(毫秒)。 例如,用于导出 Web 地图图像的事件使用经历的时间来表示导出 Web 地图图像所花费的时间。

用户名

这是所提交的请求导致生成日志消息的用户的名称。 启用安全性后,此属性可用于帮助您追踪单个用户的活动。

进程

这是记录事件的计算机进程 ID。

线程

这是生成消息的服务器进程线程。

请求 ID

这是在提交每个向 ArcGIS Server 提出的请求时附加的唯一 ID 字符串,该字符串将在请求的整个系统生命周期中传递。

方法名称

此为在日志消息中生成的服务上调用的方法。

使用日志过滤器缩小搜索结果范围

为了帮助您缩小事件范围并显示相关信息,可根据日志级别、日志保存期限(时间)、源组件和计算机进行查询。 查询时可组合使用上述任意过滤器。 可以在 Manager 中的查看日志页面上访问这些过滤器。

日志过滤器

根据详细程度级别,可将事件按照从严重(表示需要立即对该问题加以注意)到详细(正常使用服务器时生成的详细的信息性消息)进行区分。 从日志过滤器下拉列表中选择所需的级别。 有关每个级别的详细摘要,请参阅上述级别部分。

保存期限

服务器记录的事件按时间顺序进行组织,最近发生的事件最先显示。 要按特定时间范围过滤事件,在保存期限下拉列表中指定所需的增量:

时间增量

描述

最近 15 分钟

显示最近 15 分钟内记录的事件

最近 1 小时

显示最近 1 小时内记录的事件

最近 6 小时

显示最近 6 小时内记录的事件

最近 24 小时

显示最近 1 天内记录的事件

上周

显示最近一周或站点在磁盘上保留日志的指定时间范围内记录的事件

自启动以来

显示自服务器上次重启以来或站点在磁盘上保留日志的指定时间范围内记录的事件

全部

显示安装 ArcGIS Server 后或站点在磁盘上保留日志的指定时间范围内记录的所有事件

单击时间列标头,按升序或降序对消息进行排序。

请记住,查询将仅返回 ArcGIS Server 站点在磁盘上保留日志的指定时间范围内的日志。 默认值为 90 天。 例如,如果站点配置为将日志保留五天,则从保存期限过滤器中选择上周时,将仅返回最近五天的日志。

提示:

单击设置,指定服务器在磁盘上保留日志的时长。 有关详细信息,请参阅指定服务器日志设置

所记录事件的源可以为服务或服务器。 与服务关联的事件将名称和服务类型显示为源属性。 与服务器关联的事件将记录消息的框架组件的名称显示为源属性。

默认情况下查询所有源(下拉列表中的所有选项)。 要查询特定服务或服务器框架组件,请从过滤器中选择服务或组件名称。 有关记录的事件所显示的源的描述,请参阅下表。

注:

下面介绍的 Admin、Server、Rest 和 Soap 源聚合在过滤器中的服务器框架级别下。 要查询这些源,请从下拉菜单中选择服务器框架

描述

Admin

表示消息已被管理 API 记录。 管理 API 是可用于管理服务器(例如,创建站点、添加计算机和服务、配置集群)的服务器层。

服务器

表示消息已被负责创建服务实例的服务器框架部分记录。

Rest

表示消息已被服务器的 REST 处理程序记录。 Rest 组件记录所有级别的消息。

Soap

表示消息已被服务器的 SOAP 处理程序记录。 SOAP 组件记录所有级别的消息。

ArcGIS Data Store

表示消息已被 ArcGIS Data Store 记录。 仅当将 ArcGIS Data Store 注册到 ArcGIS Server 时,才会显示这些消息。

.FeatureServer

源是要素服务。

.GeocodeServer

源是地理编码服务。

.GeoDataServer

源是地理数据服务。

.GeometryServer

源是几何服务。

Geometry.GeometryServer

源是随 ArcGIS Server 一起安装的预先配置的几何服务。

.GPServer

源是地理处理服务。

CachingTools.GPServer

源包含随 ArcGIS Server 一起安装的预先配置的缓存工具。

PrintingTools.GPServer

源是随 ArcGIS Server 一起安装的预先配置的 PrintingTools 服务。

PublishingTools.GPServer

源包含随 ArcGIS Server 一起安装的预先配置的发布工具。

.ImageServer

源是影像服务。

.KmlServer

源是 KML 服务。

.MapServer

源是地图服务。

.NAServer

源是网络分析服务。

.WCSServer

源是网络覆盖服务。

.WFSServer

源是 Web 要素服务。

.WMServer

源是工作流管理器服务。

.WMSServer

源是 Web 地图服务。

.WMTSServer

源是 Web 地图切片服务。

.WPSServer

源是 Web 处理服务。

.SceneServer

源是场景服务。

.SchematicsServer

源是 Schematics 服务。

.SearchServer

源是搜索服务。

SampleWorldCities.MapServer

源是随 ArcGIS Server 一起安装的预先配置的 SampleWorldCities 地图服务。

Search.SearchServer

源是随 ArcGIS Server 一起安装的预先配置的搜索服务。

Search_indexer.GPServer

源是预先配置的搜索服务随附的 _indexer 地理处理服务。

_indexer.GPServer

源是搜索服务随附的 _indexer 地理处理服务。

计算机

参与站点的每台服务器计算机都会维护特定于该计算机的日志集。 如果您已将 ArcGIS Data Store 注册到您的站点上,则各数据存储计算机都将记录特定于该计算机的消息。

默认情况下查询所有计算机(下拉列表中的所有选项)。 要查询特定计算机记录的事件,请从计算机过滤器中选择所需计算机。

翻阅服务器日志

在“查看日志”模块中执行查询时,日志消息窗口会显示 1,000 条与查询匹配的最新消息。 这些消息的时间范围在日志消息窗口底部显示。

如果您的查询返回超过 1,000 条消息,单击日志消息窗口底部的较早按钮,翻页到下一组记录。 同样,单击较新按钮快进时间。

在翻阅记录时,日志消息窗口不会自动更新以纳入查询执行后可能被记录的新消息。 单击查看日志模块上的查询,获取查询的最新结果。

以方便打印的格式查看日志

在执行查询后,单击方便打印的视图链接,以方便打印的格式查看日志。 这会打开一个新的浏览器窗口(或标签页),以 HTML 形式显示日志。 可使用此视图打印日志,将 HTML 保存到磁盘,或者将日志复制粘贴到文档或电子表格中。 通过这种方式,可以与组织中的其他成员(如有必要,还可同 Esri 支持)共享您的日志消息。

方便打印的视图仅显示上次执行的查询、日志消息窗口的当前视图以及所指定的所有日志记录属性。 然而,如果您在事件日志显示中对列进行了排序或重新排序,HTML 视图会将列恢复为查询首次执行时的原始状态。 可将日志复制粘贴到电子表格中,然后使用应用程序中的工具对列进行排序和重新排序。

删除日志

单击删除日志,删除参与站点的每台服务器的所有日志消息。 在单击删除日志后,系统会提示您确认删除所有日志的决定。

对导致服务器问题的特定场景进行调试时,删除日志有助于隔离该问题。 例如,如果您尝试确定地图服务中特定图层的绘制性能,建议删除日志,向地图发送请求,并更新日志消息窗口以显示请求事件。 这样将从日志中清除所有其他事件,使您能够集中精力调试地图服务。