PagerDuty Integration - Revision history

Qadmin: /* Step 1 - Add a Service */

2022-03-16T00:30:06Z

Step 1 - Add a Service

← Older revision		Revision as of 00:30, 16 March 2022
Line 3:		Line 3:
	PagerDuty is an ITSM (IT Service Management) for IT organizations to manage their support process and ticketing. Quantastor integrates with PagerDuty to 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.		PagerDuty is an ITSM (IT Service Management) for IT organizations to manage their support process and ticketing. Quantastor integrates with PagerDuty to 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.

	== Step 1 - Add a Service ==		== Step 1 - Add a Service to PagerDuty ==

	After logging into your PagerDuty account navigate to Services -> Service Directory then choose the "+ New Service" to add a new service endpoint.		After logging into your PagerDuty account navigate to Services -> Service Directory then choose the "+ New Service" to add a new service endpoint.

Qadmin at 18:58, 15 March 2022

2022-03-15T18:58:23Z

← Older revision		Revision as of 18:58, 15 March 2022
Line 20:		Line 20:
	923c2db8f5384103c09fdf1a9f506162		923c2db8f5384103c09fdf1a9f506162
	</pre>		</pre>

			== Step 4 - Add the 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.

			All PagerDuty endpoints must start with this HTTPS URL as the prefix:
			<pre>
			https://events.pagerduty.com/v2/enqueue/
			</pre>

			Continuing the example above the full URL endpoint to put into QuantaStor will look like this with the Integration Key at the end:

			<pre>
			https://events.pagerduty.com/v2/enqueue/923c2db8f5384103c09fdf1a9f506162
			</pre>

			== Step 5 - 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 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.

Qadmin at 18:49, 15 March 2022

2022-03-15T18:49:31Z

@@ Line 1: / Line 1: @@
 [[Category:integration_guide]]
-PagerDuty is an alarm aggregation and dispatching service for system administrators and support teams. It collects alerts from your monitoring tools, gives you an overall view of all of your monitoring alarms, and alerts an on duty engineer if there's a problem.
+PagerDuty is an ITSM (IT Service Management) for IT organizations to manage their support process and ticketing.  Quantastor integrates with PagerDuty to 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.
-Quantastor can be setup to trigger PagerDuty alerts when Quantastor encounters an alert that is of severity "Error", "Warning", or "Critical". Getting setup only requires a few simple steps (internet connection required).
+== Step 1 - Add a Service ==
-=== Adding a New Service in PagerDuty ===
+After logging into your PagerDuty account navigate to *Services* -> *Service Directory* then choose the "+ New Service" to add a new service endpoint.
-{|
+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".
-This service is what all of the Quantastor alerts will be kept under. This will keep the alerts separate from the other programs that may be sending their alerts to PagerDuty.
+== Step 2 - Add an Integration ==
-=== Adding PagerDuty to Quantastor ===
+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 ==
-=== Example Alerts ===
+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:
-When Quantastor sends an alert to PagerDuty it also sends a list of details to make solving the issue easier. These details include:
+<pre>
-* The serial number of the system
+c2db8f5384103c09fdf1a9f506162
-* The startup time of the system
+</pre>

Qadmin: /* Adding PagerDuty to Quantastor */

2020-02-06T00:47:22Z

Adding PagerDuty to Quantastor

← Older revision		Revision as of 00:47, 6 February 2020
Line 38:		Line 38:
	\|-		\|-
	\|		\|
	[[File:Alert Manager - Cloud Alerts.jpg]]		[[File:Alert Manager - Cloud Alerts.jpg\|400px]]
	\|		\|
	In the text box titled "PagerDuty.com Service Key" paste the service key from before. Then click on "Apply".		In the text box titled "PagerDuty.com Service Key" paste the service key from before. Then click on "Apply".
	\|-		\|-
	\|		\|
	[[File:Alert Manager - Send User Generated Alert.jpg]]		[[File:Alert Manager - Send User Generated Alert.jpg\|400px]]
	\|-		\|-
	\|		\|
	[[File:Alert Manager - Alert Types.jpg]]		[[File:Alert Manager - Alert Types.jpg\|400px]]
	\|		\|
	To test if the system is working select generate test alert. Make sure to select a severity level of "Error", "Warning", or "Critical" and then click okay. If everything is setup correctly a test alert should now be generated and sent to PagerDuty.		To test if the system is working select generate test alert. Make sure to select a severity level of "Error", "Warning", or "Critical" and then click okay. If everything is setup correctly a test alert should now be generated and sent to PagerDuty.

Qadmin: /* Adding PagerDuty to Quantastor */

2020-02-06T00:45:38Z

Adding PagerDuty to Quantastor

← Older revision		Revision as of 00:45, 6 February 2020
Line 33:		Line 33:
	\|-		\|-
	\|		\|
	[[File:Alert Manager Web.jpg\|~~800px~~]]		[[File:Alert Manager Web.jpg\|400px]]
	\|		\|
	Open the web interface for the Quantastor system. Right click on the storage system or grid, and select "Alert Manager".		Open the web interface for the Quantastor system. Right click on the storage system or grid, and select "Alert Manager".
	\|-		\|-
	\|		\|
	[[File:~~pagerduty2~~.~~png\|400px~~]]		[[File:Alert Manager - Cloud Alerts.jpg]]
	\|		\|
	In the text box titled "PagerDuty.com Service Key" paste the service key from before. Then click on "Apply".		In the text box titled "PagerDuty.com Service Key" paste the service key from before. Then click on "Apply".
	\|-		\|-
	\|		\|
	[[File:~~pagerduty1~~.~~png~~\|~~400px~~]]		[[File:Alert Manager - Send User Generated Alert.jpg]]
			\|-
			\|
			[[File:Alert Manager - Alert Types.jpg]]
	\|		\|
	To test if the system is working select generate test alert. Make sure to select a severity level of "Error", "Warning", or "Critical" and then click okay. If everything is setup correctly a test alert should now be generated and sent to PagerDuty.		To test if the system is working select generate test alert. Make sure to select a severity level of "Error", "Warning", or "Critical" and then click okay. If everything is setup correctly a test alert should now be generated and sent to PagerDuty.

Qadmin: /* Adding PagerDuty to Quantastor */

2020-02-06T00:28:09Z

Adding PagerDuty to Quantastor

← Older revision		Revision as of 00:28, 6 February 2020
Line 33:		Line 33:
	\|-		\|-
	\|		\|
	[[File:Alert Manager Web.jpg]]		[[File:Alert Manager Web.jpg\|800px]]
	\|		\|
	Open the web interface for the Quantastor system. Right click on the storage system or grid, and select "Alert Manager".		Open the web interface for the Quantastor system. Right click on the storage system or grid, and select "Alert Manager".

Qadmin: /* Adding PagerDuty to Quantastor */

2020-02-06T00:27:28Z

Adding PagerDuty to Quantastor

← Older revision		Revision as of 00:27, 6 February 2020
Line 33:		Line 33:
	\|-		\|-
	\|		\|
	[[File:~~pagerduty3~~.~~png\|400px~~]]		[[File:Alert Manager Web.jpg]]
	\|		\|
	Open the web interface for the Quantastor system. Right click on the storage system or grid, and select "Alert Manager".		Open the web interface for the Quantastor system. Right click on the storage system or grid, and select "Alert Manager".
Line 47:		Line 47:
	To test if the system is working select generate test alert. Make sure to select a severity level of "Error", "Warning", or "Critical" and then click okay. If everything is setup correctly a test alert should now be generated and sent to PagerDuty.		To test if the system is working select generate test alert. Make sure to select a severity level of "Error", "Warning", or "Critical" and then click okay. If everything is setup correctly a test alert should now be generated and sent to PagerDuty.
	\|}		\|}


	=== Example Alerts ===		=== Example Alerts ===

