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).
    Projects provide the structure for organizing Nobl9 resources and managing access permissions.
    If a project is not specified, Nobl9 assigns the default project value automatically.
  2. Enter a Display Name (optional).
    Spaces are allowed.
  3. Enter a Name (mandatory).
    It can only contain lowercase, alphanumeric characters, and dashes (for example, my-alert-method-1). Nobl9 auto-populates this field based on the display name you enter, transforming it into the supported format. You can edit the result.
  4. Enter a Description (optional).
    Provide extra details, such as the purpose and responsible personnel.
    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.
Check out these related guides and references: