2/14/2023 10:08 PM

4/4/2023 4:42 PM

Before using this tool, please make sure SolarWinds Administration service running on the main Poller.
Below is the new Topology Connections Diagnostics Tool that can be used to troubleshoot Topology issues?

Orion Platform

1. How to access the Topology tool

The tool can be accessed by the following URLs:
{orion_server_base_url}/apps/topology-diagnostics
or
{orion_server_base_url}/apps/topology-diagnostics/{sourceNodeId}/{destinationNodeId}
In the second case, you will be redirected to the test results to view the provided nodeids. You will see previous tests run results.
 

2. Components and controls

The tool consists of two main windows:
 2.1 Test result window - shows last run test results and nodes info

 
Test result window with expanded test result area

 
2.2 Test run window - shows nodes and tests selection controls

 
3. How to run/rerun tests
To run test(s) user with admin permissions should:

1. follow by mentioned link and enter login creds if needed
2. press the “Run check“ button OR “Run check again“ if there are some test results

 
3.1 Run test
Press the “Run check“ button, there will be a Test run window.
 
In that window, you should select source and destination nodes and choose the tests to run (or all tests).
 
Source and destination nodes may be pre-selected in the case by the node ids.
 
Search by node id/name when selecting nodes in dropdowns

 
 
After the selection has been made, you can press the “Run“ button.
YouTest result window,
 
3.2 Run test again
Press “Run check again“ button on Test result window, the selected tests or all visible UI tests (if all tests selected) will be re-run without any ask or additional windows.
You can investigate test results after they finished.
 
3.3 Check test results
Test results are visible in Test result window.
Each test result may have one of three test statuses:
Success - when test met success conditions

 Failed - when test met fail conditions

 Unknown - when it is not possible to define (for example, no records in table in case those records are used in defining success/failed scenarios)

When tests are running in progress, they are marked with spinner icon

 
Wait for the particular test or all tests to be finished before checking/downloading the results.
To check specific test result in UI,  click right arrow button in the line of selected test.

 
Test result will be shown for that test:

 
Test result will contain all needed information about the test, like Name, description, table (if needed), resolution (if needed), explanation, link to helpful articles etc.

 
Tests are designed in the way to help you to decide how to fix Topology problems.
 
4. Download test results
It is useful to have test results for specific nodes in text files.
For that purpose Topology tool contains “Download results“ functionality.
After pressing that button last test results run for selected nodes will be exported into two files:
html - results for failed tests in a user friendly readable format;
json - results for all tests for selected nodes in JSON format
Those two files will be compressed into one archive (ZIP) and saved locally.