Managing deprecated SolarWinds NPM integrations


SolarWinds NPMenables you to detect, diagnose, and resolve network performance issues.

As a tenant administrator, you use edit a deprecated SolarWinds NPM integration. However, you cannot configure new instances of the integration. We recommend that you use BMC Helix Intelligent Integrations to configure new instances. For more information, see Integrating-with-SolarWinds-NPM

Tip: View separate events and alerts in BMC Helix Operations Management

Although SolarWinds NPM separates alerts and events, you can see them all as events in BMC Helix Operations Management . To see the difference, view the event details. If the event was an alert in  SolarWinds NPM , the event class appears as SolarWindsAlert. If the event was an event in SolarWinds NPM , the event class appears as  SolarWindsEvent.

As a tenant administrator, perform the following steps to edit and validate the integrations configured with 

SolarWinds NPM

Before you begin

Ensure that the SolarWinds NPM host is accessible from your docker-enabled Linux server.

To edit a SolarWinds NPM integration

  1. From BMC Helix Developer Tools , open the  Configured Integrations  tab   if the tab does not open by default.
    This tab shows deprecated SolarWinds NPM integrations and all other configured integrations. The following example shows the tile for a deprecated SolarWinds NPM integration: 
    deprecated_SW_integration.png

    The tile shows the following information:

    • The name of the integration with its build number.
    • The incoming data. In this example, 5,046 CIs and 36 events have been received.
    • The name of the user who modified the integration along with the time of the modification. In this example, it is the admin user.
    • The connector status. In this example, the status is Active.
  2. On the deprecated SolarWinds NPM integration tile that you want to edit, select Edit from the actions menu configuremenu_icon.png.
  3. Optionally, edit the following source details:
    • Integration name
    • API URL

      How do I obtain the API URL?

      The API URL is the name of the host where you have installed SolarWinds NPM, appended by port 17778. Ensure that you use the https protocol in the API URL.
      https://< 

      SolarWinds NPM

      _host_name>:17778

      SolarWinds NPM uses the following default ports:

      • API URL: 17778
      • User interface URL: 8787
    • User name and password
      Provide the same credentials as provided during installation of SolarWinds NPM.
    • Entity types (Events and CIs) to import 
  4. In the Customize Entity Configuration section, click Configure and edit the following advanced settings for the entities that you have selected in the previous step.
    • EventsSpecify the refresh time for events in seconds. By default, the refresh time is set to 60 seconds.
    • CIsSpecify the refresh time for CIs in hours. By default, the refresh time is set to 24 hours.
  5. Click Update. 
    On the Configured Integrations  tab, the status of the integration changes to CONFIGURING. After the integration is configured completely, the status changes to CONNECTED .

To validate the SolarWinds NPM integration

  • Ensure that the status of the integration is Connected. The following statuses are also valid:
    • Configuring
    • Disabled
    • Disconnected
  • From BMC Helix Operations Management , go to Events to ensure that you can see the events in BMC Helix Operations Management .
  • For more information, see Event monitoring.

  • From BMC Helix Discovery, go to Explore > Data, and then click <count> Import Records in the Miscellaneous section to ensure that you can see the records from the source (host) in BMC Helix Discovery . Use these records further to create a business service model for the source depending on your use case requirements in BMC Helix AIOps. For more information, see Managing models.

SolarWinds NPM event classes

The following event classes are created in BMC Helix Operations Management to display the SolarWinds NPM data:

  • SolarWindsEvent
    • Parent class name: EVENT
    • Attributes

      Name

      Data type

      sourceEventID

      INTEGER

      sourceNodeID

      INTEGER

      type

      INTEGER

      typeName

      STRING

      instanceType

      STRING

      displayName

      STRING

  • SolarWindsAlert
    • Parent class name: EVENT
    • Attributes

      Name

      Data type

      alertActiveID

      INTEGER

      alertName

      STRING

      entityType

      STRING

      alertObjectID

      INTEGER

      displayName

      STRING

      instanceType

      STRING

      sourceNodeID

      INTEGER

SolarWinds NPM event slot mappings

The following table lists the event slot mappings between SolarWinds NPM  and BMC Helix Operations Management .

Event slots in SolarWinds NPM

Corresponding event slots in BMC Helix Operations Management

SolarWindsEvent
class
LocalEventTime
creation_time
EventID
sourceEventID
EventType
type
EventTypeName
typeName
NetObjectID
sourceNodeID
Node,{{PARAMETERS.integration_id}},NetObjectID
_ci_id
SolarWinds,{{PARAMETERS.integration_id}},NetObjectID
source_identifier
{{PARAMETERS.integration_id}},EventID
_identifier
DNS
source_hostname
Message
msg
status
status

The following statuses are available:

  • Open
  • Assigned
  • Closed
  • Ack
IP
source_address
Description
details
DisplayName
displayName
InstanceType
instanceType
Icon
severity

The following severity levels are available:

  • Info
  • Critical
  • Major
  • Warning
  • Unknown
SolarWindsAlert
class
LocalEventTime
creation_time
AlertActiveID
alertActiveID
Alert,{{PARAMETERS.integration_id}},AlertActiveID
_identifier
NodeID
sourceNodeID
Node,{{PARAMETERS.integration_id}},NodeID
_ci_id
SolarWinds,{{PARAMETERS.integration_id}},NodeID
source_identifier
AlertMessage
msg
AlertObjectID
alertObjectID
AlertName
alertName
Description
details
EntityType
entityType
modified_time
_modified_time
AcknowledgedBy
user_assigned
severity
severity
AlertActiveID
eventIds

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*