Home Servers Support Guide: Adding a New Server

Support Guide: Adding a New Server

Last updated on Nov 23, 2024

Adding a new server is a straightforward process. This guide walks you through the steps to set up and monitor a server in your dashboard.


Step-by-Step Instructions

  1. Navigate to the Servers Page

    • From the dashboard, go to the Servers page, which lists all currently monitored servers.
  2. Click on "Add Server"

    • At the top of the page, click the "New" or "Add Server" button to open the server configuration modal.
  3. Fill Out the Add Server Form

    • Complete the fields in the modal:

      • Server Name: Enter a name that helps you identify the server (e.g., "Main Web Server").

      • Ping Address: Provide an IP address or domain name for the server to ping. This address will be used to monitor connectivity from the server you are adding.

      • Process List:

        • Select one of the following options:

          • None: Do not include any processes.

          • Top Ten: The system automatically selects the top ten processes based on resource usage (e.g., CPU, disk, or memory utilization).

          • All: Includes all running processes.

        • Important: If you plan to set up alerts for monitoring whether a specific process is running, you must select All.

  4. Save the Server

    • Once all fields are filled, click "Add" or "Save" to complete the setup. The server will now appear in the Servers table.

Installing the Monitoring Agent

  1. Open the Server Details

    • Click on the newly added server in the Servers table. This opens the server details page.
  2. Run the Installation Commands

    • An Install Agent box will automatically pop up, displaying the commands you need to install the monitoring agent on your server.

    • Copy and paste one of the provided commands into your server’s terminal:

      • wget: For environments where wget is available.

      • curl: For environments where curl is the preferred option.

  3. Follow the Installation Steps

    • The installation process will set up the monitoring agent on your server.

    • If you encounter issues, refer to the Installation Troubleshooting Guide for detailed help.


Verify Installation and Wait for Data

  1. Wait for Data Collection

    • After installation, it may take approximately 1 minute for the monitoring agent to collect and send the first set of data to the dashboard.
  2. Refresh the Dashboard

    • After 1 minute, refresh the Servers page to view the server's performance metrics and status.

Important Notes

  • Ping Address: This monitors connectivity from the newly added server to the specified address. Ensure the address is reliable for accurate monitoring.

  • Process List:

    • Selecting All is required if you plan to create alerts for processes (e.g., monitoring if a service like nginx stops running).

    • The Top Ten option selects processes based on resource usage heuristics (e.g., high CPU, disk, or memory consumption).

  • Installation Issues: If you encounter any problems during the agent installation, detailed help is available in the Troubleshooting Guide linked in the installation box.