Documentation forSolarWinds Observability

Add a self-managed host

Before adding your host entity to SolarWinds Observability, verify your firewall configuration permits TCP/HTTPS/TLS outbound connections to the SolarWinds Observability Agent endpoints on port 443. See Firewall or access control requirements.

To monitor your self-managed host with SolarWinds Observability:

  1. In SolarWinds Observability, click Add Data in the upper-right corner.

  2. In the Add Data dialog, click Host.

  3. In the Add Host dialog, select whether you want to enable host monitoring on an already deployed SolarWinds Observability Agent (SWO Agent) or whether you want to install a new SWO Agent.

    • To deploy the host monitoring plugin on an installed SWO Agent, select the Enable Host Monitoring option, and select a host to enable the plugin on. Click Next, review the Summary and close the wizard.

    • To deploy a new SWO Agent with the host monitoring plugin, select Install New Agent and click Next.

  4. Specify an Ingestion token that identifies the SWO Agent when sending the data into SolarWinds Observability and click Next.

    • To create a new token, select Generate New Token and provide a name for the new token.

    • To use an existing token, select Use Existing Token and select a token from the list.

  5. Select the operating system of your target host.

  6. Copy the installation script to the clipboard. On the target host, open the command prompt or terminal as an administrator and run the copied script.

    This installation script contains a unique ID used to track the installation status. Do not reuse this script.

    Alternatively, install the SolarWinds Observability Agent on the target host in one of the following ways:

    • Windows Installation Wizard

      1. Click the Installer tab.

      2. Download the Windows installer on the target host.

      3. Copy the script and run it to install the SolarWinds Observability Agent on the target host.

    • Linux Package Manager

      1. Click the Installer tab.

      2. Select the Package Manager.

      3. Download the Linux software package for the selected Package Manager.

      4. Copy the command and run it on the target host.

    • Instrumented method

      Click the Instrumented tab, copy the attributes/variables, use them in the role/recipe as described in the linked instructions for the selected instrumentation.

      • Ansible role: Use the role in galaxy.ansible.com to automatically install the SolarWinds Observability Agent with Ansible.

      • Chef recipe: Use the recipe in supermarket.chef.io to automatically install the SolarWinds Observability Agent with Chef.

    See Agents and Troubleshoot SolarWinds Observability Agent installation issues for details on configuring and installing SolarWinds Observability Agents.

  7. Optional: When the installation is complete, you can continue to observe host data:

    • Click Host Details to continue to the host details page and find out more about the target host.

    • Click Host Lists to continue to the list of hosts monitored in SolarWinds Observability.

    • Click Agents to continue to the Agents page to view and manage all deployed SolarWinds Observability Agents and their plugins.

  8. When you complete the configuration, SolarWinds Observability displays data collected for the host entity. See Entity Explorer for details.

See SolarWinds Observability introduction for an overview of host entities and how they work in SolarWinds Observability.