Difference between revisions of "Splunk On-Call Integration"

From OSNEXUS Online Documentation Site
Jump to: navigation, search
(Created page with "Category:integration_guide Splunk On-Call (aka victorops) is a cloud based ITSM (IT Service Management) system for IT organizations to manage their support process and ti...")
 
m (Step 6 - Apply Changes and Test)
 
(3 intermediate revisions by the same user not shown)
Line 17: Line 17:
 
</pre>
 
</pre>
  
 +
== Step 3 - Create a Routing Key ==
  
 +
Navigate to the '''Settings -> Routing Keys''' section within your Splunk On-Call account then click the '''Add Key''' button to generate a new routing key.  You can name your routing key anything you like such as '''1234123412341234''' or '''QUANTASTORGRID'''
  
 +
[[File:splunkoncall_routing.png|800px]]
  
== Step 2 - Add the Service Desk Endpoint to QuantaStor ==
+
== Step 4 - Assemble Webhook URL ==
  
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.
+
QuantaStor needs the API Key from step two combined with a routing key from Step 4, when combined your webhook URL should look something like this where '''QUANTASTORGRID''' is your Routing Key in this example:
  
All Solarwinds Service Desk endpoints must start with this HTTPS URL as the prefix:
 
 
<pre>
 
<pre>
https://api.samanage.com/incidents/
+
https://alert.victorops.com/integrations/generic/20131114/alert/e884cbc2-1481-4e7c-b38a-c4f03946d913/QUANTASTORGRID
 
</pre>
 
</pre>
  
Continuing the example above the full URL endpoint to put into QuantaStor will look like this with the JSON Web Token appended:
+
== Step 5 - Add Webhook URL 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 "splunkoncall" from the dropdown list of ITSM integrations and then input the URL endpoint you assembled per the instructions on Step 4.
  
<pre>
 
https://api.samanage.com/incidents/c3RldmVuLnVtYmVob2NrZXJAb3NuXh1cy5jb20=:eyJhbGciOiJIUzxMiJ9.eyJ1c2VyX2lkIjo4MDYyDY1LCJnZ5lcmF0ZWRfYXQiOiIyMDIyLTAzLTE1IDAyOjAyOjQ5In0.wmOgU313QOYteRkoRP3C7MBesPZhvKibktILXEiPBCBKM7sQ5VdeMR1wBcOtuGtJNyFSXrrIZaVxQxDn09yk1Q
 
</pre>
 
  
== Step 3 - Apply Changes and Test ==
+
== Step 6 - 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 Incidents are making it to Splunk On-Call.  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'''
+
To view your test alerts in Splunk On-Call login to your account and navigate to the '''Incidents''' section.

Latest revision as of 19:52, 15 March 2022


Splunk On-Call (aka victorops) is a cloud based ITSM (IT Service Management) system for IT organizations to manage their support process and ticketing. Quantastor integrates via a webhook API URL which must be added to the QuantaStor Alert Manager screen as a new Alert Endpoint.

Step 1 - Add REST Generic Integration

Login to your Splunk On-Call account then navigate to the Integrations section.

Select the "REST Generic" integration which is listed in the Featured integrations section.

Step 2 - Copy the API Key

The Generic REST API provides a URL that looks like this which you will use later to add into your QuantaStor system as an Alert Webhook. The URL looks like this but the part that says $routing_key must be replace with your Routing Key.

https://alert.victorops.com/integrations/generic/20131114/alert/e884cbc2-1481-4e7c-b38a-c4f03946d913/$routing_key

Step 3 - Create a Routing Key

Navigate to the Settings -> Routing Keys section within your Splunk On-Call account then click the Add Key button to generate a new routing key. You can name your routing key anything you like such as 1234123412341234 or QUANTASTORGRID

Splunkoncall routing.png

Step 4 - Assemble Webhook URL

QuantaStor needs the API Key from step two combined with a routing key from Step 4, when combined your webhook URL should look something like this where QUANTASTORGRID is your Routing Key in this example:

https://alert.victorops.com/integrations/generic/20131114/alert/e884cbc2-1481-4e7c-b38a-c4f03946d913/QUANTASTORGRID

Step 5 - Add Webhook URL 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 "splunkoncall" from the dropdown list of ITSM integrations and then input the URL endpoint you assembled per the instructions on Step 4.


Step 6 - 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 Incidents are making it to Splunk On-Call. 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 Splunk On-Call login to your account and navigate to the Incidents section.