Stop/restart OneAgent on Linux

  • 1-min read
  • Published Sep 19, 2018

In case you don't want to use OneAgent inside a particular Java (or other) process, you can easily disable Dynatrace monitoring for individual hosts, process groups, or applications:

  1. Go to Settings > Monitoring overview.
  2. Click the Hosts, Process groups, or Applications tab to access the monitoring switches for individual entities.
  3. Slide the Monitoring switch to the Off position.
  4. Restart all processes for which monitoring has been disabled.
Hot cloning

Hot cloning is generally not supported by OneAgent due to host ID generation requirements. When hot cloning a host with OneAgent installed, follow these steps to ensure proper functionality:

  1. Stop OneAgent on the original host.
  2. Clone the host.
  3. Start OneAgent.
  4. Perform process restarts on the new host.

Restart using OneAgent command-line interface

When you use the set parameters, you need to restart OneAgent service to apply changes. You can use the --restart-service parameter with the command that triggers the restart automatically. In some cases you'll also need to restart monitored applications. You can also use the restart parameter on its own, without other parameters. See an example command below.

./oneagentctl --set-proxy=my-proxy.com --restart-service

For more information, see OneAgent configuration via command-line interface.

Stop OneAgent using the command line

If you use configuration management tools like Puppet or Ansible, you can alternatively stop the OneAgent service using the following command:

  • for systems with SystemV: service oneagent stop
  • for systems with systemd: systemctl stop oneagent

where oneagent is the init.d script for OneAgent.

If you stop OneAgent service, monitoring will be disabled until the service is restarted.

Start OneAgent using the command line

To start Dynatrace OneAgent again, use the following command:

  • for systems with SystemV: service oneagent start
  • for systems with systemd: systemctl start oneagent

where oneagent is the init.d script for OneAgent.

Learn more about how Dynatrace interacts with your OS.