Skip to main content

Manage Agent

Applicable EditionsTapData CloudTapData Cloud offers you cloud services that are suitable for scenarios requiring rapid deployment and low initial investment, helping you focus more on business development rather than infrastructure management. Free trial with TapData Cloud.

TapData Cloud provides visual management and maintenance capabilities for Agents. You can manage installed Agents through the dedicated page or by executing commands.

Manage Agent by Web​

  1. Log in to TapData Platform.

  2. Click Resource Management in the left navigation panel, and then choose which operation to perform.

Agent support multi-platform installation, see Install Agent.

Manage Agent by Command​

According to the platform selection of the Agent installation, view the relevant command description:

Navigate to the installation directory of the Agent and proceed by executing the following command:

  • View command help: ./tapdata help
  • Check the status of the Agent: ./tapdata status
  • Start Agent: ./tapdata start
  • Stop Agent: ./tapdata stop

Agent Directory Description​

During the installation and execution of the task, the Agent will automatically generate some files in the installation directory for storing task information, logs, configuration files, data source certificates and other information, as detailed below:

tap_table_ehcache: Cache the table's structure of the data source associated with the task runtime.

β”œβ”€β”€ cert/                                   # Certificate files for the middleware database
β”œβ”€β”€ application.yml # Agent configuration file
β”œβ”€β”€ CacheObserveLogs/ # Cached monitoring logs
β”œβ”€β”€ components/ # Jar files for engine execution
β”œβ”€β”€ connectors/ # Files related to data source plugins
β”œβ”€β”€ etc/ # Initialization scripts for the middleware database
β”œβ”€β”€ fileObserveLogAppenderV2/ # Observability logs, subdirectories named as task IDs
β”œβ”€β”€ logs/ # Logs generated by the engine during runtime
β”œβ”€β”€ tapdata/ # Agent program
β”œβ”€β”€ tapdataDir/ # Recording the working directory of the engine
└── tap_table_ehcache/ # Cached table models of data sources


To ensure the smooth operation of the Agent and enable efficient fault detection, please refrain from deleting the mentioned directory or file.

Adjust Agent Runtime Memory​

To adjust the memory configuration in the Agent installation directory, locate the application.yml configuration file and edit it accordingly. Set the tapdataJavaOpts: -Xms4G -Xmx8G to allocate 4GB as the initial memory and allow a maximum of 8GB.

tapdataPort: '3030'
backendUrl: ''
apiServerPort: ""
tapdataJavaOpts: "-Xms4G -Xmx8G"
reportInterval: 20000
uuid: a5f266a1-a495-412f-a433-29d345713c176

After saving the changes, restart the Agent to take effect:

# Stop Agent
./tapdata stop -f
# Start Agent
./tapdata start