Difference between revisions of "Solarwinds Service Desk"

From OSNEXUS Online Documentation Site
Jump to: navigation, search
(Created page with "Category:integration_guide Solarwinds Service Desk is a cloud based ITSM (IT Service Management) system for IT organizations to manage their support process and ticketing...")
 
m
 
(4 intermediate revisions by the same user not shown)
Line 1: Line 1:
 
[[Category:integration_guide]]
 
[[Category:integration_guide]]
  
Solarwinds Service Desk is a cloud based ITSM (IT Service Management) system for IT organizations to manage their support process and ticketing.  Quantastor integrates via forward a copy of all alerts that are severity "Error", "Warning", or "Critical".  Integration with PagerDuty is done via a webhook URL which must be added to the QuantaStor Alert Manager screen as a new Alert Endpoint.   
+
Solarwinds Service Desk is a cloud based ITSM (IT Service Management) system for IT organizations to manage their support process and ticketing.  Quantastor integrates via forward a copy of all alerts that are severity "Error", "Warning", or "Critical".  Integration is done via a webhook URL which must be added to the QuantaStor Alert Manager screen as a new Alert Endpoint.   
  
== Step 1 - Add a Service to PagerDuty ==  
+
== Step 1 - Generate a JSON Web Token ==  
  
After logging into your PagerDuty account navigate to *Services* -> *Service Directory* then choose the "+ New Service" to add a new service endpoint.
+
Login to your Solarwinds Service Desk account then navigate to:
  
Enter a name for the service such as "QuantaStor Alerts" or something more specific to the storage grid you'll have alerts originating from "qs-grid-1 alerts".
+
'''Setup''' -> '''Users & Groups''' -> '''Users'''
  
== Step 2 - Add an Integration ==
+
Next select a user from the list then under "Actions" choose the option to generate a JSON Web Token.  The token will look something like this and will be needed in order for QuantaStor to create '''Incidents''' within your Service Desk account.
 
+
QuantaStor integrates with PagerDuty via the "Events API V2" so you'll need to add that integration to the service.
+
 
+
== Step 3 - Get the Integration Key ==
+
 
+
After adding the integration click on the gear icon so that you can view the "Integration Key" which is also known as the "Routing Key" or "Routing Token"It will look something like this:
+
  
 
<pre>
 
<pre>
923c2db8f5384103c09fdf1a9f506162
+
c3RldmVuLnVtYmVob2NrZXJAb3NuXh1cy5jb20=:eyJhbGciOiJIUzxMiJ9.eyJ1c2VyX2lkIjo4MDYyDY1LCJnZ5lcmF0ZWRfYXQiOiIyMDIyLTAzLTE1IDAyOjAyOjQ5In0.wmOgU313QOYteRkoRP3C7MBesPZhvKibktILXEiPBCBKM7sQ5VdeMR1wBcOtuGtJNyFSXrrIZaVxQxDn09yk1Q
 
</pre>
 
</pre>
  
== Step 4 - Add the Endpoint to QuantaStor ==
+
== Step 2 - Add the Service Desk Endpoint to QuantaStor ==
  
Login to your QuantaStor storage grid and then select the "Alert Manager" button to bring up the dialog for adding more alert endpoints.  On the second page select "PagerDuty" from the dropdown list of ITSM integrations and then input the URL endpoint.
+
Login to your QuantaStor storage grid and then select the "Alert Manager" button to bring up the dialog for adding more alert endpoints.  On the second page select "solarwinds" from the dropdown list of ITSM integrations and then input the URL endpoint.
  
All PagerDuty endpoints must start with this HTTPS URL as the prefix:
+
All Solarwinds Service Desk endpoints must start with this HTTPS URL as the prefix:
 
<pre>
 
<pre>
https://events.pagerduty.com/v2/enqueue/
+
https://api.samanage.com/incidents/
 
</pre>
 
</pre>
  
Continuing the example above the full URL endpoint to put into QuantaStor will look like this with the Integration Key at the end:
+
Continuing the example above the full URL endpoint to put into QuantaStor will look like this with the JSON Web Token appended:
  
 
<pre>
 
