Skip to main content

Email alert method

Reading time: 0 minute(s) (0 words)

The email alert method sends customized alert messages to up to 30 different inboxes per alert to notify Nobl9 users whenever an incident is triggered.

Adding the email alert method

You can add the email alert method directly in the Nobl9 Web application.

Alternatively, utilize the SLOs-as-code approach by:

Nobl9 Web

  1. Navigate to Integrations > Alert methods.
  2. Click .
  3. Select Email.
  1. Select a Project (mandatory).
    Project is a way to organize your Nobl9 resources and manage access to them.
    When Project is skipped, Nobl9 uses the default project.
  2. Enter a Display Name (optional).
    Spaces are allowed.
  3. Enter a Name (mandatory).
    The name is mandatory and can only contain lowercase, alphanumeric characters, and dashes (for example, my-alert-method-1). Nobl9 duplicates the display name here, transforming it into the supported format, but you can edit the result.
  4. Enter a Description (optional).
    Provide extra details about it, its purpose, responsible persons, etc.
    Up to 1050 characters.
  1. Select Send as plain text (optional) to receive alerts without background graphics and text formatting.

  2. Specify email Recipients (mandatory).
    You can select a category per recipient (at least one recipient in any category, up to 10 recipients in every category):

    • To (default): add direct email recipients

    • Click CC to add carbon copy recipients

    • Click BCC to add blind carbon copy recipients

    • Separate email addresses with spaces, commas (,), or semicolons (;). For example:

      email1@example.com email2@example.com
      email1@example.com,email2@example.com
      email1@example.com;email2@example.com
      email1@example.com ; email2@example.com,email3@example.com email4@example.com
  3. Click Add alert method.

YAML configuration

General YAML sample for E-mail alert method
apiVersion: n9/v1alpha
kind: AlertMethod
metadata:
name: string # Mantadory
displayName: string # Optional
# Optional
# The key value: only alphanumeric characters, `-`, `_`, or `.` are allowed.
# The key value must start and end with an alphanumeric character.
# An optional DNS subdomain prefix followed by `/` is allowed.
annotations:
key: value
spec:
description: string # Optional
email:
to:
- string # sloctl validates if the string is a correct email address, max. number of recipients is 10
cc:
- string # sloctl validates if the string is a correct email address, max. number of recipients is 10
bcc:
- string # sloctl validates if the string is a correct email address, max. number of recipients is 10
sendAsPlainText: false

Sample email alerts

The following are examples of Nobl9 email alerts for:

  • High severity alert
  • Medium severity alert
  • Low severity alert
email alert templates
Image 1: Samples of Nobl9 email alerts for various alert states

Testing the email alert method in the Web

You can test alert methods for all notification services supported by the Nobl9 platform through the UI.

To verify the correctness of your alert method configuration:

  1. Navigate to Integrations > Alert methods.
  2. Click the required alert method.
    Its Details page opens.
  3. Click Test under the alert method name:

    • When the configuration is correct, Nobl9 displays Test completed successfully! under the button.
    • Otherwise, the Test failed message appears. It contains the details of incorrect settings.
For a more in-depth look, consult additional resources: