使用 ArcGIS Notebook Server 日志

ArcGIS Notebook Server 可将站点中发生的所有事件以及与这些事件相关的所有错误都写入日志。 这些日志可供站点管理员使用。

日志是用于监控和解决 ArcGIS Notebook Server 站点中所发生问题的重要工具。 日志提供的信息可帮助您标识错误，并提供用于解决问题和错误的上下文。 日志还可作为记录系统，用于记录站点中发生的事件。

例如，日志中记录有以下类型的事件：

• 安装和升级事件，例如软件授权和站点创建
• 打开和关闭 ArcGIS Notebooks
• 站点执行的整理任务
• 管理员执行的站点管理事件，例如添加或移除笔记本运行时、创建服务器目录或配置安全设置
• 安全事件，例如用户登录站点或 SSL 证书的导入和导出

一些事件不会记录在 ArcGIS Notebook Server 日志中。 其中包括联合站点和门户。 不会记录在 ArcGIS Notebooks 内发生的事件（添加内容、运行像元等）。 也不会记录计算机的 Docker 容器中发生的事件；要查看容器特定的日志，请参阅以下查看 Docker 容器日志部分。

可用日志级别

每个日志都具有日志记录级别的详细信息，如下按详细程度从列出（由简洁到详细）：

• 严重 - 严重问题，需要即刻加以注意。
• 警告 - 需要加以注意的中等严重的问题。
• 信息 - Notebook Server 站点的普通管理消息，包括有关服务创建和启动的消息。
• 精细 - 由于使用服务器而生成的普通消息，如收到的操作请求的名称。
• 详细 - 此类消息就服务器如何完成操作提供更多详细信息。
• 调试 - 非常详细的消息，旨在供想要在进行故障排除时更深入地了解服务器状态的开发人员和支持技术人员使用。 基于创建日志量的考虑，不建议在生产系统中使用。

您可以在 ArcGIS Notebook Server 管理员目录中指定要创建的最详细的日志级别。 例如，如果将级别设置为精细，则服务器站点将记录严重、警告、信息和精细级别的消息。

日志编码

日志编码范围与某些类型的消息相关联。 下表介绍了日志编码范围及其内容类型。

日志编码范围	消息内容
1000-4999	核心 ArcGIS Notebook Server 框架
5000-6999	关于 Docker SDK 和容器
7000-7200	笔记本
7200-7299	笔记本 Web 工具
7300-7399	笔记本快照
7400-7499	笔记本代码片段

在 Manager 中查询日志

自 10.8 版本起，ArcGIS Notebook Server Manager 包含日志页面。 在此页面上，可以查询 ArcGIS Notebook Server 站点的所有日志。

1. 以管理员身份登录到您的 ArcGIS Enterprise 门户，然后打开 ArcGIS Notebook Server Manager。
2. 打开日志页面。
3. 查询过滤器参数位于页面顶部。 可以使用任何参数来限制或扩展您的搜索。

   • 日志级别 - 要查询的最低日志级别（请参阅上一部分）。 将仅返回日志级别不低于此级别的记录。 默认级别为 WARNING。
   • 日志时间 - 用于搜索日志的持续时间。 可以将查询限制为最近 15 分钟、最近 1 小时、最近 6 小时或 24 小时、最近一周或最近 30 天，或者显示自站点创建以来的所有日志。

     提示：

     如果您要指定的结束时间不是当前时间，例如 3 天前与 2 天前之间的日志，请使用 Administrator Directory 来查询日志。

   • 计算机 - 将查询限制为其中一台 ArcGIS Notebook Server 计算机中的日志，或者显示所有计算机中的日志。
   • 请求 ID - 要查询其日志的一个或多个服务器请求的请求 ID（以逗号分隔）。 一些日志消息与特定请求有关。
   • 用户 - 要查询其相关日志的一个或多个用户的用户名（以逗号分隔）。 一些日志消息与特定用户的操作有关。
   • 日志代码 - 分配给日志消息的一个或多个日志代码。 如果留空，则将显示所有日志代码。

4. 单击搜索以运行查询。 所有符合查询参数的日志将显示在结果表中。

在 Manager 中更改日志设置

您也可以使用 ArcGIS Notebook Server Manager 来更改站点的日志设置。

1. 以管理员身份登录到您的 ArcGIS Enterprise 门户，然后打开 ArcGIS Notebook Server Manager。
2. 打开设置页面并单击日志。
3. 可以更改以下设置：

   • 日志目录 - 您的日志目录的磁盘位置。 如果您的站点中存在多台计算机，确保此路径为 UNC 共享。
   • 日志级别 - 您的站点将写入的最详细的日志级别。 例如，如果设置为 FINE，则您的站点不会将日志保持在 VERBOSE 或 DEBUG 级别。
   • 记录保留天数 - 删除日志消息前的天数。 请考虑日志目录驱动器中的可用内存以及所选日志级别设置和站点上的活动级别。 例如，如果更改日志级别以在更详细的级别开始写入，则可能需要减少保留日志的天数。

4. 单击保存确认您的更改。

在 Administrator Directory 中查询服务器日志

使用 ArcGIS Notebook Server 管理员目录查询、查看、配置和删除服务器日志。

要访问日志，请执行以下步骤：

1. 登录到 Administrator Directory。 URL 地址格式为 https://notebookserver.domain.com:11443/arcgis/admin 或 https://notebookserver.domain.com/<webadaptorname>/admin。
2. 单击日志 > 查询查询和查看当前日志。 使用页面上的过滤器控件可帮助您按类别（如时间段或日志级别）缩小事件范围。
3. 单击日志 > 设置管理日志设置，例如默认日志级别（如上所述）、日志在磁盘上的保留时间以及写入日志的位置。
4. 单击清除日志删除 ArcGIS Notebook Server 站点的所有日志文件。

使用 ArcGIS Notebook Server Manager 查看 Docker 容器日志

您可以使用 ArcGIS Notebook Server Manager 查看特定于站点 Docker 容器的日志。

1. 以管理员身份登录门户的 ArcGIS Notebook Server Manager。 URL 地址格式为 https://webadaptorhost.domain.com/webadaptorname/home/notebook/manager.html。
2. 浏览至容器选项卡。
3. 单击查看日志按钮以查看所选计算机的容器日志。

使用 Docker 命令行查看 Docker 容器日志

您可以使用如下 Docker 命令行界面查看特定于站点 Docker 容器的日志。

1. 登录到 Administrator Directory。 URL 地址格式为 https://notebookserver.domain.com:11443/arcgis/admin 或 https://notebookserver.domain.com/<webadaptorname>/admin。
2. 浏览至系统 > 容器。 找到要查看其日志的容器，然后单击其 ID。
3. 将 ?f=pjson 添加到其 URL 以打开容器信息页面的 JSON 视图，于是 URL 格式为 https://notebookserver.arcgis.com/<webadaptorname>/admin/system/containers/<container>?f=pjson。
4. 找到容器的 containerId 并记录其值。
5. 以具有 Docker 权限的用户身份打开终端。
6. 使用您记录的值运行命令 docker logs <containerId>。 此操作将返回特定于该容器的 Docker 日志。