<pre>
https://events.pagerduty.com/v2/enqueue/923c2db8f5384103c09fdf1a9f506162
+
https://api.samanage.com/incidents/c3RldmVuLnVtYmVob2NrZXJAb3NuXh1cy5jb20=:eyJhbGciOiJIUzxMiJ9.eyJ1c2VyX2lkIjo4MDYyDY1LCJnZ5lcmF0ZWRfYXQiOiIyMDIyLTAzLTE1IDAyOjAyOjQ5In0.wmOgU313QOYteRkoRP3C7MBesPZhvKibktILXEiPBCBKM7sQ5VdeMR1wBcOtuGtJNyFSXrrIZaVxQxDn09yk1Q
 
</pre>
 
</pre>
  
== Step 5 - Apply Changes and Test ==
+
== Step 3 - Apply Changes and Test ==
 +
 
 +
Apply your changes then use the "Generate Test Alert" button to generate a test alert to verify everything is configured correctly and alerts are making it to Service Desk.  Note that "INFO" level alerts are not sent to the ITSM modules so be sure to generate a "WARNING" or "ERROR" level alert for testing.
  
Apply your changes then use the "Generate Test Alert" button to generate a test alert to verify everything is configured correctly and alerts are making it to PagerDuty.  Note that "INFO" level alerts are not sent to the ITSM modules so be sure to generate a "WARNING" or "ERROR" level alert for testing.
+
To view your test alerts in Service Desk login to your account and navigate to '''Service Desk''' -> '''Incidents'''

Latest revision as of 18:33, 15 March 2022


Solarwinds Service Desk is a cloud based ITSM (IT Service Management) system for IT organizations to manage their support process and ticketing. Quantastor integrates via forward a copy of all alerts that are severity "Error", "Warning", or "Critical". Integration is done via a webhook URL which must be added to the QuantaStor Alert Manager screen as a new Alert Endpoint.

Step 1 - Generate a JSON Web Token

Login to your Solarwinds Service Desk account then navigate to:

Setup -> Users & Groups -> Users

Next select a user from the list then under "Actions" choose the option to generate a JSON Web Token. The token will look something like this and will be needed in order for QuantaStor to create Incidents within your Service Desk account.

c3RldmVuLnVtYmVob2NrZXJAb3NuXh1cy5jb20=:eyJhbGciOiJIUzxMiJ9.eyJ1c2VyX2lkIjo4MDYyDY1LCJnZ5lcmF0ZWRfYXQiOiIyMDIyLTAzLTE1IDAyOjAyOjQ5In0.wmOgU313QOYteRkoRP3C7MBesPZhvKibktILXEiPBCBKM7sQ5VdeMR1wBcOtuGtJNyFSXrrIZaVxQxDn09yk1Q

Step 2 - Add the Service Desk Endpoint to QuantaStor

Login to your QuantaStor storage grid and then select the "Alert Manager" button to bring up the dialog for adding more alert endpoints. On the second page select "solarwinds" from the dropdown list of ITSM integrations and then input the URL endpoint.

All Solarwinds Service Desk endpoints must start with this HTTPS URL as the prefix:

https://api.samanage.com/incidents/

Continuing the example above the full URL endpoint to put into QuantaStor will look like this with the JSON Web Token appended:

https://api.samanage.com/incidents/c3RldmVuLnVtYmVob2NrZXJAb3NuXh1cy5jb20=:eyJhbGciOiJIUzxMiJ9.eyJ1c2VyX2lkIjo4MDYyDY1LCJnZ5lcmF0ZWRfYXQiOiIyMDIyLTAzLTE1IDAyOjAyOjQ5In0.wmOgU313QOYteRkoRP3C7MBesPZhvKibktILXEiPBCBKM7sQ5VdeMR1wBcOtuGtJNyFSXrrIZaVxQxDn09yk1Q

Step 3 - Apply Changes and Test

Apply your changes then use the "Generate Test Alert" button to generate a test alert to verify everything is configured correctly and alerts are making it to Service Desk. Note that "INFO" level alerts are not sent to the ITSM modules so be sure to generate a "WARNING" or "ERROR" level alert for testing.

To view your test alerts in Service Desk login to your account and navigate to Service Desk -> Incidents