Configuring the DataStax Agent JVM

Configure the JVM parameters for the DataStax Agent JVM.

The DataStax Agent JVM is designed to have a minimal footprint on your nodes and simply work without extra configuration for most environments.

JVM properties for the agent are configured in datastax-agent-env.sh.

Agent Heap Size 

For most environments, the DataStax agent should require very little heap. The agent ships with a default max heap size of 128M. The most common cause of memory issues on the agent are clusters with a large number of tables. Each additional table in the cluster increases the number of metrics collected as well as the size of the metadata collected for cluster operations such as backups. Clusters that have more than 100 tables might require updates to the agent max heap size. If an agent is experiencing OutOfMemory issues, try changing the -Xmx property in datastax-agent-env.sh to 512 (-Xmx512M). If OutOfMemory issues persist, try increasing heap size one more time to -Xmx1024M. If issues still persist, please contact DataStax Support so DataStax can determine whether your environment requires even more heap or if there is an issue in the agent.

datastax-agent-env.sh 

The default location of the DataStax agent environment shell script datastax-agent-env.sh depends on the type of installation:

  • Package installations: /etc/datastax-agent/datastax-agent-env.sh
  • Tarball installations: install_location/agent/conf/datastax-agent-env.sh