Help Docs

How to install Site24x7's Linux Full-Stack Agent

Install the Linux Full-Stack Agent to monitor the performance and usage of your Linux servers, applications, databases, logs, and more. Monitor and measure critical metrics like CPU, memory, disk utilization, processes, and network traffic of Linux servers from a unified dashboard. Site24x7 uses the Full-Stack Agent to collect performance data from your servers and APM performance metrics .

Supported Linux flavors

Site24x7 Linux Full-Stack Agent supports various Linux distributions, including Debian, Ubuntu, CentOS, Red Hat, Oracle Linux, Amazon Linux, SUSE, Raspberry Pi, and ARM processor servers. The detailed list of versions supported (compatibility matrix) is given in this knowledge base document for server monitoring and in this knowledge base document for APM Insight auto-profiler.

Note

Python 3.0 is the minimum version required for a few custom Linux distributions.

Prepare for Full-Stack Agent deployment

  1. Access to port 443.
  2. Access to Site24x7's domains and IP addresses and firewall exclusion for the APM Insight agent communication .

Deploy the Full-Stack Agent

  1. Log in to your Site24x7 account.
  2. On the left navigation pane, click Server, then the plus icon (+) next to Servers, then Linux .
    • Alternatively, you can navigate to Admin > Add a Server Monitor > Linux .
  3. Use the toggle button to install the agent as root or non-root, run the agent as root or non-root after installation, set proxy, enable APM Insight, and more.For example, to install the agent as a root user, execute the following command:
wget https://staticdownloads.site24x7.com/server/Site24x7FullStackAgent_LinuxIns.sh
bash Site24x7FullStackAgent_LinuxIns.sh -i -automation=true  -apm_insight=true -key=<device key>
Note

Refer to our Knowledge Base document to understand more about the differences between root and non-root installations.

You can view the device key by navigating to Admin > Developer > Device Key .

Click the Copy to Clipboard button to copy the commands, then paste and execute them to download and install the Linux agent.

Once the agent is installed, you can view the monitor under Server > Server Monitor > Servers .

Note

You can also associate Configuration Profiles —including threshold, resource check, and notification profiles—during agent installation itself.

Restart the Linux Full-Stack Agent

Execute the below commands based on the user type.

Root user:

sudo /opt/site24x7/monagent/bin/monagent restart

Non-root user:

<home_dir_of_user_who_installed_the_agent>/site24x7/monagent/bin/monagent restart

Edit/Modify existing Linux server monitors

  1. Log in to Site24x7 and go to Server > Server Monitor > Servers > click on the Linux server monitor you wish to edit.
  2. Next to the display name, hover over the hamburger icon and click Edit .
  3. Edit and change the display name, monitor group , dependency on monitor , threshold and availability profile , notification profile , user groups , tags , resource check profiles , and more.
    4. Note

    The Host Name, IP address, and Associated Configuration Template are also listed. These fields cannot be edited.

  4. Set the Poll Interval (i.e. the frequency for data collection). You can choose from a range of 1 min, 2 mins, 3 mins, 5 min, 10 mins, 15 mins, 30 mins, 1 hour, 3 hours, 6 hours, 12 hours, and one day. Read on to find out how to edit the frequency interval .
  5. Use the toggle button to enable or disable Syslog Monitoring. Once an option is chosen and changes are saved, the agent will restart the syslog service to remove the rsyslog configuration.
  6. Integrate new or remove existing third-party integrations from Site24x7.
  7. Click Save to save your changes.

Uninstall the Linux Full-Stack Agent

Execute the below commands based on the agent installation mode.

Root user:

sudo /opt/site24x7/monagent/bin/uninstall

Non root user:

<home_dir_of_user_who_installed_the_agent>/site24x7/monagent/bin/uninstall

Resource check profiles

Resource check profiles can be used to monitor internal resources like files, directories, and syslogs. The resources to be monitored should be added as checks to a resource check profile, and this profile can be associated with any number of server monitors. You can also edit or delete a resource check profile.

Note

A profile that is associated with a server monitor cannot be deleted, it can only be edited. Due to it being an irreversible action, caution must be taken before deleting the profile.

IT Automation

Reduce manual intervention and bring in an automated workflow to take action during an alert event. Add an automation .

Configuration Rules

Configuration templates have been deprecated. Use Configuration Rules to create better pre-defined actions and automate the configuration settings of your monitoring resources.

Plugin integrations

Monitor your entire IT stack with our ready-to-use plugin integrations or write your own plugin using Python or Shell scripts. Configure thresholds and be notified when the set value exceeds.

Associate Configuration Profiles during Full-Stack Agent installation

You can associate configuration profiles (like threshold, resource checks, and notification profiles, as well as group/display name) during the installation of the Linux Full-Stack Agent itself. Refer to our server monitor configuration rules help document and APM Insight help document for instructions. Read a use case to know how this works.

Security

A root user or a non-root user can install the Linux agent. Once the agent is installed, the user can opt to run the site24x7-agent as root or non-root. The agent is stored in this location:

  • Root: 
    /opt/site24x7/monagent
  • Non-root: 
    <home_dir_of_user_who_installed_the_agent>/site24x7/monagent

Collection of performance data

Performance data is collected using shell commands like top , free , df , ps , etc. Configuration data—including the agent device key (for authorization purposes) and proxy details—are encrypted and stored in the agent configuration file. It is stored in this location:

  • Root: 
    /opt/site24x7/monagent/conf/monagent.cfg
  • Non-root: 
    <home_dir_of_user_who_installed_the_agent>site24x7/monagent/conf/monagent.cfg

Applications monitoring

Once the Linux Full-Stack Agent is installed, Docker containers are auto-discovered and marked for monitoring. If you wish to monitor only your servers, this option can be disabled. Learn more .

Troubleshooting tips

A Linux server monitor consumes one host monitor license. Get the performance metrics provided for a Linux monitor here .

Refer to our FAQ section for more information.

Was this document helpful?

Would you like to help us improve our documents? Tell us what you think we could do better.


We're sorry to hear that you're not satisfied with the document. We'd love to learn what we could do to improve the experience.


Thanks for taking the time to share your feedback. We'll use your feedback to improve our online help resources.

Shortlink has been copied!