APM Insight Go Agent service management

To manage the Site24x7 APM Insight Go agent, use the service.sh script. You can start, stop, restart, check status, view version, uninstall the agent, or display help information.

Service script location: /opt/site24x7/apm-insight-go-agent/bin/service.sh

Command syntax

sudo /opt/site24x7/apm-insight-go-agent/bin/service.sh 

Available commands

Command details

1. Start the agent
   Starts the APM Insight Go Agent if it is not already running. If already running, you may receive a message stating that the agent was already started.
   

   sudo /opt/site24x7/apm-insight-go-agent/bin/service.sh start

2. Stop the agent
   Stops the running Go Agent.
   

   sudo /opt/site24x7/apm-insight-go-agent/bin/service.sh stop

3. Restart the agent
   Stops and restarts the agent in one step.
   

   sudo /opt/site24x7/apm-insight-go-agent/bin/service.sh restart

4. Check agent status
   Displays whether the agent is currently running or stopped.
   

   sudo /opt/site24x7/apm-insight-go-agent/bin/service.sh status

5. Show agent version
   Displays the installed agent version, useful for troubleshooting or compliance.
   

   sudo /opt/site24x7/apm-insight-go-agent/bin/service.sh version

6. Uninstall the agent
   Removes the APM Insight Go Agent from your system. Follow any on-screen prompts to complete the uninstallation process.
   

   sudo /opt/site24x7/apm-insight-go-agent/bin/service.sh uninstall
   or
   sudo /opt/site24x7/apm-insight-go-agent/bin/service.sh -u

7. Display help
   Shows usage information with command options.
   

   sudo /opt/site24x7/apm-insight-go-agent/bin/service.sh help
   or
   sudo /opt/site24x7/apm-insight-go-agent/bin/service.sh -h

Troubleshooting tips

• Ensure you have root (sudo) privileges for all operations.
• If you encounter a Permission denied error, make the script is executable:
  

  (chmod +x service.sh)

• After making any changes (like reinstalling the agent), always verify the agent status and version.
• If the agent fails to start, check system logs or Site24x7 Go Agent logs for details.

Managing the Go agent on Linux distributions

In addition to the service.sh script, you can manage the Go Agent service using your system’s init system.

Systemd-based distributions

Manage the agent service using systemctl commands:

# Start the service
sudo systemctl start apm-insight-go-agent.service

# Stop the service
sudo systemctl stop apm-insight-go-agent.service


# Restart the service
sudo systemctl restart apm-insight-go-agent.service

# Check service status
sudo systemctl status apm-insight-go-agent.service

# Enable service to start automatically on boot
sudo systemctl enable apm-insight-go-agent.service

# Disable automatic start on boot
sudo systemctl disable apm-insight-go-agent.service

#Start the service
sudo rc-service apm-insight-go-agent start 

#Stop the service 
sudo rc-service apm-insight-go-agent stop

#Restart the service 
sudo rc-service apm-insight-go-agent restart

#Check service status (may not always be available; consider inspecting logs)  
sudo rc-service apm-insight-go-agent status

#Enable service to start automatically on boot 
sudo rc-update add apm-insight-go-agent default

#Disable automatic start on boot
sudo rc-update del apm-insight-go-agent default

Legacy SysVinit distributions

If your system does not use systemd or OpenRC, it may be using SysVinit. Manage the agent service using service and update-rc.d commands:

# Start the service
sudo service apm-insight-go-agent start

# Stop the service
sudo service apm-insight-go-agent stop

# Restart the service
sudo service apm-insight-go-agent restart

# Enable service to start automatically on boot
sudo update-rc.d apm-insight-go-agent defaults

Related articles

• APM Insight Go agent configuration