Alerts - OpsGenie

Objective

This document provides instructions on how to configure alert notifications in VoltConsole to route the alert messages to your OpsGenie service. For information on Volterra alerts, see Alerts.


Prerequisites


Configuration

Configuring to send alerts to the OpsGenie service requires you to first generate webhook for your OpsGenie service. After that, create alert receiver, policy, and policy set in the VoltConsole.

Create Webhook for OpsGenie Service

OpsGenie supports webhooks by providing integration via API. This example shows instructions on generating the webhook configuration for a OpsGenie service.

Step 1:Generate webhook configuration in OpsGenie.

Log into your enterprise OpsGenie portal and click on Settings. Navigate to Integrations -> Integrations list the left menu and create an integration.

Note: You can also use an existing created integration or the Default API integration.

Step 2: Navigate to the configured integrations and obtain the webhook configuration.

Note down the API key for your integration.

OpsGenieSrvc
Figure: OpsGenie Integration Configuration

Note: Ensure that you have create and update access enabled for your integration.


Create Alert Receiver

This example shows the alert notification for OpsGenie.

Step 1: Start generating alert receiver in VoltConsole.

Log into the VoltConsole and change to your namespace. Select Manage from the configuration menu and Alert Config from the options pane. Select Alert Receiver from the options under the Alert Config and click Add alert receiver.

AlertRecNav
Figure: Alert Receiver Creation Form

Step 2: Set OpsGenie as the receiver.

Enter name and select OpsGenie for the Receiver field.

Step 3: Configure secret for OpsGenie service.

Configure the settings for the Secret field as per the following guidelines:

  • Select Blindfold Secret for the Secret info field.
  • Enter the string obtained from applying Blindfold to the webhook configuration. See Blindfold your Application Secrets for information on how to encrypt your application secrets.
  • Select Base64 for the Secret Encoding field. Use the echo -n "<API-key>" | base64 command.

ar basic
Figure: Alert Receiver Configuration

Note: You can also select other values for the Secret info field and set the subsequent values as per the following guidelines.

Secret Guidelines
Vault Secret Enter the values for the provider and location.
Clear Secret Enter the value for the URL in the string:///<string> format.
Bootstrap Secret Enter the name of the secret.

It is recommended to encode your secret using the Base64 encryption and set the secret encoding as Base64. However, in case of clear secret, select the encoding as EncodingNone.

Step 4: Specify API URL for OpsGenie service and complete creating receiver.

Enter https://api.opsgenie.com in the URL field. Click Continue to complete creating the alert receiver.

Note: Only the https://api.opsgenie.com API is supported.


Create Alert Policy

Step 1: Start creating alert policy.

Log into the VoltConsole and change to your namespace. Select Manage from the configuration menu and Alert Config from the options pane. Select Alert Policy from the options under the Alert Config and click Add alert policy.

Step 2: Add reciever to the policy.

Enter a name for the policy and click Select receiver to open the receiver selection form. Select the receiver you created in the Create Alert Receiver chapter and click Select receiver to add the receiver to the policy.

ap basic
Figure: Alert Policy Receiver Configuration

Step 3: Set notification intervals.

Enter the configuration for the Notification Parameters as per the following guidelines:

  • Enter a value in the [0-9][smhd] format for the Notify Interval for a Alert field. The [smhd] specifies seconds, minutes, hours, and days. An example value is 1h and default is 4h.
  • Enter a value in the [0-9][smhd] format for the Wait to Notify field. The [smhd] specifies seconds, minutes, hours, and days. An example value is 2m and default is 30s.
  • Enter a value in the [0-9][smhd] format for the Notify Interval for a Group field. The [smhd] specifies seconds, minutes, hours, and days. An example value is 5m and default is 1m.
Step 4: Set alert match conditions and associated actions.

Select options for the Select Alerts Match Condition and the Action fields. This example configures the match for any condition using the Any value and send action using the Send value.

ap routes
Figure: Alert Policy Route Configuration

Note: You can also set the match conditions based on the severity, group name, and alert name.

Step 5: Optionally, add policy rules.

Click Add route to add more policy rules.

Step 6: Complete creating the alert policy.

Click Continue to complete creating the alert policy.


Create Alert Policy Set

Step 1: Start creating the alert policy set.

Log into the VoltConsole and change to your namespace. Select Manage from the configuration menu and Alert Config from the options pane. Select Alert Policy Set from the options under the Alert Config and click Add alert policy set.

Step 2: Add the alert policy to the policy set.

Add a name and click Select policy to open the policy selection form. Select the created alert policy and click Select policy again to add the policies to the policy set.

aps basic
Figure: Alert Policy Set Configuration

Step 3: Complete creating the policy set.

Click Continue to complete creating the alert policy set.


Verification and Example

You can now verify the alert notifications by visiting your OpsGenie service page. The following image shows a sample of alerts sent to OpsGenie service:

og alerts
Figure: Post of Alerts to OpsGenie Service


Concepts