Skip to main content

使用系统日志

ArcGIS Enterprise on Kubernetes 将记录您的组织中所发生的事件，并且与这些事件相关的所有错误也会被记录在日志中。 日志可通过 ArcGIS Enterprise Manager 查询，或通过第三方可观测性解决方案捕获。

您可以使用日志来监控并解决组织中的问题。 日志中的信息可帮助您标识错误，并提供用于解决问题的上下文。 日志还会编译随时间推移的事件和模式历史记录。

使用 Enterprise Manager

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

  1. 以管理员身份登录到 ArcGIS Enterprise Manager。

  2. 单击侧边栏上的日志按钮可查看当前日志。

    随即返回一些消息和详细信息。

所有日志都将记录几条事件相关信息。 您可以查看和切换显示以下内容的列：

  • 日志事件的时间和日期

  • 事件的日志级别

  • 日志消息

  • 日志事件的源

  • 日志事件的请求 ID

  • 与事件相关联的用户名

  • 事件发生的服务类型

  • 发生日志事件的节点

  • 事件相关日志代码

  • 事件的堆栈追踪

您还可以根据时间、日志级别、来源、请求ID、用户名、服务类型和日志代码过滤日志。

注:

如果您的组织无法检索日志，请检查系统存储的健康状态。 当时空存储和索引存储不健康时，您的组织将无法访问日志。 可以使用 Lens 或其他 Kubernetes IDE 查看 Kubernetes 事件，检查管理 Pod 的日志，并在需要时重新启动 Pod。

更新日志保留时长

您可以为系统日志设置日志保留策略。 默认情况下，系统日志将保留 60 天，然后才会将其删除。

要更新保留期的长度，请执行以下操作：

  1. 在日志页面上单击设置。

  2. 在日志设置页面，更新日志保留时长。

  3. 单击保存。

删除日志消息

要删除日志消息，请进行以下操作：

  1. 在日志页面上，单击删除按钮 。

  2. 在删除日志消息页面上，您有以下选项：

    • 选择日志级别 - 选择要删除的一个或多个日志级别。

    • 选择时间段 - 选择要删除日志消息的时间段。

    • 选择自定义时间段 - 如果选中，请选择要从中删除日志消息的自定义时间段。

  3. 单击删除。

使用第三方工具

除了由 ArcGIS Enterprise 存储外，系统日志还会被流式传输至标准输出 (stdout)。 这使您能够使用第三方可观测性解决方案（如 Datadog 或 Splunk）来处理日志。 每个 stdout 日志条目作为独立的结构化 JSON 对象，使用换行分隔的 JSON 写入单独行。

以下示例日志条目展示了应用日志所使用的模式，这些日志具有 "eventType":"arcgis-logs"。 安全相关事件的审计日志会用不同的模式单独流式传输到标准输出。

{"date":1777073486.102182,"msgTimestamp":"2026-04-24T23:31:25,968","logLevel":"DEBUG","source":"Workflow Manager","logCode":"46300","processID":"1","threadID":"1","className":"WorkflowManager","msg":"Creating ArcGIS Client request for https://arcgis-rest-portal-api.arcgis.svc.cluster.local:8443/arcgis/sharing/rest/generateToken ","stackTraces":"\n","input":{"type":"log"},"log":{"file":{"path":"/arcgisusr/logs/arcgis_logfile.log"}},"fields":{"serviceTypes":"","deploymentID":""},"pod":"arcgis-workflow-manager-gkruq-6cff58b755-pnpq9","eventType":"arcgis-logs"}
注:

date 字段记录事件发送至标准输出的时间戳，msgTimestamp 字段记录原始日志事件的时间。

用户可以通过命令 kubectl logs 访问标准输出日志，以从目标 pod 中的 fluent-bit 容器中检索日志。 更多信息请参见关于 kubectl 日志的 Kubernetes 文档

使用日志进行故障排除

如果您怀疑服务器或节点存在问题，或者用户报告了问题，则可以重现事件，捕获包含日志的事件，然后查询日志获取事件相关信息。 之后，便可使用日志中的信息解决事件引起的问题。

如果您怀疑存在问题或用户报告了问题，请尝试重现该问题。 如果您可以重现该问题，则请查询相关日志并查看消息以获取可能有用的信息。 例如，如果用户报告 Web 服务存在性能问题，则请重现其操作并监视日志以查看所出现的问题。 您可能会发现一条能够指出原因的错误消息。

如果没有信息，则提高日志记录级别。 此举将扩大捕获日志的范围，并可能提供有用的信息。

日志级别

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

下表介绍了这些日志级别：

日志级别

描述

示例消息

严重

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

无法处理请求。 找不到服务 X。

警告

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

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

信息

普通管理消息，包括有关服务创建和启动的信息。 此级别也包括严重和警告消息。

访问组织账户设置。

精细

常见消息包括诸如接收到的操作请求的名称之类的信息。 此级别还包括严重、警告和信息消息。

检查过期项目。

详细

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

开始图层绘制：counties。

调试

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

清理目录。

更新日志级别

在 ArcGIS Enterprise Manager 中使用系统日志时，可能需要提高日志记录级别以捕获和查看事件。

您可扩大日志的记录范围。 您也可检查与服务创建和启动有关的日志，在这种情况下，您可将日志级别从默认的警告更改为信息。

要在 ArcGIS Enterprise Manager 中更新日志级别，请执行以下操作：

  1. 在日志页面上单击设置。

  2. 在日志设置页面中设置想要的默认日志级别。

  3. 单击保存。

更新日志索引

要解决与访问日志有关的问题（例如，如果未生成新日志或现有日志已变得不可用），您可更新日志索引。

要在 ArcGIS Enterprise Manager 中更新日志索引，请执行以下操作：

  1. 在日志页面上单击设置。

  2. 在日志设置页面上，单击更新日志索引。