管理 Agent
TapData Cloud 为您提供了云端服务，适合需要快速部署、低前期投资场景，帮助您更好地专注于业务发展而非基础设施管理，注册账号即可领取免费的 Agent 实例，欢迎试用。
TapData Cloud 支持对 Agent 的可视化运维管理，您可以通过页面管理已安装的 Agent，也可以通过命令行管理。
通过页面管理 Agent
-
单击左侧导航栏的资源管理。
-
在 Agent 资源页面选择执行下述操作。
序号 操作 说明 ① 创建 Agent Agent 可支持多平台安装，具体操作，见安装 Agent。 ② 停止 Agent 单击停止可暂停 Agent 的运行，可用于临时维护场景，后续需要通过命令行启动 Agent。 ③ 重启 Agent 重新启动 Agent。 ④ 退订 Agent 如不再需要 Agent，可将其停止后单击退订，完成退订后不可恢复，更多介绍，见退订实例。 ⑤ 升级 Agent 当有新版本可用时，版本信息右侧会显示升级图标，单击该图标后选择升级方式：
● 自动升级：Agent 状态为运行中时可选择该方式，升级完成后升级图标会自动消失，如遇升级失败可手动
升级。
● 手动升级：根据弹窗的提示，在 Agent 所安装的设备上执行升级命令。
💡 为避免升级操作影响任务运行，请在升级前停止该 Agent 相关的任务。
通过命令管理 Agent
根据 Agent 安装的平台选择，查看相关命令介绍：
- Linux 平台
- Windows 平台
- Docker/Mac（M1 芯片） 平台
- 阿里云计算巢
进入 Agent 的安装目录，选择执行下述命令：
- 查看命令帮助：
./tapdata help - 查看 Agent 状态：
./tapdata status - 启动 Agent：
./tapdata start - 停止 Agent：
./tapdata stop
进入 Agent 的安装目录，选择执行下述操作：
- 查看 Agent 状态：双击应用程序 status.bat
- 启动 Agent：双击应用程序 start.bat 或 tapdata.exe
- 停止 Agent：双击应用程序 stop.bat
- 执行
docker ps获取容器 ID。 - 执行下述格式的命令进入容器命令行。
需替换命令中的容器 ID，例如
docker exec -it 容器ID /bin/bashdocker exec -it 1dbee41b4adc /bin/bash。 - 在容器命令行中，进入 Agent 的安装目录，然后选择执行下述命令：
- 查看命令帮助：
./tapdata help - 查看 Agent 状态：
./tapdata status - 启动 Agent：
./tapdata start - 停止 Agent：
./tapdata stop
- 查看命令帮助：
-
登录阿里云并进入计算巢控制台。
-
找到您的计算巢实例并单击其 ID，进入概览页面。
-
单击资源页签，找到 Agent 安装到的 ECS 示例（名称包含 tapdata），单击其右侧的远程连接。
-
在跳转到的命令窗口中，执行
cd /data/tapdata进入 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