--- schema_version: "1" id: 5cb54f9d9607bec08778800c3fa528cf7e09f2c42cf33c21a22bddeb4eacf48a title: 代理事件 collection: tableau version: next locale: zh-cn portal_url: https://docs.salesforce.com/tableau/next/zh-cn/server-linux/rmt-incidents-agents-unlicensed.md canonical_url: https://help.tableau.com/v0.0/server-linux/zh-cn/rmt-incidents-agents-unlicensed.htm source_site: help.tableau.com content_type: documentation content_hash: 22c60f3c1315ef690ca45fa7adac2eff3c80c428ba81ebb7d8536d8fa4c19c78 description: Understand and resolve RMT agent incidents such as unlicensed agents. --- [跳转到主要内容](#main-content) # 代理事件 [代理未获许可](#Agents)（严重） [不兼容的代理版本](#Incompat)（严重） [代理消息队列凭据轮换失败](#MQCredFail)（严重） [代理关闭](#Agent)（警告） 为了与我们公司的平等价值观保持一致，我们在可能的情况下更改了非包容性术语。由于在某些地方更改术语可能会导致重大更改，因此我们保留现有术语：因此，您可能会继续在 CLI 命令和选项、安装文件夹、配置文件和其他实例中看到这些术语。有关详细信息，请参见[“关于 Tableau 帮助”](https://help.tableau.com/current/tableau/zh-cn/about-tableau-help.htm)。 ## 代理未获许可 当检测到您的 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](https://help.tableau.com/v0.0/server-linux/zh-cn/itm_intro.htm)。 **注意：**向 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 升级到相同的更高版本。您可能需要升级其他代理，具体取决于它们当前的版本。 ### 升级代理： 使用以下步骤来升级代理： - 1. 将代理程序包复制到安装了代理的计算机。代理安装在您正在监视的 Tableau Server 节点上。代理应与 RMT Server 的版本相同，或使用与 RMT Server 版本兼容的版本。事件详细信息提供了最低兼容版本。 2. 使用以下命令停止所有 Tableau Server 节点上的 Resource Monitoring Tool 代理服务： `rmtadmin stop --agent` 3. 通过运行以下命令来升级所有代理： **对于类似于 RHEL 的发行版（包括 CentOS）：** `sudo yum install /-x86_64.rpm>` `sudo /opt/tableau/tabrmt/agent/install-scripts/upgrade-rmt-agent --accepteula` **对于 Ubuntu 和 Debian 发行版：** 如果要从版本 2020.4 升级到 2020.4.1 或更高版本： `touch /tmp/tabrmt-agent-upgrading.txt && sudo apt install -amd_64.deb>` `sudo /opt/tableau/tabrmt/agent/install-scripts/upgrade-rmt-agent --accepteula` > [!IMPORTANT] > > **注意：**仅在从 2020.4 升级时才需要 touch 命令。如果在安装程序包之前未运行 touch 命令，则在升级之前将卸载现有版本的 Resource Monitoring Tool。 如果要从版本 2020.4.1 升级到 2020.4.2 或更高版本： `sudo apt install /-amd_64.deb>` `sudo /opt/tableau/tabrmt/agent/install-scripts/upgrade-rmt-agent --accepteula` 4. 确认代理正在运行并且已升级。您可以通过导航到**“管理”**\->**“环境”**\->**“编辑环境”**\->**“服务器”**选项卡来查看代理注册状态，以查看 Tableau 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 /-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 -amd_64.deb>` `sudo /opt/tableau/tabrmt/master/install-scripts/upgrade-rmt-master --accepteula` > [!IMPORTANT] > > **注意：**仅在从 2020.4 升级时才需要 touch 命令。如果在安装程序包之前未运行 touch 命令，则在升级之前将卸载现有版本的 Resource Monitoring Tool。 如果要从版本 2020.4.1 升级到 2020.4.2 或更高版本： `sudo apt install /-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用户。