--- title: Solarwinds Orion slug: connectors/solarwinds-orion docTags: createdAt: 2026-06-09T16:30:24.277Z --- This readme file provides information and instructions on how to use the SolarWinds Connector, which allows you to retrieve information from SolarWinds using SWQL queries. The SolarWinds Connector allows you to retrieve data from SolarWinds using SWQL queries. With this connector, you can easily get SolarWinds data into your Turbine Instance. ## Requirements To use the SolarWinds Connector Integration, you will need: - Access to a SolarWinds instance - Knowledge of SWQL queries. For more information, see the official SolarWinds documentation. - A API Token for the SolarWinds instance ## Capabilities The SolarWinds connector provides the following capabilities: - Get Query (SWQL) - Retrieve Alert List - Retrieve Event List ## Notes - [Solarwinds Documentation](https://documentation.solarwinds.com/en/success_center/sam/content/sam-api-poller-methods.htm) # Configurations ## HTTP Bearer Authentication Authenticates using bearer token ### Configuration Parameters | **Parameter** | **Description** | **Type** | **Required** | | ------------- | --------------------------------------------------------------------------------- | -------- | ------------ | | url | A URL to the target host. IE "[https://localhost:17778](https://localhost:17778)" | string | Required | | token | The API token. | string | Required | | verify\_ssl | Verify SSL certificate | boolean | Optional | | http\_proxy | A proxy to route requests through. | string | Optional | # Actions ## Get Query (SWQL) Use SolarWinds Query Language (SWQL) To Query Your SolarWinds Orion Platform For Specific Information. ### Endpoint - **URL:** `/SolarWinds/InformationService/v3/Json/Query` - **Method:** `GET` ### Input | **Argument Name** | **Type** | **Required** | **Description** | | ------------------------ | -------- | ------------ | ------------------------------------------ | | `parameters.query` | string | Optional | Parameters for the Get Query (SWQL) action | | `headers` | object | Optional | HTTP headers for the request | | `headers.User-Agent` | string | Optional | HTTP headers for the request | | `headers.Host` | string | Optional | HTTP headers for the request | | `headers.Accept` | string | Optional | HTTP headers for the request | | `headers.Content-Type` | string | Optional | HTTP headers for the request | | `headers.Content-Length` | string | Optional | HTTP headers for the request | ### Input Example `{"parameters":{"query":"SELECT Uri FROM Orion.Pollers ORDER BY PollerID WITH ROWS 1 TO 3 WITH TOTALROWS"},"headers":{"User-Agent":"curl/7.20.0 (i386-pc-win32) libcurl/7.20.0 OpenSSL/0.9.8l zlib/1.2.3","Host":"localhost:17778","Accept":"*/*","Content-Type":"application/json","Content-Length":"130"}}` ### Output | **Parameter** | **Type** | **Description** | | ---------------------- | -------- | -------------------------------- | | `status_code` | number | HTTP status code of the response | | `reason` | string | Response reason phrase | | `headers` | object | HTTP headers for the request | | `response` | object | Output field: response | | `response.totalRows` | number | Output field: response.totalRows | | `response.results` | array | Result of the operation | | `response.results.Uri` | string | Result of the operation | ### Output Example `{"status_code":200,"reason":"Ok","headers":null,"response":{"totalRows":13,"results":[{},{},{}]}}` ## Retrieve Alert List Retrieves a list of alerts based on the filter values provided in the command arguments. ### Endpoint - **URL:** `/SolarWinds/InformationService/v3/Json/Query` - **Method:** `GET` ### Input | **Argument Name** | **Type** | **Required** | **Description** | | ----------------- | -------- | ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `alert_id` | array | Optional | A comma-separated list of alert IDs. | | `type` | array | Optional | A comma-separated list of the type of property to monitor. For example- Node, IPAM.IPRequests, Orion.DiscoveryLogs, APM- Component, IPAM Networks, Orion.NodesForecastCapacity, APM- Application, Orion.VolumesForecastCapacity, Orion.NodesForecastCapacity, etc. | | `severity` | array | Optional | A comma-separated list of severity levels. Possible values are Information, Warning, Critical, Serious, and Notice. | | `sort_key` | string | Optional | Key by which the response will be sorted. For example- AlertID, AlertActiveID, AlertObjectID, TriggeredDateTime, TriggeredMessage, AcknowledgedDateTime, EngineID, Name, ObjectType, etc. Default is AlertActiveID. | | `sort_order` | string | Optional | Order by which the response will be sorted. Possible values are ascending and descending. Default is ascending. | | `page` | number | Optional | The page number from which to retrieve alerts. By default, the per-page limit is 50 alerts. You can change change this value in the limit argument. Default is 0. | | `limit` | number | Optional | The number of records to be retrieved. Default is 50. | ### Input Example `{"alert_id":[1,2,3],"type":["IPAM.IPRequests"],"severity":["Information"],"sort_key":"AlertID","sort_order":"ascending","page":0,"limit":50}` ### Output | **Parameter** | **Type** | **Description** | | ------------------------------------------- | -------- | ------------------------------------------------------- | | `status_code` | number | HTTP status code of the response | | `reason` | string | Response reason phrase | | `SolarWinds` | object | Output field: SolarWinds | | `SolarWinds.Alert` | array | Output field: SolarWinds.Alert | | `SolarWinds.Alert.AlertActiveID` | number | Unique identifier | | `SolarWinds.Alert.AlertID` | number | Unique identifier | | `SolarWinds.Alert.AlertMessage` | string | Response message | | `SolarWinds.Alert.AlertObjectID` | number | Unique identifier | | `SolarWinds.Alert.AlertRefID` | string | Unique identifier | | `SolarWinds.Alert.Canned` | boolean | Output field: SolarWinds.Alert.Canned | | `SolarWinds.Alert.ConfigurationDescription` | string | Output field: SolarWinds.Alert.ConfigurationDescription | | `SolarWinds.Alert.Context` | string | Output field: SolarWinds.Alert.Context | | `SolarWinds.Alert.Enabled` | boolean | Output field: SolarWinds.Alert.Enabled | | `SolarWinds.Alert.EntityCaption` | string | Output field: SolarWinds.Alert.EntityCaption | | `SolarWinds.Alert.EntityNetObjectId` | string | Unique identifier | | `SolarWinds.Alert.EntityType` | string | Type of the resource | | `SolarWinds.Alert.EntityUri` | string | Output field: SolarWinds.Alert.EntityUri | | `SolarWinds.Alert.Frequency` | number | Output field: SolarWinds.Alert.Frequency | | `SolarWinds.Alert.InstanceSiteId` | number | Unique identifier | | `SolarWinds.Alert.InstanceType` | string | Type of the resource | | `SolarWinds.Alert.LastEdit` | string | Output field: SolarWinds.Alert.LastEdit | | `SolarWinds.Alert.LastTriggeredDateTime` | string | Time value | | `SolarWinds.Alert.Name` | string | Name of the resource | | `SolarWinds.Alert.NotifyEnabled` | boolean | Output field: SolarWinds.Alert.NotifyEnabled | | `SolarWinds.Alert.ObjectType` | string | Type of the resource | ### Output Example `{"status_code":200,"response_headers":{"content-length":"140","content-type":"application/json","Date":"Tue, 19 Dec 2023 20:37:23 GMT"},"reason":"OK","json_body":{"SolarWinds":{"Alert":[]}}}` ## Retrieve Event List Retrieves a list of events on the filter values provided in the command arguments. ### Endpoint - **URL:** `/SolarWinds/InformationService/v3/Json/Query` - **Method:** `GET` ### Input | **Argument Name** | **Type** | **Required** | **Description** | | ----------------- | -------- | ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------- | | `acknowledged` | boolean | Optional | Whether to retrieve events that are acknowledged. If true, then retrieves all acknowledged events. Possible values are true and false. | | `event_id` | array | Optional | A comma-separated ist of event IDs. | | `event_type` | array | Optional | A comma-separated list of event types. For example Warning, Informational, Node Up, etc. | | `node` | array | Optional | To retrieve events of specific nodes. | | `sort_key` | string | Optional | Key by which the response will be sorted. For example EventID, EventTime, Message, TimeStamp, EventTypeName, Node, etc. Default is EventID. | | `sort_order` | string | Optional | Order by which the response will be sorted. Possible values are ascending and descending. Default is ascending. | | `page` | number | Optional | The page number from which retrieve events. By default, the per-page limit is 50 events. You can change this value in the limit argument. Default is 0. | | `limit` | number | Optional | The maximum number of records to be retrieved. Default is 50. | ### Input Example `{"acknowledged":true,"event_id":[1],"event_type":["Warning"],"node":["WIN-MV956AU5BSN"],"sort_key":"EventID","sort_order":"ascending","page":0,"limit":50}` ### Output | **Parameter** | **Type** | **Description** | | --------------------------------- | -------- | ------------------------------------------- | | `status_code` | number | HTTP status code of the response | | `reason` | string | Response reason phrase | | `SolarWinds` | object | Output field: SolarWinds | | `SolarWinds.Event` | array | Output field: SolarWinds.Event | | `SolarWinds.Event.Acknowledged` | boolean | Output field: SolarWinds.Event.Acknowledged | | `SolarWinds.Event.EngineID` | number | Unique identifier | | `SolarWinds.Event.EventID` | number | Unique identifier | | `SolarWinds.Event.EventTime` | string | Time value | | `SolarWinds.Event.EventType` | number | Type of the resource | | `SolarWinds.Event.EventTypeName` | string | Name of the resource | | `SolarWinds.Event.InstanceSiteId` | number | Unique identifier | | `SolarWinds.Event.InstanceType` | string | Type of the resource | | `SolarWinds.Event.Message` | string | Response message | | `SolarWinds.Event.NetObjectID` | number | Unique identifier | | `SolarWinds.Event.NetObjectType` | string | Type of the resource | | `SolarWinds.Event.NetworkNode` | number | Output field: SolarWinds.Event.NetworkNode | | `SolarWinds.Event.Node` | string | Output field: SolarWinds.Event.Node | | `SolarWinds.Event.TimeStamp` | array | Output field: SolarWinds.Event.TimeStamp | | `SolarWinds.Event.Uri` | string | Output field: SolarWinds.Event.Uri | ### Output Example `{"status_code":200,"response_headers":{"content-length":"140","content-type":"application/json","Date":"Tue, 19 Dec 2023 20:37:23 GMT"},"reason":"OK","json_body":{"SolarWinds":{"Event":[]}}}` # Response Headers | **Header** | **Description** | **Example** | | -------------- | ----------------------------------------------------- | ----------------------------- | | content-length | The length of the response body in bytes | 140 | | content-type | The media type of the resource | application/json | | Date | The date and time at which the message was originated | Tue, 19 Dec 2023 20:37:23 GMT |