Alert Notification doc

[ranbena]

Documentation for v9 feature getredash/redash#4170.

[arikfr]

Worth adding a note on how different destinations might use the values slightly differently and that the preview is just for showing how the template variables will render.

And maybe this should be a section in the alert setup page?

[ranbena]

Worth adding a note on how different destinations might use the values slightly differently and that the preview is just for showing how the template variables will render.

Done:

And maybe this should be a section in the alert setup page?

1. I think it's quite the huge page already.
2. The alert setup page requires an update as well but I'd rather keep it as is till v9.

Wdyt?

[susodapop]

1. I think it's quite the huge page already.

True.

Any static content is valid, and you can also incorporate some built-in template variables:

ALERT_STATUS - The evaluated alert status (string)
ALERT_CONDITION - The alert condition operator (string).
ALERT_THRESHOLD - The alert threshold (string or number).
ALERT_NAME - The alert name (string).
ALERT_URL - The alert page url (string).
QUERY_NAME - The correlated query name (string).
QUERY_URL - The correlated query page url (string).
QUERY_RESULT_VALUE - The query result value (string or number)
QUERY_RESULT_ROWS - The query result rows (value array)
QUERY_RESULT_COLS - The query result columns (string array),

But these variable names make the most sense in context of the "Setting Up An Alert" page. Specifically the ALERT_STATUS and ALERT_CONDITION variables. If nothing else, could we enumerate the possible values for both variables?

[ranbena]

How about adding an exact link to the relevant sections in the setup-alert page from the variable descriptions?

[ranbena]

Added inline links to config setting explanations.

[ranbena]

Gonna land this. Any change requests will be handled in new PR.

[arikfr]

I restored the branch so we can push this again.