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

管理 Agent

Tapdata Cloud 支持对 Agent 的可视化运维管理,您可以通过页面管理已安装的 Agent,也可以通过命令行管理。

通过页面管理 Agent

  1. 登录 Tapdata Cloud 平台

  2. 单击左侧导航栏的资源管理

  3. Agent 资源页面选择执行下述操作。

序号操作说明
创建 AgentAgent 可支持多平台安装,具体操作,见安装 Agent
停止 Agent单击停止可暂停 Agent 的运行,可用于临时维护场景,后续需要通过命令行启动 Agent。
重启 Agent重新启动 Agent。
退订 Agent如不再需要 Agent,可将其停止后单击退订,完成退订后不可恢复,更多介绍,见退订实例
升级 Agent当有新版本可用时,版本信息右侧会显示升级图标,单击该图标后选择升级方式:
自动升级:Agent 状态为运行中时可选择该方式,升级完成后升级图标会自动消失,如遇升级失败可手动
升级。
手动升级:根据弹窗的提示,在 Agent 所安装的设备上执行升级命令。
💡 为避免升级操作影响任务运行,请在升级前停止该 Agent 相关的任务。

通过命令管理 Agent

根据 Agent 安装的平台选择,查看相关命令介绍:

进入 Agent 的安装目录,选择执行下述命令:

  • 查看命令帮助:./tapdata help
  • 查看 Agent 状态:./tapdata status
  • 启动 Agent:./tapdata start
  • 停止 Agent:./tapdata stop

Agent 目录说明

Agent 在安装和执行任务的过程中,会自动在安装目录中生成一些文件,用于存放任务信息、日志、配置文件、数据源证书等信息,详细介绍如下:

tap_table_ehcache: 任务运行时相关数据源的表模型的缓存

├── cert                                        # 存放中间库的证书文件
├── application.yml # Agent 配置文件
├── CacheObserveLogs # 存放监控日志的缓存数据
├── components # 存放引擎执行的 jar 包
├── connectors # 存放数据源插件相关文件
├── etc # 存放中间库初始化脚本
├── fileObserveLogAppenderV2 # 存放可观测性日志,子目录以任务 ID 命名
├── logs # 存放引擎运行产生的日志
├── tapdata # Agent 程序
├── tapdataDir # 记录引擎的工作目录
└── tap_table_ehcache # 存放任务运行时相关数据源的表模型缓存
提示

为确保 Agent 的稳定运行和快速定位故障,请勿删除上述目录或文件。

调整 Agent 运行内存

找到 Agent 安装目录下的配置文件 application.yml,编辑该文件,根据服务器的可用内存调整内存配置信息,例如配置为 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
……

保存修改后,重启 Agent 生效:

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