Edge Delta Email Output

Trigger data to email.

2 minute read

Version 2 is no longer supported. This section is for historical reference only.

Overview

This output type sends notifications and alerts to a specified email address.

Example

    - name: email
      type: webhook
      endpoint: "https://api.edgedelta.com/v1/orgs/-/triggers/emails"
      suppression_window: 30m
      suppression_mode: local
      custom_headers:
        X-ED-Config-Id: "{{.ConfigID}}"
      payload:
        RequestID: "{{.ConfigID}}-{{.Epoch}}"
        ConfigID: "{{.ConfigID}}"
        Recipients: ["your@mailaccount.com", "another@emailaccount.com"]
        Subject: "Anomaly Detected - EDAC [{{.EDAC}}]"
        Body: |
          <html><body>
            <h1>Edgedelta found anomaly!</h1>
            <div>EDAC: {{.EDAC}}</div>
            <div>Tag: {{.Tag}}</div>
            <div>Host: {{.Host}}</div>
            <div>Source: {{.Source}}</div>
            <div>MetricName: {{.MetricName}}</div>
          </body></html>

Parameters

name

Required

Enter a descriptive name for the output or integration.

For outputs, this name will be used to map this destination to a workflow.

name: email

integration_name

Optional

This parameter refers to the organization-level integration created in the Integrations page.

If you need to add multiple instances of the same integration into the config, then you can add a custom name to each instance via the name parameter. In this situation, the name should be used to refer to the specific instance of the destination in the workflows.

integration_name: ed-alert-email

type: webhook

Required

Enter webhook.

type: webhook

suppression_window

Optional

Enter a golang duration string that represents the suppression window. Once the agent detects an issue and notifies the endpoint, the agent will suppress any new issues for this time period. The default setting is 20m.

suppression_window: 30m

suppression_mode

Optional

Enter a suppression mode, which can be local or global.

The default mode is local, which indicates that an individual agent suppresses an issue if the agent has already made a local notification for a similar issue in the last suppression window.

Global mode indicates that an individual agent checks with the Edge Delta backend to see if there were similar alerts from other sibling agents (agents that share the same tag in the configuration).

suppression_mode: local

custom_headers

Optional

This parameter is used to customize the notification content.

If you do not want to use default fields in a notification, then create custom headers and fields.

To learn more, see Review Notify Content Parameters.

custom_headers:
  X-ED-Config-Id: "{{.ConfigID}}"

payload

Optional

Use this parameter and sub-parameters to configure the email notification content in the email.

Specifically, this parameter uses key-value pairs, where values can be strings, numbers, or lists.

String values support templating. The payload is converted into JSON, and then sent in the body of the request.

payload:
  RequestID: "{{.ConfigID}}-{{.Epoch}}"
  ConfigID: "{{.ConfigID}}"
  Recipients: ["your@mailaccount.com", "another@mailaccount.com"]
  Subject: "Anomaly Detected - EDAC [{{.EDAC}}]"
  Body: |
    <html><body>
      <h1>Edgedelta found anomaly!</h1>
      <div>EDAC: {{.EDAC}}</div>
      <div>Tag: {{.Tag}}</div>
      <div>Host: {{.Host}}</div>
      <div>Source: {{.Source}}</div>
      <div>MetricName: {{.MetricName}}</div>
    </body></html>