SolarWinds
StackState Self-hosted v5.0.x
Overview
The SolarWinds StackPack allows near real time synchronization between SolarWinds Orion (SolarWinds) and StackState. When the integration is enabled, SolarWinds nodes, interfaces and connections will be added to the StackState topology as components and relations. In addition, health status is applied to the components in StackState.
Data flow
- Nodes, interfaces and connections are retrieved from the SolarWinds instance.
- Node and interface Health status is retrieved from the SolarWinds instance and translated to StackState values.
- StackState translates incoming nodes, interfaces and connections into topology components and relations.
Setup
Prerequisites
To set up the SolarWinds integration you will need to have:
- StackState Agent V2 installed on a machine that can connect to both SolarWinds (default via TCP port 17778) and StackState.
- To support component actions from StackState, the SolarWinds server needs to be accessible from the user's browser.
- A running SolarWinds instance with correctly configured Network Performance Monitor (NPM) and User Device Tracker (UDT) modules. For details see retrieved topology data.
- The lowest access level is sufficient.
- The user must not have any account limitations set that block access to nodes intended to be retrieved.
- To see relations between components, a layer 3 network device is required.
- A SolarWinds administrator needs to be available to add custom node properties.
Install
Install the SolarWinds StackPack from the StackState UI StackPacks > Integrations screen. You will need to provide the following parameters:
- SolarWinds Instance URL: The SolarWinds instance URL from which topology data will be collected.
- SolarWinds Instance Name: The user-defined name of the SolarWinds account shown in configurations such as views.
Configure
To enable the SolarWinds check and begin collecting data from SolarWinds, add the following configuration to StackState Agent V2:
- 1.Edit the Agent integration configuration file
/etc/stackstate-agent/conf.d/solarwinds.d/conf.yamlto include details of your SolarWinds instance:- url - the REST API URL, uses HTTPS protocol for communication. This should be a hostname or IP, it should not include the prefix
https://.
1init_config:23instances:4- url: <instance_name.solarwinds.localdomain>5username: <instance_username>6password: <instance_password>7solarwinds_domain: <instance_domain> # A SolarWinds custom property8solarwinds_domain_values: # A list of values used by the solarwinds_domain9- <instance_domain_value_1>10- <instance_domain_value_2>11- <instance_domain_value_n>12# min_collection_interval: 30 # use in place of collection_interval for Agent v2.14.x or earlier13collection_interval: 30Copied! - 2.Set the following filters:
- solarwinds_domain - The name of a SolarWinds custom property that will be used to select nodes from SolarWinds to include in the StackState dataset.
- solarwinds_domain_values - A list of values used by the SolarWinds custom property specified in
solarwinds_domain. Used to select the correct nodes for inclusion. Any node in SolarWinds that has one of these values set will be included in the data collection. Each value in this list will be represented as a separate domain in StackState.
- 3.
- 4.Once the Agent has restarted, wait for data to be collected from SolarWinds and sent to StackState.
Status
To check the status of the SolarWinds integration, run the status subcommand and look for SolarWinds under
Running Checks:1
sudo stackstate-agent status
Copied!
Upgrade
When a new version of the SolarWinds StackPack is available in your instance of StackState, you will be prompted to upgrade in the StackState UI on the page StackPacks > Integrations > SolarWinds. For an overview of recent StackPack updates, check the StackPack versions shipped with each StackState release.
Integration details
REST API endpoints
The SolarWinds user configured in the StackState Agent V2 must have read access to the SolarWinds API (default for all user accounts). No additional authorization needs to be set for this account in the SolarWinds system.
Refer to the SolarWinds product documentation for details on how to Manage Orion Web Console user accounts in the Orion Platform (documentation.solarwinds.com).
Data retrieved
Events
The SolarWinds check does not retrieve any event data.
Metrics
The SolarWinds check does not retrieve any metrics data.
Topology
The SolarWinds server can contain different modules suitable for data retrieval by the StackState SolarWinds integration.
- Network Performance Monitor (NPM) module - provides information about nodes, interfaces and layer-2 topology information for network devices. Layer-2 topology information for non-network devices is only available when the User Device Tracker (UDT) SolarWinds module is installed.
- User Device Tracker (UDT) module - provides layer-2 topology information for non-network devices in the form of MAC-address tables from routers, switches and firewalls. This is added to the data retrieved from NPM, resulting in a complete topology for all SolarWinds nodes.
The SolarWinds check retrieves the following topology data from SolarWinds:
Data
Description
Components
Nodes and interfaces. In some cases, a SolarWinds node will not show any interfaces in the SolarWinds system. If UDT detects that such a node is connected to a device, a 'ghost' interface will be created in StackState to show the full topology.
Relations
NPM: Layer-2 topology information from network devices. UDT: Layer-2 topology information connecting generic nodes to network devices
Health
The SolarWinds check retrieves the health status from nodes and interfaces and translates these statuses to StackState statuses:
SolarWinds Health status
StackState Health state
Up
CLEARExternal
CLEARUnmanaged
CLEARUnreachable
CLEARShutdown
CLEARWarning
DEVIATINGUnknown
DEVIATINGDown
CRITICALCritical
CRITICALThe configured
collection_interval will be used as the repeat_interval for the health synchronization. Make sure that the value set for the the collection_interval matches the time that the check will take to run.Traces
The SolarWinds check does not retrieve any trace data.
StackState views
When the SolarWinds integration is enabled, the following SolarWinds specific views are available in StackState:
- Node Details
- Interface Details
Component actions
To support component actions from StackState, the SolarWinds server needs to be accessible from the user's browser.
Links to SolarWinds detail dashboards are created as component actions attached to SolarWinds components. This allows users to easily access more information from SolarWinds when needed.
Open source
The code for the StackState SolarWinds StackPack and check are open source and available on GitHub:
Troubleshooting
Uninstall
To uninstall the SolarWinds StackPack and disable the Dynatrace check:
- 1.Go to the StackState UI StackPacks > Integrations > SolarWinds screen and click UNINSTALL.
- All SolarWinds specific configuration will be removed from StackState.
- 2.Remove or rename the Agent integration configuration file, for example:1mv solarwinds.d/conf.yaml solarwinds.d/conf.yaml.bakCopied!
- 3.
Release notes
See also
Last modified 9d ago