Difference between revisions of "PagerDuty Integration"

From OSNEXUS Online Documentation Site
Jump to: navigation, search
m (Adding PagerDuty to Quantastor)
m (Adding PagerDuty to Quantastor)
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.

Revision as of 17:47, 5 February 2020


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

PagerDutySetup1.png

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.

PagerDutySetup2.png

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".

PagerDutySetup3.png

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

Alert Manager Web.jpg

Open the web interface for the Quantastor system. Right click on the storage system or grid, and select "Alert Manager".

Alert Manager - Cloud Alerts.jpg

In the text box titled "PagerDuty.com Service Key" paste the service key from before. Then click on "Apply".

Alert Manager - Send User Generated Alert.jpg

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.

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


Pagerduty5.png

Pagerduty4.png