监控门户日志可帮助您标识错误、排除故障并解决门户问题。 使用 ArcGIS Portal Directory 可查看、查询、配置和删除门户日志。 ArcGIS Portal Directory 将日志消息聚集到一张表格中,以便您进行阅读和处理。
本帮助主题中的各部分介绍门户日志以及如何使用门户日志解决问题。
捕获、查询和查看事件
门户中发生事件时,门户会捕获事件并将其记录到日志中。 查询日志可查看与事件相关的消息。 遵循以下步骤可查询和查看门户中的当前消息:
- 打开 ArcGIS Portal Directory,以管理员身份登录。 URL 通常为 https://webadaptorhost.domain.com/webadaptorname/portaladmin。
- 单击日志 > 查询。
- 保留所有默认设置,然后单击查询。
随即返回一些消息和详细信息。 例如,如果某用户因多次输入错误密码而导致帐户锁定,您将看到以下消息:
在上述场景中,用户 jon_cho 尝试登录,但输入的密码错误。 尝试十次后,强制执行了帐户锁定策略,该用户的帐户被锁定。 这种情况可能还表示有恶意的用户尝试访问门户。
所有事件均会记录以上信息,例如日志级别类型、事件发生时间、记录信息的源组件、发生事件的计算机、与事件关联的用户、日志编码和进程 ID。 所有这些信息都可以帮助您更有效地解决门户问题。 有关此信息的详细说明,请参阅了解日志。
安装和安装后日志记录行为
安装或升级门户时,门户的日志级别设置为详细。 这意味着安装或升级进程期间将记录非常详细的消息。
如果在此过程中遇到故障并想要查看日志以便帮助您排除故障,请确定您是否可以访问 ArcGIS Portal Directory。 如果可以,查询日志并查看消息。 如果不可以,则查看磁盘上的日志消息。 要访问磁盘上的日志,请浏览至日志目录并打开最近的日志文件(例如 C:\arcgisportal\logs\<machine name>\portal\portal-20150101.095803-8596-0.0.log)。 如有必要,可以将此信息共享给 Esri 技术支持。
安装或升级过程完成后,门户的日志级别默认设置为警告。 这意味着只记录程度从中等到严重的问题。 如果门户用户报告了问题,您需要更改日志级别,以便捕获有关该特定问题的更加详细的消息。 要了解如何修改日志记录级别,请参阅指定门户日志设置。
怀疑出现问题时
如果您怀疑门户存在问题,或者用户报告了问题,请重现事件,捕获包含日志的事件,查询日志以获取事件相关信息,然后使用日志中的信息解决事件引起的问题。
如果您怀疑存在问题或用户报告了问题,可利用以下决策树帮助您捕获包含日志的事件:
- 尝试重现问题:
- 如果可以重现问题,则查询日志并查看消息以获取该问题相关信息:
- 如果没有信息,则提高日志记录级别。 再次重现问题,查询日志并查看消息。
- 如果日志消息中存在信息,则查看信息以帮助您解决问题。
- 如果无法重现问题,则记下导致这一问题的场景,以防再次出现。
- 如果可以重现问题,则查询日志并查看消息以获取该问题相关信息:
提示:
如果问题与发布相关,还建议您查看 ArcGIS Server 日志。 服务器日志可能会提供其他信息,以便帮助您解决发布问题。
以下示例介绍如何捕获事件、查询事件以及标识包含日志的事件。
用户无法向要素服务添加附件
例如,某个用户报告其无法向要素服务添加附件。 用户进行了多次尝试,但是无法上传文件。
- 打开 ArcGIS Portal Directory,以管理员身份登录。 URL 通常为 https://webadaptorhost.domain.com/webadaptorname/portaladmin。
- 单击日志 > 设置 > 编辑。
- 将日志级别设置为信息,然后单击更新。 门户现以信息级别记录消息。
- 要求用户重现问题。 要求用户记录下重现问题的步骤和时间段。
- 在 ArcGIS Portal Directory 中,单击日志 > 查询。
- 指定用户获得的时间值。 格式为 yyyy-mm-ddThh:mm:ss。 例如,开始时间为 2015-05-10T14:05:00,结束时间为 2015-05-10T14:03:00。
- 指定查询以返回信息日志级别的消息。
- 在用户字段中,指定成员的用户名。 例如,为 John Cho 指定 jcho。
- 单击查询。
- 查看消息字段以了解与问题相关的消息。
您看到以下消息:
Failed to add attachment. File size limit of 20 MB exceeded for feature service '/gis/rest/services/Hosted/parks3k_19/FeatureServer/0/1/addAttachment'.
现在,您了解到用户尝试上传的文件超出文件大小限制。 通知用户将文件大小减小到 20 MB 以内。
用户指定的用户名或密码无效
此类事件记录在默认的警告级别。 要捕获此类事件,需要将日志级别设置为警告或更低,例如:
- 打开 ArcGIS Portal Directory,以管理员身份登录。 URL 通常为 https://webadaptorhost.domain.com/webadaptorname/portaladmin。
- 单击日志 > 设置 > 编辑。
- 验证级别是否设置为警告或更低。 如果不是,将日志级别设置为警告(或更低),然后单击更新。
- 根据需要打开 ArcGIS Portal Directory,然后单击日志 > 查询。
- 指定查询以返回警告日志级别的消息。 忽略其他所有字段,这将返回所有用户的警告级别消息。
- 查看消息字段以了解与问题相关的消息。
您看到以下消息:
Sign in error: Invalid username or password specified for 'asmith'.
此消息提示用户 asmith (Ashley Smith) 在尝试登录门户时指定的用户名或密码无效。 监控这些事件以防止出现未经授权的访问尝试。
项目从一个文件夹移动到另一个文件夹
要捕获此类事件,需将日志级别提高至信息,例如:
- 打开 ArcGIS Portal Directory,以管理员身份登录。 URL 通常为 https://webadaptorhost.domain.com/webadaptorname/portaladmin。
- 单击日志 > 设置 > 编辑。
- 将日志级别设置为信息,然后单击更新。 门户现以信息级别记录消息,并针对从一个文件夹移动到另一文件夹的项目记录相关事件。
- 根据需要打开 ArcGIS Portal Directory,然后单击日志 > 查询。
- 指定查询以返回信息日志级别的消息。 忽略其他所有字段,由于已经设置级别,这将返回所有用户的信息级别消息。
- 查看消息字段以了解与问题相关的消息。
您看到以下消息:
Item moved from folder 'jcho/(Home)' to folder 'jcho/(Home)/Utilities'. Item ID is 'b7557bd2691b4e74bc4ce3e373402cc6'.
此消息提示用户 jcho (John Cho) 将一个项目(ID 为 b7557bd2691b4e74bc4ce3e373402cc6)从其主目录文件夹 (Home) 移动到了 Utilities 文件夹的子目录中。
了解日志
所有事件均会记录特定信息,例如日志级别类型、事件发生时间、记录信息的源组件、发生事件的计算机、与事件关联的用户、日志编码和进程 ID。 所有这些信息都可以帮助您更有效地解决门户问题。 以下几个部分将详细介绍此信息。
日志类型
根据详细程度级别,可将记录的事件按照从严重(表示需要立即对该问题加以注意)到详细(正常使用门户时生成的详细的信息性消息)进行区分。
日志级别类型如下:
等级 | 描述 | 示例消息 |
---|---|---|
Severe | 需要立即加以注意的严重问题。 此级别仅包括严重消息。 | The 'System/GPServer/PublishingTools' service is stopped or ArcGIS Server is not started. Verify these components are started and try again. |
警告 | 需要加以注意的中度问题。 此级别也包括严重消息。 | Organization updated: HTTP access disabled. The portal can only be accessed through HTTPS. |
信息 | 门户的普通管理消息,包括正在更新的组织设置相关消息。 此级别也包括严重和警告消息。 | User 'asmith' signed in to the portal. |
精细 | 由于使用门户而生成的普通消息,如操作名称和收到的请求。 此级别包括严重、警告和信息消息。 | Account settings updated. |
详细 | 此消息提供有关门户如何完成操作和请求的更多详细信息。 此级别包括严重、警告、信息和精细消息。 | Setting log level to VERBOSE before creating new site. |
调试 | 非常详细的消息,旨在供想要在进行故障排除时更深入地了解门户状态的开发人员和支持技术人员使用。 不要在生产环境中使用此级别,因为该级别可能会降低性能。 如果您没有解决问题,请改用警告级别。 | Failed to update index for item '44b37137e1f64de2bec832ab82043b86'. |
关 | 关闭日志记录。 门户不会记录事件。 | N/A |
消息
此消息与所记录的事件相关。 根据日志级别类型的不同,消息的详细程度也有所不同。
时间
所记录事件的发生时间。 事件按时间顺序进行组织,最近发生的事件最先显示。 时间格式为 yyyy-mm-ddThh:mm:ss。 查询日志时,您可以指定要显示的所需时间段。
源
根据共享、管理和软件的门户组件生成记录事件源。 与发布和用户相关的事件分类到共享下。 与安全性和索引相关的事件分类到门户管理下。 与软件安装相关的事件分类到门户下。 查询日志时,可根据需要指定要显示的所需源。
计算机
发生事件的门户计算机。
用户
所提交的请求导致生成日志消息的用户的名称。 启用安全性后,此属性可用于帮助您追踪单个用户的活动。
编码
与消息相关联的日志编码。 编码根据特定范围和内容归为若干类别。 查询日志时,您可以指定要显示的特定遍码或编码范围。
类别 | 范围 | 消息内容 |
---|---|---|
发布 | 200000-201999 | 发布和删除托管服务。 |
内容管理 | 202000-203999 | 添加、移除、更新和移动项目。 更改项目所有权。 将项目共享给所有人、组织和群组。 |
安全性 | 204000-205999 | 内置或企业用户登录。 门户令牌生成和配置。 禁用和启用帐户注册。 禁用和启用 ArcGIS Portal Directory。 导入或导出安全证书。 创建、删除和禁用用户。 更改用户角色权限。 创建和删除自定义角色。 禁用和启用 HTTPS 和匿名访问。 更新标识存储。 |
组织管理 | 206000-207999 | 自定义组织主页。 配置图库、底图、显示单位、实用程序服务和联合服务器。 创建和删除群组。 向群组添加用户和移除群组中的用户。 邀请用户加入群组或接受加入群组的邀请。 配置 ArcGIS Pro 许可。 ArcGIS Web Adaptor 配置。 修改门户内容目录位置。 配置转发代理服务器和反向代理服务器。 超出为门户授权的指定用户数量。 编辑日志设置和删除日志。 |
安装和升级 | 208000-209999 | 安装和升级软件、创建门户网站以及授权软件。 |
搜索索引 | 210000-211999 | 生成门户项目搜索索引。 |
常规 | 212000-219999 | 重新启动门户。 配置高可用性门户。 其他常规消息通过正常使用门户生成。 |
进程
记录事件的计算机进程 ID。
在查询中使用事件过滤器缩小搜索结果范围
为缩小事件范围并显示关联度更高的消息,可根据时间、日志级别、特定日志编码或编码范围、特定用户或用户列表以及门户源组件来进行查询。 查询时可组合使用上述任意过滤器。
要访问这些过滤器,请登录到 ArcGIS Portal Directory,然后单击主页 > 日志 > 查询。
日志级别
根据详细程度级别,可将事件按照从严重(表示需要立即对该问题加以注意)到详细(正常使用门户时生成的详细的信息性消息)进行区分。 从日志级别下拉列表中选择所需的级别。 有关每个级别的详细摘要,请参阅上述日志级别部分。
源
根据共享、管理和软件的门户组件生成记录事件源。 例如:
- 与发布和用户相关的事件分类到共享下。
- 与安全性和索引相关的事件分类到门户管理下。
- 与软件安装相关的事件分类到门户下。
默认情况下查询所有源(下拉列表中的所有选项)。 要根据特定源过滤事件,可从源下拉列表中选择所需的源。
时间
要根据特定时间段过滤事件,可通过开始时间和结束时间字段指定所需的时间值(格式为 yyyy-mm-ddThh:mm:ss)。 开始时间为最近时间,结束事件为最早时间。 例如:
- 要定义十五分钟的时间间隔,则开始时间为 2015-05-01T13:15:00,结束时间为 2015-05-01T13:00:00。
- 要定义一小时的时间间隔,则开始时间为 2015-05-01T14:00:00,结束时间为 2015-05-01T13:00:00。
- 要定义一天的时间间隔,则开始时间为 2015-05-02T12:00:00,结束时间为 2015-05-01T12:00:00。
- 将时间字段留空可查询所有日志。
如果指定了开始时间但未指定结束时间,则返回截至指定开始时间的所有最早日志。 相反,如果指定了结束时间但未指定开始时间,则返回截至指定结束时间的所有最新日志。
日志编码
每条消息都有日志编码。 如上所述,这些编码分为若干类别。 您可以根据特定编码或编码范围进行过滤,例如:
- 要过滤单个编码,则指定编码值(例如 204028)。
- 要过滤特定编码,则使用逗号 (,) 分隔编码(例如 204028, 212015, 219114)。
- 要根据编码范围过滤(例如,安全类别中的所有编码),则指定开始编码和结束编码,并用短划线 (-) 分隔(例如 204000–205999)。
- 要根据编码范围和单个编码过滤,则指定开始编码和结束编码(使用短划线分隔),然后使用逗号分隔单个编码(例如 204000–205999, 212015, 219114)。
用户
要根据特定用户过滤事件,则在用户字段中指定所需用户名,例如:
- 要过滤某个特定用户,则指定用户名(例如,为 John Cho 指定 jcho)。
- 要过滤多个用户,则使用逗号 (,) 分隔用户名(例如,jcho, asmith 表示 John Cho 和 Ashley Smith)。
注:
不支持使用通配符 (*)。
消息计数
执行查询时显示的消息数。 消息显示在单个 Web 页面上。 如有必要,可向下滚动页面查看所有消息。
删除日志
如果要删除日志,则单击主页 > 日志 > 清除 > 清除日志。 此操作将从门户计算机中删除所有日志消息。 对导致门户问题的特定场景进行调试时,删除日志有助于隔离该问题。 这样将从日志中清除任意其他事件,使您能够集中精力调试问题。