Back to Argo Cd

Opsgenie

docs/operator-manual/notifications/services/opsgenie.md

3.4.05.8 KB
Original Source

Opsgenie

To be able to send notifications with argocd-notifications you have to create an API Integration inside your Opsgenie Team.

  1. Login to Opsgenie at https://app.opsgenie.com or https://app.eu.opsgenie.com (if you have an account in the European Union).
  2. Make sure you already have a team; if not, follow this guide: https://docs.opsgenie.com/docs/teams.
  3. Click "Teams" in the Menu on the left.
  4. Select the team that you want to notify.
  5. In the team's configuration menu, select "Integrations".
  6. Click "Add Integration" in the top right corner.
  7. Select "API" integration.
  8. Give your integration a name, copy the "API key", and save it somewhere for later.
  9. Click "Edit" in the integration settings.
  10. Make sure the checkbox for "Create and Update Access" is selected; disable the other checkboxes to remove unnecessary permissions.
  11. Click "Save" at the bottom.
  12. Click "Turn on integration" in the top right corner.
  13. Check your browser for the correct server apiURL. If it is "app.opsgenie.com", then use the US/international API URL api.opsgenie.com; otherwise, use api.eu.opsgenie.com (European API).
  14. You are finished with configuring Opsgenie. Now you need to configure argocd-notifications. Use the apiUrl, the team name, and the apiKey to configure the Opsgenie integration in the argocd-notifications-secret secret.
  15. You can find the example argocd-notifications-cm configuration below.
OptionRequiredTypeDescriptionExample
descriptionTruestringDescription field of the alert that is generally used to provide detailed information about the alert.Hello from Argo CD!
priorityFalsestringPriority level of the alert. Possible values are P1, P2, P3, P4, and P5. Default value is P3.P1
aliasFalsestringClient-defined identifier of the alert, that is also the key element of Alert De-Duplication.Life is too short for no alias
noteFalsestringAdditional note that will be added while creating the alert.Error from Argo CD!
actionsFalse[]stringCustom actions that will be available for the alert.["Resolve", "Escalate"]
tagsFalse[]stringTags of the alert.["critical", "deployment"]
visibleToFalse[]alert.ResponderTeams and users that the alert will become visible to without sending any notification. The type field is mandatory for each item, where possible values are team and user. In addition to the type field, either id or name should be provided for teams, and either id or username should be given for users. Please note that alerts will be visible to the teams specified within the responders field by default, so there is no need to re-specify them in the visibleTo field.[{Type: "team", Id: "team_id"}, {Type: "user", Id: "user_id"}]
detailsFalsemap[string]stringMap of key-value pairs to use as custom properties of the alert.{"environment": "production", "service": "web"}
entityFalsestringEntity field of the alert that is generally used to specify which domain the alert is related to.web-server
userFalsestringDisplay name of the request owner.admin_user
yaml
apiVersion: v1
kind: ConfigMap
metadata:
  name: argocd-notifications-cm
data:
  service.opsgenie: |
    apiUrl: <api-url>
    apiKeys:
      <your-team>: <integration-api-key>
  template.opsgenie: |
    message: |
      [Argo CD] Application {{.app.metadata.name}} has a problem.
    opsgenie:
      description: |
        Application: {{.app.metadata.name}}
        Health Status: {{.app.status.health.status}}
        Operation State Phase: {{.app.status.operationState.phase}}
        Sync Status: {{.app.status.sync.status}}
      priority: P1
      alias: {{.app.metadata.name}}
      note: Error from Argo CD!
      actions:
        - Restart
        - AnExampleAction
      tags:
        - OverwriteQuietHours
        - Critical
      visibleTo:
        - Id: "{{.app.metadata.responderId}}"
          Type: "team"
        - Name: "rocket_team"
          Type: "team"
        - Id: "{{.app.metadata.responderUserId}}"
          Type: "user"
        - Username: "[email protected]"
          Type: "user"
      details:
        environment: production
        service: web
      entity: Argo CD Application
      user: John Doe
  trigger.on-a-problem: |
    - description: Application has a problem.
      send:
      - opsgenie
      when: app.status.health.status == 'Degraded' or app.status.operationState.phase in ['Error', 'Failed'] or app.status.sync.status == 'Unknown'
  1. Add annotation in the application YAML file to enable notifications for a specific Argo CD app.
yaml
apiVersion: argoproj.io/v1alpha1
kind: Application
metadata:
  annotations:
    notifications.argoproj.io/subscribe.on-a-problem.opsgenie: <your-team>