Opsgenie

Although a turnkey integration is available for email based notifications, organizations may wish to send notifications to other platforms in use internally.

This recipe documents how organizations can customize the "Alert Manager" system addon configuration and send the alerts to Opsgenie by Atlassian

Configure Opsgenie

If you would like to setup the alerting through Opsgenie, you will need an existing Opsgenie account or sign up for a trial here

To setup the alerting to your Opsgenie, you will need to create a new Prometheus Integration under the service team

• Login into Opsgenie > Teams and select the team name to create the integration

• Add a new integration for the selected team

• Search for "Prometheus" integration

• Add the "Prometheus" integration to the team

• Copy the "Prometheus" integration API Key to use in later steps

• Save the "Prometheus" integration settings for the selected team

Configure Alert Manager

Follow the steps described below to create a customized Alert Manager configuration for use with Ops Genie.

• Go to Infrastructure -> Addons

• Create a new addon with using "Customize System Addon" option.

• Create a new version for the custom system Alert Manager addon.

• Download the default configuration manifest.

• Add the custom receiver for Opsgenie to the "receivers" section of the configuration with "api_key" from the Integration Key from the configure Opsgenie step.

receivers:
- name: default-receiver
- name: rafay-webhook
  webhook_configs:
  - http_config:
      tls_config:
        ca_file: /etc/config/certs/ca.crt
        cert_file: /etc/config/certs/client.crt
        insecure_skip_verify: true
        key_file: /etc/config/certs/client.key
        server_name: '{{{ .V2EventFrameworkFQDN }}}'
    url: https://{{{ .V2EventFrameworkFQDN }}}/event/v1/alert/raise
- name: myalerts
  Opsgenie_configs:
  - send_resolved: true
    api_key: 6ffcxxxxxxxxxxxe155

• Next add the custom receiver for Opsgenie Alerts to the routes configuration in "route" section

route:
  group_interval: 5m
  group_wait: 10s
  receiver: rafay-webhook
  repeat_interval: 3h
  routes:
  - continue: true
    match_re:
      severity: .*
    receiver: rafay-webhook
  - match_re:
      severity: .*
    receiver: myalerts

• Upload the modified configuration to the addon

• Save the custom Alert Manager addon version

Update Cluster Blueprint

Follow the below steps to deploy the customized Alert Manager configuration for Opsgenie notifications to your clusters.

• Go to Infrastructure > Blueprints

• Add this custom Alert Manager addon to the custom blueprint for the cluster

• Update the new blueprint version with the customized Alert Manager addon to the clusters

• The new system Alert Manager addon will be deployed to the clusters

In a few minutes, the blueprint will be published successfully and the customized Alert Manager addon is deployed to the clusters

Verify Configuration

Once there are alerts generated in the clusters, you should see the notifications in your Opsgenie service integration activity. An illustrative example is shown below