跳到主要内容
版本：3.x

部署与管理 Agent

本文列举 Tapdata Agent 在部署和运行遇到的常见问题。

部署 Agent​

Agent 有什么作用？​

Agent 是数据同步、数据异构、数据开发场景中的关键程序，负责通过流式技术从源系统获取数据、处理转换数据并发送到目标系统，由云上的管理端统一管理，工作流程如下：

Agent 架构

提示

Agent 通过流式技术从源端获取数据、处理转换数据并发送到目标端，数据不会流经 Tapdata Cloud，也不会上传和留存您的数据。

推荐将 Agent 部署在哪里？​

通常数据流转应用场景对时效性有较高的要求，因此，推荐将 Agent 部署在数据库所属的本地网络中，可最大程度降低网络延迟。

更多介绍，见部署 Tapdata Agent。

需要部署多少个 Agent？​

只需部署一个 Agent，需确保该 Agent 可和数据的来源/目标端可正常通信。

是否可以部署多个 Agent？​

可以，需要确保这些 Agent 可和数据的来源/目标端可正常通信。

提示

一个任务只会在一个 Agent 上运行，在任务比较多时，可部署多个 Agent 来解决单点负载问题。

部署了多个 Agent，某任务的 Agent 发生异常如何处理？​

您可以编辑对应的任务，然后为其手动指定一个正常运行的 Agent，再对异常的 Agent 进行排查，设置方法如下：

指定 Agent

如果 Oracle 是 rac 模式，aix 的两节点 rac，如何部署 Agent？​

只要可以连接到 rac 即可，即 Agent 能连到 rac 的 scan/vip，无需和 Oracle 部署在同一设备。

安装了DockerWindows (64 bit)，无法通过检测？​

推荐直接使用 Docker 方式部署 Agent。

如何再次获取部署所需的 token？​

1 个 Token 仅用于部署 1 个 Agent，如需部署多个 Agent，请前往 Tapdata Cloud 创建 Agent。

Agent 一直是部署状态检测中？​

您需要根据提示完成 Agent 的部署，部署完成后 Agent 状态会自动转换为运行中。如果超过 5 分钟还未显示正常，则可能部署失败，您可以联系我们获取技术支持，并提供日志协助定位问题。

管理 Agent​

Agent 启动报错：“start timout”？​

如果遇到启动 Agent 失败，您可以查看安装目录中的日志文件 logs/tapdata-agent.log，判断是否为网络问题，您也可以联系我们获取技术支持，并提供日志协助定位问题。

输入 token 后报错：“ java.lang.IllegalStateException: Cannot load configuration class: io.tapdata.Application”？​

软件包不完整，请更换一个版本重新安装。

如何检查 Agent 状态？​

  • 通过命令查看：登录部署了 Agent 的设备并进入 Agent 安装目录，执行 ./tapdata status 命令，示例如下，该 Agent 处于正常运行中。

    命令查看 Agent 状态

  • 通过界面查看：登录 Tapdata Cloud 平台，单击左侧导航栏的 Agent 管理即可查看所有 Agent 的状态，单击 Agent 名称还可以获取到该 Agent 安装的目录、日志等信息。

    界面查看 Agent 状态

Agent 意外停止了，如何启动 Agent ？​

登录部署了 Agent 的设备并进入 Agent 安装目录，执行 ./tapdata start 命令，如果无法启动可以联系我们获取技术支持，并提供日志协助定位问题。

Agent 正常运行，界面上却显示为离线？​

Agent 每分钟向 Tapdata Cloud 上报一次心跳信息，如果 Tapdata Cloud 连续五分钟没有收到心跳信息则会显示该 Agent 离线，通常由于网络波动引起，您可以检查 Agent 的状态以确认。

Agent 离线不影响已运行任务的正常运行，但是新建任务会受到影响。

如何卸载重装 Agent？​

根据您的部署方式选择下述方法卸载重装 Agent：

  • Docker 部署：直接删除容器，然后重新运行启动容器的命令即完成了重新安装。
  • Linux/Windows 上部署：
    • 全新安装
      1. 执行命令停止服务：./tapdata stop -f。
      2. 删除安装目录。
      3. 在 Tapdata Cloud 上创建 Agent 并根据提示完成部署。
    • 保留配置重装
      1. 保存 Agent 安装目录中的配置文件 application.yml。
      2. 执行命令停止服务：./tapdata stop -f。
      3. 删除安装目录。
      4. 创建新的安装目录，并将 application.yml 复制到该目录。
      5. 下载 tapdata 工具。
      6. 执行 ./tapdata start backend

Agent 运行时报错：“OutOfMemoryError”​

需要确认部署 Agent 设备是否具有充足的可用内存，具体解决方案如下：

  • 内存不足：更换部署 Agent 的设备，也可以尝试调小 Tapdata Cloud 平台中任务的每次读取数量配置值。

  • 内存充足

    1. 在 Agent 安装目录中，找到并修改 application.yml 文件

    2. 根据设备的可用内存量来调整内存大小，例如在文件里增加配置：tapdataJavaOpts: "-Xms4G -Xmx8G"，即初始内存为 4G，最大内存为 8G。

      tapdata:
          conf:
              tapdataPort: '3030'
              backendUrl: 'https://cloud.tapdata.net/api/'
              apiServerPort: ""
              tapdataJavaOpts: "-Xms4G -Xmx8G"
              reportInterval: 20000
              uuid: a5f266a1-a495-412f-a433-29d345713c176
          cloud:
              accessCode: ""
              baseURLs: 'https://cloud.tapdata.net/api/'
              username: null
              token: 
      spring:
          data:
              mongodb:
                  username: ""
                  password: ""
                  mongoConnectionString: ""
                  uri: ""
                  ssl: ""
                  sslCA: ""
                  sslCertKey: ""
                  sslPEMKeyFilePassword: ""
                  authenticationDatabase: ""

  1. 保存后执行下述命令重启 Agent。

    #停止 Agent
    ./tapdata stop -f
    #启动 Agent
    ./tapdata start