Documentation forSolarWinds Platform Self-Hosted

Connect SolarWinds Observability Self-Hosted to SolarWinds Observability SaaS

If you have SolarWinds Observability Self-Hosted Essentials or Advanced license and also have SolarWinds Observability SaaS, you can use the Platform Connect feature to see SolarWinds Observability Self-Hosted data in SolarWinds Observability SaaS.

The Platform Connect also enables the use of Anomaly-Based Alerting in SolarWinds Observability Self-Hosted.

How does Platform Connect secure the information communicated from SolarWinds Observability Self-Hosted to SolarWinds Observability SaaS?

For data in transit from SolarWinds Observability Self-Hosted to SolarWinds Observability SaaS, SolarWinds Observability Self-Hosted encrypts the data using the TLS 1.2 protocol with a 2048 bit RSA certificate.

Requirements

To set up Platform Connect between SolarWinds Observability Self-Hosted and SolarWinds Observability SaaS, you will need the following:

  • A commercial or temporary (provided by SolarWinds) SolarWinds Observability Self-Hosted license activated on a SolarWinds Platform server

  • An active SolarWinds Observability SaaS instance (full or evaluation)

  • Connectivity between your SolarWinds Platform server and your cloud service provider for communication with SolarWinds Observability SaaS

  • A SolarWinds Observability SaaS API token

Set up Platform Connect

  1. Log in to the SolarWinds Platform Web Console using an account with administrative privileges.

  2. Click the Platform Connect icon in the menu bar. If Platform Connect is not configured, this launches a wizard to set it up. If already configured, you can see details.

    You can also launch the wizard by navigating to Settings > All Settings > scroll down to the Platform Connect section > Add/Edit Platform Connector.

  3. Accept the SolarWinds SaaS supplement to the license agreement.
  4. On Connect, specify the SolarWinds Observability SaaS account for setting up the Platform Connect. Select whether to create a new account or use an existing one.
    • Create a new account - select your cloud provider and type your email address. Click Install Agent to continue.

      If you don't have a SolarWinds Observability SaaS account, choose this option. With your new account, you can evaluate SolarWinds Observability SaaS and the Platform Connect feature for 30 days.

    • Use existing account - select this option, select your cloud provider, paste your token, and click Install Agent.

      1. Log in to your SolarWinds Observability SaaS account and go to Settings > API Tokens.

      2. To use an existing token, click the three dots next to the token, and select Copy Token.

      3. To create a new token, click Create API Token, provide a name for the new token and click Create. Then, click the clipboard icon to copy the token.

        Learn more about SolarWinds Observability SaaS API tokens.

      4. When you have your API Token, switch back to the SolarWinds Platform Web Console.

      5. In the Platform Connect Wizard, paste the API token from your clipboard to the Token field and Click Install Agent.

        The SolarWinds Platform Web Console will begin installing the SolarWinds Observability SaaS Agent on your SolarWinds Observability Self-Hosted server. The agent is the behind-the-scenes service that enables the connection between SolarWinds Observability Self-Hosted and SolarWinds Observability SaaS. You will see a confirmation toast when the installation is successful.

  5. On Configure Agent, select SolarWinds Observability Self-Hosted features you want to use in SolarWinds Observability SaaS.

    SolarWinds Observability Self-Hosted Features are enabled by default.

    SolarWinds Platform Module Features

    In addition to SolarWinds Observability Self-Hosted features, you can also stream data from other modules to SolarWinds Observability SaaS. If you don’t have an appropriate license, a trial license will be enabled so that you can evaluate available features in SolarWinds Observability SaaS for 30 days. After the trial period, polling data for unlicensed features will be discontinued and your license will revert back to its original status.

    1. Enable the SolarWinds Platform Module Features toggle.

    2. Enable streaming data to SolarWinds Observability SaaS.

    3. Enable features from individual categories you want to see in SolarWinds Observability SaaS.

      • Network & Infrastructure Observability

        By default, the data will be sent for all monitored nodes. Click the number of selected nodes to see a list of these nodes. By default, only network nodes and servers send data to SolarWinds Observability SaaS.

      • IP Management - DHCP, DNS, and subnets

      • Storage Observability - storage

  6. Select the features and click Next. Your SolarWinds Observability SaaS user name and organization displays at the top of the screen. You can also use the link to log in to SolarWinds Observability SaaS. Review the account information and click Connect at the bottom of the screen.

  7. After Platform Connect setup is completed, you can see enabled SolarWinds Observability Self-Hosted data in SolarWinds Observability SaaS.

Troubleshoot the Agent installation

If the Agent installation fails, make sure you have opened the following paths in the firewall:

  • *.amazontrust.com:80

  • *.ss2.us:80

These paths are used for online certificate status validation. See Online Certificate Status Protocol for details.

See Network requirements for more information.

Connect SolarWinds Observability Self-Hosted in High Availability mode using Platform Connect

To connect SolarWinds Observability Self-Hosted with High Availability deployed using Platform Connect, install the SolarWinds Observability SaaS Agent on your main server, following the steps below:

  1. Build the SolarWinds Observability Self-Hosted standby server and create the HA pool. For more information, see SolarWinds Platform High Availability deployment walk-through.

  2. Set up Platform connect on the main server.

  3. Force a manual failover. For more information, see Disable or delete HA pools, force a failover, or update an HA pool for SolarWinds Platform products.

  4. Install the SolarWinds Observability SaaS Agent on the standby server.

Edit what data is sent to SolarWinds Observability SaaS

  1. In the SolarWinds Platform Web Console, click the Platform Connect icon () in the menu bar. The Platform Connect details are displayed.

  2. On Agent Status, review the Network Collector version, the agent version and plugins status.

  3. On Settings, review the account used to configure the Platform Connect and enabled features. Use to toggles to change what data is being sent to SolarWinds Observability SaaS.

Disable Platform Connect

To temporarily stop sending all SolarWinds Observability Self-Hosted data to SolarWinds Observability SaaS, complete the following steps:

  1. In the SolarWinds Platform Web Console, click the Platform Connect icon () in the menu bar. The Platform Connect details are displayed.

    As an alternative, you can navigate to Settings > All settings > scroll down to the Platform Connect section > Add/Edit Platform Connector and select Disable Connection.

  2. Activate the Settings tab and disable the Platform Connect Status toggle.

Remove the connection between SolarWinds Observability Self-Hosted and SolarWinds Observability SaaS

To remove the connection, uninstall the Agent.

  1. In the SolarWinds Platform Web Console, click the Platform Connect icon () in the menu bar. The Platform Connect details are displayed.

  2. Click Uninstall Agent and complete the uninstallation. The connection is deleted. To connect SolarWinds Observability Self-Hosted and SolarWinds observability SaaS again, configure the connection from scratch.