Customize notification integrations

Created:

March 15, 2024

Updated:

September 3, 2024



FireTail's notification integrations allow for customizable payloads, enabling you to modify tokens and text. These customizable tokens are dynamic variables that pull information from triggered alerts or incidents. You can add, remove, or adjust these tokens in the following integrations:

Tokens are dynamic variables that are automatically filled with data from an alert. For example, the token {alert_timestamp} will be replaced with the time the alert was triggered, displayed in UTC format, such as 21/04/2023T12:35:36.

The payload contains dynamic variables which you can adjust and customize to suit your requirements.

For a list of all tokens, go to Dynamic variables.

Example payload for a Slack integration

Below is an example of a Slack notification payload that uses dynamic variables:



{
    "blocks": [
        {
            "type": "header",
            "text": {
                "type": "plain_text",
                "text": "Firetail Alert",
                "emoji": true
            }
        },
        {
            "type": "section",
            "fields": [
                {
                    "type": "mrkdwn",
                    "text": "*Name:*\n{alert_name}"
                },
                {
                    "type": "mrkdwn",
                    "text": "*Trigger Time:*\n{alert_timestamp}"
                }
            ]
        },
        {
            "type": "section",
            "fields": [
                {
                    "type": "mrkdwn",
                    "text": "*Condition:*\n{alert_static_triggered_value} {alert_operand} {alert_static_threshold_value}"
                }
            ]
        },
        {
            "type": "section",
            "text": {
                "type": "mrkdwn",
                "text": "<{alert_link}|View Alert>"
            }
        }
    ]
}

When triggered, this payload will send an alert to Slack that includes the alert name, trigger time, and condition, along with a link to view more details.

You can add, remove and change tokens and text in the payload. For example:



{
    "blocks": [
        {
            "type": "header",
            "text": {
                "type": "plain_text",
                "text": "My Demo Alert",
                "emoji": true
            }
        },
        {
            "type": "section",
            "fields": [
                {
                    "type": "mrkdwn",
                    "text": "*Name:*\n{alert_name}"
                },
                {
                    "type": "mrkdwn",
                    "text": "*Trigger Time:*\n{alert_timestamp}"
                },
                {
                   "type": "mrkdwn",
                   "text": "*Alert Type:*\n{alert_type}"
               }

            ]
        },
        {
            "type": "section",
            "fields": [
                {
                    "type": "mrkdwn",
                    "text": "*Condition:*\n{alert_static_triggered_value} {alert_operand} {alert_static_threshold_value}"
                },
               {
                   "type": "mrkdwn",
                   "text": "*Alert UUID:*\n{alert_uuid}"
               }

            ]
        },
        {
            "type": "section",
            "text": {
                "type": "mrkdwn",
                "text": "<{alert_link}|View Alert>"
            }
        }
    ]
}

Customizing Your Payload

You can modify the payload by adding or removing tokens as needed. Below is an example of a customized payload with additional tokens:

This customized example includes additional tokens like alert_type and alert_uuid, giving you more detailed information when the alert is triggered.

For a list of all tokens, go to Dynamic variables.