StackState Self-hosted v4.5.x
This page describes StackState v4.5.x. The StackState 4.5 version range is End of Life (EOL) and no longer supported. We encourage customers still running the 4.5 version range to upgrade to a more recent release.
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.
- 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.
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.
- A SolarWinds user with access to the required API endpoints.
- 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 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.
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:
init_config:instances:- url: <instance_name.solarwinds.localdomain>username: <instance_username>password: <instance_password>solarwinds_domain: <instance_domain> # A SolarWinds custom propertysolarwinds_domain_values: # A list of values used by the solarwinds_domain- <instance_domain_value_1>- <instance_domain_value_2>- <instance_domain_value_n># min_collection_interval: 30 # use in place of collection_interval for Agent v2.14.x or earliercollection_interval: 30
- url - the REST API URL, uses HTTPS protocol for communication. This should be a hostname or IP, it should not include the prefix
- 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.
- 4.Once the Agent has restarted, wait for data to be collected from SolarWinds and sent to StackState.
To check the status of the SolarWinds integration, run the status subcommand and look for SolarWinds under
sudo stackstate-agent status
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.
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).
The SolarWinds check does not retrieve any event data.
The SolarWinds check does not retrieve any metrics data.
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:
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.
NPM: Layer-2 topology information from network devices. UDT: Layer-2 topology information connecting generic nodes to network devices
The SolarWinds check retrieves the health status from nodes and interfaces and translates these statuses to StackState statuses:
SolarWinds Health status
StackState Health state
collection_intervalwill be used as the
repeat_intervalfor the health synchronization. Make sure that the value set for the the
collection_intervalmatches the time that the check will take to run.
The SolarWinds check does not retrieve any trace data.
When the SolarWinds integration is enabled, the following SolarWinds specific views are available in StackState:
- Node Details
- Interface Details
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.
The code for the StackState SolarWinds StackPack and check are open source and available on GitHub:
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:mv solarwinds.d/conf.yaml solarwinds.d/conf.yaml.bak