Skip to main content

Execute SWQL Query

The plugin is designed to execute Solarwinds SWQL queries

Prerequisites:
In addition to the general perquisites mentioned at SolarWinds plugin level, SWQL studio.

Configurations

General Tab

No.Field NameDescription
1Step NameName of the step.

This name has to be unique in a single workflow.

Connection:
2Server NameProvide the SolarWinds instance name, IP address, or hostname.
3PortThe port number of the SolarWinds instance should be provided.

Port number should only be an integer.

4UsernameThe username of the SolarWinds instance to authenticate.
Password:
5Checkbox: Accept Value as variable/staticLeave the checkbox unchecked to accept the Password value from a field in the previous steps of the stream using a drop-down list.

Else, enable the checkbox for the Password field to appear as a text box.

6PasswordThe password for the specified username to authenticate.

Password is encrypted and not stored in the .psw file.

Password is entered using a widget. The widget handles both Text Var (static value or environment variable) and Combo (drop-down containing values from previous steps). This field is mandatory.

If the checkbox above is enabled, the Password field appears as a text box. Else, if the checkbox above is disabled, the Password field appears as a drop-down to select fields from previous steps.

Button:
7Test ConnectionTest connection with the username and password provided.

Verifies whether the connection is available or not.

Note: Test Connection button does not work if the connection fields are populated from previous steps.

Input Tab

No.Field NameDescription
Input Field:
1SWQL QueryThe SWQL query based on which the required SolarWinds data will be retrieved.

This field is mandatory. The SWQL query should be valid.

Following are some sample queries on different objects:

  • SELECT TOP 1000 AlertActiveID, AlertObjectID, Acknowledged, AcknowledgedBy, AcknowledgedDateTime, AcknowledgedNote:, TriggeredDateTime, TriggeredMessage, NumberOfNote:s, LastExecutedEscalationLevel FROM Orion.AlertActive
  • SELECT AlertHistoryID, EventType, Message, TimeStamp, AccountID, AlertActiveID, AlertObjectID, ActionID FROM Orion.AlertHistory
  • SELECT NodeID, Caption, IPAddress, Status FROM Orion.Nodes ORDER BY Caption

Common Buttons

No.Field NameDescription
Buttons:
1OKOn click of this button, it will check the field values.

If any required field values are missing, it will display a validation error message.

If all required field values are provided, it will save the field values.

2CancelOn click of this button, it will cancel the window and will not save any values.