Linux 版 Tableau Server 帮助

代理未获许可（严重）

不兼容的代理版本（严重）

代理消息队列凭据轮换失败（严重）

代理关闭（警告）

为了与我们公司的平等价值观保持一致，我们在可能的情况下更改了非包容性术语。由于在某些地方更改术语可能会导致重大更改，因此我们保留现有术语：因此，您可能会继续在 CLI 命令和选项、安装文件夹、配置文件和其他实例中看到这些术语。有关详细信息，请参见“关于 Tableau 帮助”(链接在新窗口中打开)。

代理未获许可

当检测到您的 Tableau Server 未获得适当许可来使用 Tableau Resource Monitoring Tool 时，则会记录“代理未获许可”严重事件。

若要使用 Resource Monitoring Tool 监视 Tableau Server，必须使用 Tableau Advanced Management 为 Tableau Server 授予许可。

代理在未许可状态下将不再收集数据并发送到 RMT Server。不过，您可以继续查看以前在环境获得适当许可的情况下收集的数据。

为了解决此问题，需要使用 Advanced Management 许可 Tableau Server。有关详细信息，请参见关于 Tableau Server 上的 Tableau Advanced Management。

注意：向 Tableau Server 添加有效许可证后，最多可能需要一个小时才能清除事件。

还有其他可能导致“Agents Unlicensed”事件的原因：

• Tableau Server API 凭据可能不正确。在环境配置页中，验证用户名和密码是否正确，以及所使用的帐户在 Tableau Server 上是否具有“服务器管理员”角色。

• 无法连接到 Tableau Server REST API。确保在 Tableau Server 上启用了 REST API，并且 Tableau Server 正在运行。

  为了解决 REST API 连接问题，请从“Admin”菜单中选择“Environments”，针对要修改的环境单击“Edit Environment”，并在“Environment Details”选项卡中单击页面右侧“Tableau Server REST API”部分中的“Test Connection”按钮。

• RMT Server 无法连接到 Tableau Server，原因可能是存在网络连接问题或类似问题。

不兼容的代理版本

当环境中的一个或多个代理的版本与 RMT Server 版本不兼容时，代理不兼容事件将被记录为严重事件。

为了解决此问题，您需要确保代理的版本与当前的 RMT Server 版本兼容。

使用以下方法之一来解决此问题：

• 如果代理的版本低于最低兼容版本，则您必须至少将代理升级到事件报告中列出的最低兼容版本。
• 如果代理的版本高于 RMT Server 版本，我们建议您也将 RMT Server 升级到相同的更高版本。您可能需要升级其他代理，具体取决于它们当前的版本。

升级代理：

使用以下步骤来升级代理：

升级 RMT Server

如果一个或多个代理的版本更高，请升级 RMT Server。

使用以下步骤来升级 RMT Server：

1. 将新版本的 RMT Server 程序包复制到安装了 RMT Server 的计算机。

2. 使用以下命令停止 RMT Server 上的 Resource Monitoring Tool：

   rmtadmin stop --master

3. 使用以下命令停止所有 Tableau Server 节点上的 Resource Monitoring Tool 代理：

   rmtadmin stop --agent

4. 停止这些服务之后，最好在服务停止之后检查是否有任何正在运行的 Resource Monitoring Tool 进程：任何包含 tabrmt-agent 或 tabrmt-master 的进程。这不包括 PostgreSQL 或 RabbitMQ。您可以使用以下命令检查状态：

   rmtadmin status

5. 在 RMT Server 上运行升级命令。这会将现有版本升级到新版本：

   对于类似于 RHEL 的发行版（包括 CentOS）：

   sudo yum install <pathtomasterserverinstaller>/<tabrmt-master-setup-<version>-x86_64.rpm>

   sudo /opt/tableau/tabrmt/master/install-scripts/upgrade-rmt-master --accepteula

   对于 Ubuntu 和 Debian 发行版：

   如果要从版本 2020.4 升级到 2020.4.1 或更高版本：

   touch /tmp/tabrmt-master-upgrading.txt && sudo apt install <tabrmt-master-setup-<version>-amd_64.deb>

   sudo /opt/tableau/tabrmt/master/install-scripts/upgrade-rmt-master --accepteula

   注意：仅在从 2020.4 升级时才需要 touch 命令。如果在安装程序包之前未运行 touch 命令，则在升级之前将卸载现有版本的 Resource Monitoring Tool。

   如果要从版本 2020.4.1 升级到 2020.4.2 或更高版本：

   sudo apt install <pathtomasterserverinstaller>/<tabrmt-master-setup-<version>-amd_64.deb>

   sudo /opt/tableau/tabrmt/master/install-scripts/upgrade-rmt-master --accepteula

6. 确认代理和 RMT Server 正在运行。如果代理和 RMT Server 在升级完成后未自动重新启动，则将它们启动。

代理消息队列凭据轮换失败

从版本 2021.3 开始，作为安全最佳实践，代理和 Rabbit MQ 之间的连接凭据必须是该代理的唯一凭证。唯一凭据是在新安装期间创建或在升级到 2021.3 时更新的。

在升级过程中，如果出现网络问题，凭据更新过程可能会失败，从而导致出现严重事件报告。但是，这不会中断升级过程，升级过程将继续。升级完成后， Resource Monitoring Tool 将每天重试以创建唯一凭据。为初始失败和随后每次失败的重试创建关键事件报告。在此期间，代理将继续使用以前的凭据工作，直到创建新凭据。

问题可能会自行解决，但如果问题仍然存在，请执行以下操作：

• 验证代理是否可以连接到 RMT Server。

• 检查代理和 RMT Server 之间的防火墙问题。

代理关闭

当 Tableau Resource Monitoring Tool 无法与 Tableau Server 上的代理通信时，代理关闭事件将被记录为警告。

使用以下步骤来排查此问题：

1. 确保托管代理的硬件正在运行并且可用于与 RMT Server 通信。
2. 确保代理服务已成功注册并正在运行。您可以通过导航到“管理”->“环境”->“编辑环境”->“服务器”选项卡来查看代理注册状态，以查看 Tableau Server 节点的完整列表和代理的状态。

代理轮询和事件创建时间

• 代理每 5 分钟向 Resource Monitoring Tool 服务器发送一次心跳消息。
• Resource Monitoring Tool 服务器将检查来自代理的最新心跳消息是否不到15分钟。
  • 如果从代理收到的最新心跳消息的时间不到 15 分钟，则认为代理处于联机状态，不会创建任何事件，并且会清除任何现有的代理关闭事件。
  • 如果从代理收到的最新心跳消息超过 15 分钟，则被视为首次尝试失败。此后每分钟都会进行一次检查，再检查两次。如果在三次尝试（第一次尝试和两次重试）后仍然没有最新的心跳消息，则会创建代理关闭事件。

  注意：根据上述轮询间隔，在座席脱机后创建代理关闭事件大约需要 17(15+1+1) 分钟。

谁可以执行此操作

具有服务器/环境管理角色的Resource Monitoring Tool管理员或Resource Monitoring Tool用户。