Windows 版 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 升级到相同的更高版本。您可能需要升级其他代理，具体取决于它们当前的版本。

升级代理：

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

1. 下载代理安装程序，并将其复制到需要升级代理的 Tableau Server 节点。代理应与 RMT Server 的版本相同，或使用与 RMT Server 版本兼容的版本。事件详细信息提供了最低兼容版本。

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

   rmtadmin stop --agent

3. 在需要升级的代理上运行代理安装程序。

   注意：如果您使用的是非默认位置，请在“EULA”页面单击“ Customize”来提供自定义安装位置。Tableau 建议使用 \Tableau\Tableau Resource Monitoring Tool 作为代理的安装位置。示例非默认位置：D:\Tableau\Tableau Resource Monitoring Tool。

4. 确认代理正在运行并且已升级。您可以通过导航到“管理”->“环境”->“编辑环境”->“服务器”选项卡来查看代理注册状态，以查看 Tableau Server 节点的完整列表和代理的状态。

升级 RMT Server

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

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

1. 在浏览器中登录到 Resource Monitoring Tool，并在开始升级之前确认其正常工作。

2. 将 RMT Server 安装程序复制到安装了 RMT Server 的计算机。

3. 在所有代理上停止“Tableau Resource Monitoring Tool 代理”Windows 服务。

4. 在 RMT Server 上停止 Tableau Resource Monitoring Tool Windows 服务。

   注意：停止这些服务之后，最好在服务停止之后检查是否有任何 “Resource Monitoring Tool” 进程正在运行：任何包含 tabrmt-agent 或 tabrmt-master 的进程。这不包括 PostgreSQL 或 RabbitMQ。

5. 完全停止 RMT Server 上运行的所有进程可能需要一段时间，因此请在任务管理器中等待没有任何名称中包含 Resource Monitoring Tool 的进程正在运行，然后再执行下一步。

6. 在 RMT Server 上运行安装程序。这将安装或升级任何必需的必备组件，然后升级 RMT Server。

   注意：如果您使用的是非默认位置，请在“EULA”页面单击“ Customize”来提供自定义安装位置。Tableau 建议使用 \Tableau\Tableau Resource Monitoring Tool 作为 RMT Server 的安装位置。示例非默认位置：D:\Tableau\Tableau Resource Monitoring Tool。

7. 确认代理和 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用户。