使用日志文件

正常情况下,Tableau Server 会在其活动过程中创建日志文件。在您排查 Tableau Server 问题时或者 Tableau 支持人员需要使用日志来帮助您解决问题时,您可能需要使用服务器日志文件。

您可以使用 tsm maintenance ziplogs 命令创建压缩日志文件存档。压缩的存档包含您可以解压缩和查看或者发送给 Tableau 支持人员的日志副本。在您拥有存档副本之后,可以从服务器删除存档。有关日志文件存档的详细信息,请参见日志文件快照(将日志存档)

这组主题提供了有关如何创建日志文件存档的信息、特定日志文件的内容以及有关您何时可能需要查看文件和如何查看的详细信息。

Tableau Server 日志的内容

每个 Tableau Server 进程都会将其所执行操作的相关信息写入其自己的日志文件。这些文件单独提供有关每个流程操作的详细信息。这些日志文件加在一起包含有关 Tableau Server 组件在处理用户请求或执行自动任务时内部通信的详细信息。Tableau Server 日志仅包含可用于故障排除的技术信息;不同组件的状态、不同进程执行的操作、通信尝试、对数据库的查询(不包括结果)以及请求的时间等。

日志文件可以包含某些特定数据,例如数据库服务器的名称,以及其 IP 地址和端口、Tableau Server 计算机的名称或 IP 地址,和用户访问的工作簿和视图的 URL 和名称。

日志文件不包含任何敏感客户数据,例如密码、查询结果或视图上显示的数据。

注意:DEBUG 级别记录日志时,Tableau 启动时会收集完整的环境信息。这意味着,如果环境变量中有任何敏感信息,它可能会包含在日志中。在默认的 INFO 级别进行日志记录则只会收集安全环境信息。

tsm maintenance ziplogs 命令使用户不仅能生成日志文件的压缩存档,还可以包括 Tableau Server 存储库数据(如果指定了 -d 选项)。存储库包含来自 Tableau Server 的元数据(例如,用户名、组、项目、Tableau Server 上的权限、数据提取刷新计划)。存储库还包括工作簿的布局和连接信息,但没有任何数据,例如密码、数据库中的实际数据或视图上显示的数据。

视图中显示的数据来自数据提取文件或数据库,并缓存在内存中。它不保存在日志中,或者在实时连接的情况下保存在 Tableau Server 计算机上的单独文件中。数据提取文件以 .hyper 文件的形式存储在计算机上的 dataengine 文件夹中,但永远不会包含在压缩的日志存档中。

调查 Tableau Server 问题

Tableau Server 可能出现的问题的范围和复杂性不同,这意味着没有可用于调查所有问题的简单过程,但常规方法包括以下步骤:

  1. 清理现有日志文件以减小其大小。有关详细信息,请参见移除不需要的文件

    重要信息:如果您可能希望从 Tableau 支持部门获取帮助来对问题进行故障排除,请务必在清理日志之前创建日志的压缩存档。清理操作可能会删除支持部门可能需要的重要信息。有关创建日志存档的详细信息,请参见日志文件快照(将日志存档)

  2. 设置适当的日志记录级别。Tableau 支持人员将指示您执行此操作。有关信息同,包括不同日志级别的影响,请参见更改日志记录级别
  3. 重现您要解决的问题,以便日志捕获与问题相关的事件。
  4. 创建日志的存档。有关详细信息,请参见日志文件快照(将日志存档)

    重要信息:在查看日志文件时使用此存档。不应直接在服务器上编辑、移动或删除任何文件。

  5. 查看 TSM 管理控制器日志 (\tabadmincontroller\tabadmincontroller_node<n>-<n>.log),了解 TSM 通过命令行、Web UI 或 API 完成的任何配置或部署,包括 TSM 启动的作业。首先查看控制器日志。您可以在其中获得最有用的信息。

    注意:tsm.logtabadmincontroller_*.log 相比字数较少,但可以提供有用、免费的故障排除信息。

  6. 查看 Apache 日志 \httpd\access.####_##_##_##_##_##.log\httpd\error.log中可能与您要调查的问题相关的请求。

    Apache 日志将包含大量不适用于您遇到的问题的“无用数据”。

    • 如果您找到似乎与您的问题相关的请求,请在 vizqlserver 目录中搜索包含 Apache 日志中的唯一请求 ID 的条目。
    • 查找与请求 ID 关联的响应代码和消息。
    • 搜索与您的问题相关的工作簿、视图、仪表板或数据源的名称。确保查找相关的时间戳。
    • 如果您找到可能与您的问题相关的请求,请查看与该请求关联的响应代码。(200 表示正常,500 表示问题)。
    • 找到与您已确定的请求关联的唯一请求 ID(唯一请求 ID 位于请求的末尾,是一个包含 24 个字符的字母数字字符串)。
  7. 进一步查看日志存档,以搜索其他消息和可能的错误。

    • 使用 Apache 日志中的请求 ID 搜索日志存档的 vizqlserver 文件夹,以查找包含相关日志条目的文件。查找问题的迹象(例如错误消息或长时间运行的查询)。
    • 免费、开源的工具 Logshark 是查看日志存档的有用选项。有关详细信息,请参见 Tableau Blueprint 中的 Tableau Server 疑难解答(链接在新窗口中打开)
  8. 查看脚本日志记录。

    Tableau Server 为大多数脚本包括了日志,这些脚本位于 scripts 目录中。默认情况下:C:\Program Files\Tableau\Tableau Server\packages\scripts.<version_code>\ 这些日志将保存到:

    • <install_drive>\<install\path>\logs\
      默认情况下为: 
    • C:\ProgramData\Tableau\Tableau Server\logs\
  9. 与支持人员联系

    如果您自己无法解决问题或者 Tableau 支持人员要求您这么做,请将压缩的存档发送给 Tableau。

感谢您的反馈!您的反馈已成功提交。谢谢!