Qadmin at 18:12, 21 March 2019

2019-03-21T18:12:07Z

← Older revision		Revision as of 18:12, 21 March 2019
Line 1:		Line 1:
	~~== PagerDuty ==~~		[[Category:integration_guide]]

	PagerDuty is an alarm aggregation and dispatching service for system administrators and support teams. It collects alerts from your monitoring tools, gives you an overall view of all of your monitoring alarms, and alerts an on duty engineer if there's a problem.		PagerDuty is an alarm aggregation and dispatching service for system administrators and support teams. It collects alerts from your monitoring tools, gives you an overall view of all of your monitoring alarms, and alerts an on duty engineer if there's a problem.

Qadmin: Created page with "== PagerDuty == PagerDuty is an alarm aggregation and dispatching service for system administrators and support teams. It collects alerts from your monitoring tools, gives yo..."

2016-02-12T18:55:44Z

Created page with "== PagerDuty == PagerDuty is an alarm aggregation and dispatching service for system administrators and support teams. It collects alerts from your monitoring tools, gives yo..."

New page

== PagerDuty ==

PagerDuty is an alarm aggregation and dispatching service for system administrators and support teams. It collects alerts from your monitoring tools, gives you an overall view of all of your monitoring alarms, and alerts an on duty engineer if there's a problem.

Quantastor can be setup to trigger PagerDuty alerts when Quantastor encounters an alert that is of severity "Error", "Warning", or "Critical". Getting setup only requires a few simple steps (internet connection required).

=== Adding a New Service in PagerDuty ===

{|
|-
|
[[File:pagerDutySetup1.png|400px]]
|
After logging into your PagerDuty account click on the "Services" tab along the top.
From here click on the "Add New Service" button.

This service is what all of the Quantastor alerts will be kept under. This will keep the alerts separate from the other programs that may be sending their alerts to PagerDuty.
|-
|
[[File:pagerDutySetup2.png|400px]]
|
For the "Service Name" field I would recommend something that describes the box or grid that is being monitored. Also make sure to select "Generic API System" under service type. Quantastor uses PagerDuty's API to post the alert to PagerDuty. After everything is set click "Add Service".
|-
|
[[File:pagerDutySetup3.png|400px]]
|
Everything on the PagerDuty side should now be setup. Copy the "Service API Key" and set it aside. This key is the input parameter to tell Quantastor where to post the alert.
|}

=== Adding PagerDuty to Quantastor ===

{|
|-
|
[[File:pagerduty3.png|400px]]
|
Open the web interface for the Quantastor system. Right click on the storage system or grid, and select "Alert Manager".
|-
|
[[File:pagerduty2.png|400px]]
|
In the text box titled "PagerDuty.com Service Key" paste the service key from before. Then click on "Apply".
|-
|
[[File:pagerduty1.png|400px]]
|
To test if the system is working select generate test alert. Make sure to select a severity level of "Error", "Warning", or "Critical" and then click okay. If everything is setup correctly a test alert should now be generated and sent to PagerDuty.
|}

=== Example Alerts ===

When Quantastor sends an alert to PagerDuty it also sends a list of details to make solving the issue easier. These details include:
* The serial number of the system
* The startup time of the system
* The location
* The title of the alert
* The version of the Quantastor service
* The time at which the alert was sent
* The name of the system
* The id of the system
* The current firmware version
* The severity of the alert

{|
|-
|
[[File:pagerduty5.png|400px]]
|
[[File:pagerduty4.png|400px]]
|}